botvisibility (Python SDK)

Python client for BotVisibility — Lighthouse for AI agents. Scan any URL across 58 checks and 5 levels (Discoverable, Usable, Optimized, Indexable, Agent-Native) to see how ready it is for AI agents like Claude and GPT.

Install

pip install botvisibility

Quick start

from botvisibility import Client

with Client() as bv:
    result = bv.scan("stripe.com")

    print(result.url, "->", f"Level {result.score.level}: {result.level_name} ({result.grade})")
    print(f"{result.score.passed} passed / {result.score.failed} failed")

    for check in result.failing():
        print(f"  [{check.id}] {check.name} → {check.recommendation}")

Compare sites

with Client() as bv:
    for r in bv.compare(["stripe.com", "twilio.com"]):
        print(r.url, r.level_name, r.grade)

Badge URL

Client().badge_url("stripe.com")
# -> "https://botvisibility.com/api/badge?url=stripe.com"

Authentication

Public access needs no credentials. To raise your daily allowance, pass an OAuth 2.0 scan:read bearer token or an API key:

Client(token="…")     # Authorization: Bearer …
Client(api_key="…")   # X-API-Key: …

See https://botvisibility.com/auth.md.

Errors

from botvisibility import Client, PaymentRequiredError, InvalidURLError, APIError

try:
    Client().scan("example.com")
except PaymentRequiredError as e:
    # Over the free allowance — settle via x402 and retry.
    print("Pay at", e.paid_endpoint)
except InvalidURLError:
    ...
except APIError as e:
    print(e.status, e.body)

CLI

botvisibility stripe.com          # human-readable summary
botvisibility stripe.com --json   # raw JSON report

Development

pip install -e ".[dev]"
pytest

License

MIT © Joey Janisheck. Not affiliated with any third party; see https://botvisibility.com.