# 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, and more. 30 automated web checks across 3 levels, plus 7 CLI-only checks for Level 4.

## 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.
- [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: 30 optimizations that slash AI token costs.
- [37-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.
- [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.
- [Badge API](https://botvisibility.com/api/badge?url=example.com) — SVG badge showing scan score.
- [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": 22,
    "failed": 0,
    "partial": 0,
    "na": 8,
    "total": 30,
    "level": 3,
    "levelName": "Optimized",
    "grade": "perfect"
  },
  "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-3), 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)
- [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