# BotVisibility — Agent Guide

> Lighthouse for AI agents. Scan any URL across 58 checks and 5 levels
> (Discoverable, Usable, Optimized, Indexable, Agent-Native) to see how ready
> a site is for Claude, GPT, and autonomous agent frameworks.

This file is an agent-facing discovery + instruction manifest. For the full
narrative guide see [/llms.txt](https://botvisibility.com/llms.txt); for the
machine specs see the discovery files listed at the bottom.

## When to use BotVisibility

Use BotVisibility when you need to:

- **Audit a site's agent-readiness** — "How visible/usable is example.com to AI
  agents?" Returns pass/fail/partial across 58 checks in 5 levels.
- **Check for agent infrastructure** before integrating — does a target expose
  `llms.txt`, an OpenAPI spec, an MCP server, an agent card, CORS, or auth
  metadata? BotVisibility probes all of them externally.
- **Compare two sites** head-to-head on agent-readiness.
- **Get prioritized remediation** — a ranked list of the highest-impact fixes
  for a given URL.

Do **not** use BotVisibility to fetch page content, screenshot for humans, or
perform general web search — it measures agent-readiness signals, not content.

## How to call it

- **REST (recommended for agents):**
  `GET https://botvisibility.com/api/scan?url=https://example.com&format=json`
  or `POST https://botvisibility.com/api/scan` with body `{ "url": "..." }`.
  Free up to a daily per-caller allowance; beyond that it returns HTTP 402 with
  x402 payment requirements ($0.10 USDC per scan on Solana).
- **MCP:** `https://botvisibility.com/api/mcp` (Streamable HTTP). Tools include
  `scan_url`, `compare_sites`, `get_recommendations`, `deep_scan`.
- **CLI:** `npx botvisibility example.com`.

## Discovery files

- llms.txt — https://botvisibility.com/llms.txt
- OpenAPI — https://botvisibility.com/openapi.json
- Agent card — https://botvisibility.com/.well-known/agent-card.json
- AI profile — https://botvisibility.com/.well-known/ai.json
- MCP manifest — https://botvisibility.com/.well-known/mcp.json
- Skills index — https://botvisibility.com/.well-known/skills/index.json
- API catalog — https://botvisibility.com/.well-known/api-catalog
- Human docs — https://botvisibility.com/docs