AEO Scanner

Developer Documentation

Integrate AEO Scanner into your workflow via the x402 API or MCP server. No API keys needed — pay per call in USDC.

The AEO Scanner API by Convrgent is a programmatic interface to the same AI visibility audit engine that powers the scan.convrgent.ai web tool, exposed through four REST endpoints that AI agents and developer tools can call directly. The scan endpoint returns triple scores in under 60 seconds for 25 cents, the audit endpoint returns the full 64-plus check breakdown for 1 dollar, the fix endpoint adds generated fix code for 5 dollars, and the compare endpoint delivers competitive gap analysis between two sites for 3 dollars. Every endpoint uses the x402 payment protocol, meaning the client makes a request, receives HTTP 402 Payment Required with pricing metadata, pays in USDC on Base or Solana, and retries with a payment header — no API keys, no registration, no subscriptions.

The AEO Scanner MCP server is a separate integration that exposes the same four tools through the Model Context Protocol specification published by Anthropic in 2024, allowing Claude Code, Cursor, Windsurf, and any other MCP-compatible client to invoke scan_site, audit_site, fix_site, and compare_sites as first-class tools inside agentic coding workflows. According to the Convrgent documentation, the MCP server has been listed on the x402scan, XGate, and Bazaar marketplaces since late 2025, making AEO Scanner the first AI search visibility tool available through all three major agent distribution channels. Developers who want to try the API without writing code can use the Claude Code skill distributed as a downloadable SKILL.md file that ships with ready-to-run examples for every endpoint.

API Endpoints

All endpoints accept POST requests with a JSON body containing a url field. The quick scan is free (rate limited). Paid endpoints are authenticated via x402 protocol — your agent pays per call in USDC on Base or Solana, no API keys needed.

POST scan.convrgent.ai/api/aeo/scanFree

Quick scan — returns triple scores (AEO + GEO + Agent Readiness), AI Identity Card, and top 5 issues. Rate limited: 20/hour per IP, 5 per URL per day.

{ aeoScore, geoScore, agentScore, aiIdentityCard, topIssues, pagesScanned }
POST scan.convrgent.ai/api/aeo/audit$1.00

Full audit — all 64+ checks with per-category breakdown, all issues, and detailed recommendations

{ ...scan, categories[], fixes[], pagesScanned }
POST scan.convrgent.ai/api/aeo/compare$3.00

Competitive gap analysis — scans two sites, identifies exactly what the competitor has that you don't, and generates overtake fix code for each gap

{ you, competitor, categoryWinners[], gaps[], overtakeFixes[], projectedAfterFixes }
POST scan.convrgent.ai/api/aeo/fix$5.00

Full audit + generated fix code for every issue. Returns copy-paste JSON-LD, meta tags, robots.txt, and llms.txt populated with the site's real data

{ ...audit, generatedFixes[], skillMd, pdfUrl }

Code Example

# Quick scan via curl (x402 handles payment automatically)
curl -X POST https://scan.convrgent.ai/api/aeo/scan \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'

# Response
{
  "overallScore": 72,
  "overallGrade": "C",
  "geoReadiness": { "score": 58, "grade": "D" },
  "agentReadiness": { "score": 45, "grade": "D" },
  "aiIdentityCard": {
    "brandName": "Example Corp",
    "summary": "...",
    "confidence": "medium"
  },
  "topIssues": [...]
}

MCP Server

AEO Scanner is available as an MCP (Model Context Protocol) server for AI agents and coding assistants. Add it to Claude Code, Cursor, or any MCP-compatible client.

MCP Configuration
{
  "mcpServers": {
    "aeo-scanner": {
      "type": "http",
      "url": "https://aeo-mcp.convrgent.ai/mcp"
    }
  }
}

Available MCP Tools

  • scan_site
    Quick dual-score scan — AEO + Agent Readiness with top issues
    Free
  • audit_site
    Full 64+ check breakdown across 12 categories
    $1.00
  • fix_site
    Generated fix code you can apply directly to the codebase
    $5.00

Agent Workflow

The recommended workflow for AI agents integrating AEO Scanner:

  1. 1Call scan_site with the target URL to get baseline AEO and Agent Readiness scores
  2. 2Report the three scores (AEO, GEO, Agent) with letter grades to the user
  3. 3If the user wants details, call audit_site for the full category breakdown
  4. 4If the user wants fixes, call fix_site to get copy-paste implementation code
  5. 5Apply the generated fix code to the project files if you have write access
  6. 6After applying fixes, call scan_site again to verify score improvement
  7. 7Report the before/after comparison to the user (e.g., "AEO: 61 → 96")

Payment

All paid endpoints use the x402 protocol for automatic micropayments. No API keys, no signup, no billing dashboard.

  • + Payment currency: USDC (stablecoin)
  • + Supported networks: Base (Coinbase L2) and Solana
  • + Protocol: x402 — payment is negotiated automatically in the HTTP request/response cycle
  • + No API keys required — the x402 header handles authentication and payment
  • + Receipts: transaction hash returned in the response headers

OpenAPI Specification

The full OpenAPI spec is available for programmatic discovery:

GET https://scan.convrgent.ai/openapi.json

Webhooks & Events

For agents that need real-time notifications when scans complete, AEO Scanner supports callback URLs via the callback_url parameter in the request body. The scan result will be POST-ed to your callback URL when processing is complete.

POST /api/aeo/scan
{ "url": "https://example.com", "callback_url": "https://your-agent.com/webhook" }

Support

Questions about integration? Contact us at support@convrgent.ai

Try a Free Scan