Skip to main content

Extract historical robots.txt paths via Wayback Machine – a recon tool for bug hunters

Project description

RoboFinder

Uncover hidden endpoints by mining every historical robots.txt snapshot from the Wayback Machine.

PyPI Downloads Python 3.8+ License Stars


Why RoboFinder?

Sites regularly scrub sensitive paths from robots.txt — but the Wayback Machine keeps every version ever crawled.

RoboFinder queries Archive.org's CDX API to pull all historical robots.txt snapshots for a target, deduplicates every Allow, Disallow, and Sitemap directive, and prints the full list. Paths that were quietly removed from production may still be alive and reachable.

Built for: bug bounty recon · OSINT · attack-surface mapping · forgotten endpoint discovery


Install

pip install robofinder
Install from source
git clone https://github.com/Spix0r/robofinder
cd robofinder
pip install .

Quick start

# Scan a single target
robofinder -u https://example.com

# Full URLs ready to probe
robofinder -u https://example.com -c

# Extract forgotten URL parameters
robofinder -u https://example.com -p

# Save results to a file
robofinder -u https://example.com -o results.txt

# Pipe into other tools
robofinder -u https://example.com -c | httpx -silent -mc 200
robofinder -u https://example.com -c | nuclei -t exposures/

Usage

robofinder -u <URL> [options]
Flag Long form Default Description
-u --url Target URL (required)
-o --output Save results to a file
-t --threads 10 Number of fetch threads
-c Prefix each path with the target URL
-p Extract URL parameters from historical paths
-s --silent Suppress the banner
--debug Verbose debug output

Concatenate paths with the target URL (-c)

Useful for piping directly into scanners:

robofinder -u https://example.com -c
# https://example.com/admin
# https://example.com/api/v1
# https://example.com/internal

Extract forgotten URL parameters (-p)

Finds parameter names that appeared in historical paths:

robofinder -u https://example.com -p
# id
# token
# redirect_url

Changelog

See CHANGELOG.md.


License

MIT © Spix0r

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

robofinder-0.1.0.tar.gz (5.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

robofinder-0.1.0-py3-none-any.whl (7.3 kB view details)

Uploaded Python 3

File details

Details for the file robofinder-0.1.0.tar.gz.

File metadata

  • Download URL: robofinder-0.1.0.tar.gz
  • Upload date:
  • Size: 5.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.9.6

File hashes

Hashes for robofinder-0.1.0.tar.gz
Algorithm Hash digest
SHA256 840af256afbe8005f534654534a7534e9613c44e39a37a48cdd3afe8b6e9d30c
MD5 d133b57d8f296ff349af0a89b7aee6f3
BLAKE2b-256 82ff4a9a950080b9f32db67c003339bcb13301ff334529501b596798c363feae

See more details on using hashes here.

File details

Details for the file robofinder-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: robofinder-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 7.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.9.6

File hashes

Hashes for robofinder-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 dfc4aa500e8edba24165b5af4b07da3971a8b0f6d737174f5dd6b7c0d6171515
MD5 cbc17b68b12b05f7ada1521f7bdb8c10
BLAKE2b-256 e1ccfb253de43601a3d0278440bd4a8dc1e6300facb06b73dc5f0f2196b75af9

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page