# BotVisibility

> AI agent readiness scanner — check how visible and usable your website or API is to AI agents.

BotVisibility scans any URL and evaluates its readiness for AI agent consumption. It checks for llms.txt, agent cards, OpenAPI specs, CORS headers, rate limit headers, structured data, Content-Signals, API catalogs (RFC 9727), markdown content negotiation, WebMCP, OAuth Protected Resource metadata (RFC 9728), x402 payments, AI search indexability, and more. 48 automated web checks across 4 levels, plus 7 CLI-only checks for Level 5.

## Pages

- [Scanner](https://botvisibility.com) — Free AI visibility audit. Enter a URL to scan.
- [White Papers](https://botvisibility.com/white-papers) — Research library: all BotVisibility publications.
- [Code](https://botvisibility.com/code) — Deployable tools, agents, and integrations for AI agent readiness.
- [The Discovery Gap](https://botvisibility.com/discovery-gap) — White paper: Your site is agent-ready. The agents aren't. Six fixes.
- [The Agent Tax](https://botvisibility.com/agent-tax) — Research: 36 optimizations that slash AI token costs.
- [The $250K Token Illusion](https://botvisibility.com/token-illusion) — White paper: why Jensen Huang wants you to burn through AI spend — and why smart companies won't.
- [The Death and Resurrection of MCP](https://botvisibility.com/mcp-resurrection) — White paper: how a failing protocol got a second life from an unlikely source.
- [55-Item Checklist](https://botvisibility.com/checklist) — Complete checklist for AI agent readiness.
- [CLI Tool](https://botvisibility.com/cli) — Scan your codebase locally with npx botvisibility.
- [Claude Managed Agent](https://botvisibility.com/claude-managed-agent) — Deployable Claude Managed Agent that audits sites and repos against the 55-item checklist.
- [WordPress Plugin](https://botvisibility.com/wordpress-plugin) — Scan, fix, and harden WordPress sites for AI agents with one-click fixes.
- [Badge](https://botvisibility.com/badge) — Embed an agent-readiness trust badge on your site.
- [Contact](https://botvisibility.com/contact) — Consulting services for AI agent readiness.

## API

Agents: use the JSON GET endpoint for the simplest integration.

- [Scan API (GET, JSON)](https://botvisibility.com/api/scan?url=example.com&format=json) — Returns full scan results as JSON. Also triggered by Accept: application/json header.
- [Scan API (GET, streaming)](https://botvisibility.com/api/scan?url=https://example.com) — Server-Sent Events stream of check results (for UIs).
- [Scan API (POST, JSON)](https://botvisibility.com/api/scan) — POST {"url": "https://example.com"} for JSON results.
- [Deep Scan API (POST, x402 paid)](https://botvisibility.com/api/v1/deep-scan) — Pay $0.50 USDC on Base via x402 (HTTP 402 + X-PAYMENT header) for the full 55-check report with prioritized remediation. Returns JSON; also downloadable as a PDF or Markdown report from the site's Download tab. Returns HTTP 402 with payment requirements when no payment is supplied.
- [Badge API](https://botvisibility.com/api/badge?url=example.com) — SVG badge showing scan score.
- [MCP Server](https://botvisibility.com/api/mcp) — Live Model Context Protocol server (Streamable HTTP). Tools: scan_url, get_check_definitions, get_check, get_showcase, compare_sites.
- [Screenshot API](https://botvisibility.com/api/screenshot?url=example.com) — Cached screenshot of a scanned site.
- [API Catalog](https://botvisibility.com/.well-known/api-catalog) — RFC 9727 linkset for API discovery.
- [OpenAPI Spec](https://botvisibility.com/openapi.json)

### Quick start for agents

```
GET https://botvisibility.com/api/scan?url=yoursite.com&format=json
```

Returns JSON with a top-level `score` summary:

```json
{
  "score": {
    "passed": 40,
    "failed": 4,
    "partial": 2,
    "na": 2,
    "total": 48,
    "level": 4,
    "levelName": "Indexable",
    "grade": "good"
  },
  "url": "...",
  "checks": [...]
}
```

Grade: "perfect" (all applicable pass), "good" (≥75%), "fair" (≥50%), "needs-work" (<50%).
Each check has: id, name, status (pass|fail|partial|na), level (1-4 web, 5 CLI-only), message, recommendation, details.

## Discovery

- [Agent Card](https://botvisibility.com/.well-known/agent-card.json)
- [AI Config](https://botvisibility.com/.well-known/ai.json)
- [MCP Server](https://botvisibility.com/.well-known/mcp.json) (manifest) — live Streamable HTTP endpoint at https://botvisibility.com/api/mcp
- [Skills Index](https://botvisibility.com/.well-known/skills/index.json)
- [Skill File](https://botvisibility.com/skill.md)

## Social

- [Bluesky](https://bsky.app/profile/botvisibility.bsky.social)
- [npm](https://www.npmjs.com/package/botvisibility)

## Contact

Joey Janisheck — https://janisheck.com