Submit a bot

Every entry is a reviewed pull request. Automated checks validate your data — a maintainer reviews legitimacy before anything is published.

1 — The PR route (preferred)

Add one YAML file describing your bot and open a pull request. CI validates the schema, live-fetches any IP feed you claim, checks your UA patterns against real instances, and posts a report.

Start from an existing bot file

git clone https://github.com/mayankguptadotcom/verifiedbots && cp bots/googlebot.yaml bots/<your-bot-id>.yaml

Read CONTRIBUTING.md for the field-by-field guide.

2 — The form route

Not comfortable with YAML? Open a "Submit a bot" issue — maintainers convert accepted submissions into PRs.

Before you submit

Check your bot against the Good Bot Practices. Bots without any verification path are listed as Tier 3 — visible, but flagged as unverifiable.