MCPcopy
hub / github.com/tomnomnom/assetfinder

github.com/tomnomnom/assetfinder @v0.1.1 sqlite

repository ↗ · DeepWiki ↗ · release v0.1.1 ↗
25 symbols 53 edges 12 files 4 documented · 16%
README

assetfinder

Find domains and subdomains potentially related to a given domain.

Install

If you have Go installed and configured (i.e. with $GOPATH/bin in your $PATH):

go get -u github.com/tomnomnom/assetfinder

Otherwise download a release for your platform. To make it easier to execute you can put the binary in your $PATH.

Usage

assetfinder [--subs-only] <domain>

Sources

Please feel free to issue pull requests with new sources! :)

Implemented

  • crt.sh
  • certspotter
  • hackertarget
  • threatcrowd
  • wayback machine
  • dns.bufferover.run
  • facebook
    • Needs FB_APP_ID and FB_APP_SECRET environment variables set (https://developers.facebook.com/)
    • You need to be careful with your app's rate limits
  • virustotal
    • Needs VT_API_KEY environment variable set (https://developers.virustotal.com/reference)
  • findsubdomains
    • Needs SPYSE_API_TOKEN environment variable set (the free version always gives the first response page, and you also get "25 unlimited requests") — (https://spyse.com/apidocs)

Sources to be implemented

  • http://api.passivetotal.org/api/docs/
  • https://community.riskiq.com/ (?)
  • https://riddler.io/
  • http://www.dnsdb.org/
  • https://certdb.com/api-documentation

TODO

  • Flags to control which sources are used
    • Likely to be all on by default and a flag to disable
  • Read domains from stdin

Extension points exported contracts — how you extend this code

Core symbols most depended-on inside this repo

fetchJSON
called by 8
main.go
getFacebookCerts
called by 1
facebook.go
facebookAuth
called by 1
facebook.go
newRateLimiter
called by 1
ratelimit.go
Block
called by 1
ratelimit.go
callSubdomainsAggregateEndpoint
called by 1
findsubdomains.go
callSubdomainsEndpoint
called by 1
findsubdomains.go
httpGet
called by 1
main.go

Shape

Function 19
Struct 4
FuncType 1
Method 1

Languages

Go100%

Modules by API surface

main.go5 symbols
findsubdomains.go5 symbols
ratelimit.go3 symbols
facebook.go3 symbols
crtsh.go2 symbols
wayback.go1 symbols
virustotal.go1 symbols
urlscan.go1 symbols
threatcrowd.go1 symbols
hackertarget.go1 symbols
certspotter.go1 symbols
bufferoverrun.go1 symbols

For agents

$ claude mcp add assetfinder \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact