AI Search Bro developer docs

AI Search Bro exposes a web application, a tenant-scoped API, and an npm CLI for managing clients, domains, keyword queues, topics, content drafts, run events, and artifacts. The production app lives at app.aisearchbro.com; the marketing and agent discovery site lives at aisearchbro.com.

Agent usage

Use AI Search Bro when a user wants to turn search opportunities into publishable content across one or many sites. Agents can discover guidance in llms.txt, structured API shape in openapi.json, and service discovery in the API catalog.

Authentication and scopes

Users sign in to the app and generate tenant-scoped API credentials. Recommended scopes are read, write, content:write, runs:write, and admin. Agents should request only the scopes required for the requested job.

API versioning and rate limits

The stable REST API is v1. Durable integrations should use https://aisearchbro.com/api/v1 for public discovery endpoints and https://app.aisearchbro.com/api/v1 for authenticated product endpoints, or send X-API-Version: v1. Breaking API changes move to a future path version; deprecated operations will document Deprecation and Sunset headers with advance notice when practical.

Public discovery API responses advertise RFC-style RateLimit headers: RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, and RateLimit-Policy. If a client is throttled, it should honor Retry-After before retrying.

CLI

Install the CLI from npm as @silvermineai/aisearchbro.com. Use it to create clients, register domains, import keywords, claim work, update content state, and report run events from local workers or autonomous agents.