API, MCP and curl
Everything the website does is an endpoint. Reading is open, submitting is open, and there is no API key anywhere on the site. If you are an agent, start with agents.md.
Submit a listing
POST https://botpages.net/api/submit
Content-Type: application/json
{"url": "https://yoursite.com", "email": "you@example.com", "category": "developer-tools"}
Returns 201 with the listing id, its page URL, a manage URL and the badge HTML. category is optional and guessed from the page when omitted. A repeat submission for the same root domain returns 409 with the existing listing.
Verify a badge
POST https://botpages.net/api/verify-badge
{"url": "https://yoursite.com"}
→ {"ok": true, "has_badge": true, "dofollow": true, "listing_id": 42}
Read
| Endpoint | Returns |
|---|---|
GET /api/listings | All active listings. ?category= filters, ?limit= caps at 100. |
GET /api/listing/{id} | One listing. |
GET /api/categories | Category slugs, names and counts. |
GET /api/stats | Totals: listed, verified, added today and this week. |
GET /api/search?q= | Title, description and host search. |
MCP
The endpoint speaks MCP over Streamable HTTP at https://botpages.net/mcp. JSON-RPC in, JSON out. The tool catalog is also published as a static document at agents.json, and the discovery file is at /.well-known/mcp.json.
POST https://botpages.net/mcp
{"jsonrpc":"2.0","id":1,"method":"tools/list"}
| Tool | Does |
|---|---|
submit_listing | Same as POST /api/submit. Arguments: url, email, category. |
verify_badge | Re-fetches a listed URL and updates its dofollow state. |
list_listings | Paged listing feed, optional category. |
get_listing | One listing by id. |
list_categories | Slugs and counts. |
get_stats | Directory totals. |
Edit and remove
There is no account system, so ownership is a token. The submission response carries a manage URL containing it. That URL can change the listed URL, re-read the metadata, or delete the listing. A URL change resets the badge until it is re-verified on the new domain.
Rules that apply to everyone
- One active listing per root domain.
wwwandhttpcollapse into the same entry. - The page must answer 200 to
BotPagesBot/1.0and carry a title. - Parking pages, login walls and error pages are refused at submit time.
- Submissions are rate limited per IP. Abusing the endpoint gets the IP blocked, not the listing removed.
- No CAPTCHA, no key, no approval queue — and no paid tier that skips any of this, because there is no paid tier.
Machine-readable files
| /llms.txt | What the site is, in the format LLMs expect. |
| /agents.md | The action list for agents. |
| /agents.json | The same actions as a tool catalog. |
| /openapi.json | OpenAPI 3.1 spec for the REST surface. |
| /sitemap.xml | Every page, including all 13 listings. |
| /feed.xml | Atom feed of the newest listings. |