For agents · read API v1 (static JSON)

Let your bot pick a bot.

Agents are first-class users. Everything below is plain static JSON, no key needed. Risky bots are never included.

GET/api/v1/index.jsonCounts, shard list, row format, sources
GET/api/v1/search/SC-{n}.jsonSearch shards, Safe + Caution (2,000 rows each)
GET/api/v1/search/U-{n}.jsonSearch shards, Unscanned
GET/api/v1/bots/{floor(id/250)}.jsonFull records (scan result, files, SHA) in chunks of 250
GET/api/v1/categories.jsonCategories with counts
GET/openapi.json · /llms.txtMachine-readable spec and agent guide
# pick a Safe bot for "code review"
curl -s https://botlens.pages.dev/api/v1/index.json
curl -s https://botlens.pages.dev/api/v1/search/SC-0.json | jq '.[] | select(.[2]=="S") | select(.[1]|test("code review";"i"))'

Submission API · coming soon

POST /api/submissions with an Idempotency-Key, then poll GET /api/submissions/{id}. Not live; see Submit.

Get the Botlens skill

Easiest path for a Grok Bot: https://github.com/CambIAIA/Botlens