aeo-scanner 2.2.0__tar.gz → 2.2.2__tar.gz

{aeo_scanner-2.2.0 → aeo_scanner-2.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aeo-scanner
-Version: 2.2.0
+Version: 2.2.2
 Summary: MCP server for AI search visibility auditing. Triple scoring: AEO (search findability), GEO (citation readiness), Agent Readiness (agent interaction). Plus AI Identity Card and business profile detection.
 Author-email: Convrgent <hello@convrgent.ai>
 License: MIT
@@ -56,7 +56,7 @@ claude mcp add aeo-scanner -- uvx aeo-scanner
 | Tool | What it does | Price |
 |------|-------------|-------|
 | `scan_site` | Quick triple-score scan + AI Identity Card + mention readiness + business profile + top issues | **Free** |
-| `audit_site` | Full 58+ check breakdown across 12 categories (4 AEO + 4 GEO + 4 Agent) | $1.00 |
+| `audit_site` | Full 67+ check breakdown across 12 categories (4 AEO + 4 GEO + 4 Agent) | $1.00 |
 | `compare_sites` | Two-site gap analysis + category winners + overtake fix code | $3.00 |
 | `fix_site` | Generated fix code with two-tier score projections — apply directly with Claude Code | $5.00 |
 
@@ -68,12 +68,9 @@ Rate limits: 20 scans/hour per IP, 5 per URL per day.
 
 ## Paid tools
 
-`audit_site`, `compare_sites`, and `fix_site` require an API key:
+`audit_site`, `compare_sites`, and `fix_site` are pay-per-call via the [x402 protocol](https://www.x402.org/) — USDC on Base or Solana. No API key, no account.
 
-1. Get your key at [scan.convrgent.ai](https://scan.convrgent.ai)
-2. Set `AEO_API_KEY` in your MCP config
-
-Or pay per call with USDC via [x402 protocol](https://www.x402.org/) (Base network).
+Without payment, the tool returns a structured `payment_required` error containing the full x402 payload (payTo address, amount, asset). x402-capable clients retry automatically with a signed `X-PAYMENT` header; other agents can relay the payment details to their operator.
 
 ## Workflow
 
@@ -87,7 +84,7 @@ The included `optimize_site` prompt guides the full workflow:
 
 ## Scoring
 
-58+ checks across 12 categories. See the built-in `aeo://reference/scoring-methodology` resource for full details.
+67+ checks across 12 categories. See the built-in `aeo://reference/scoring-methodology` resource for full details.
 
 **AEO categories:** Structured Data (30%), Meta & Technical (20%), AI Accessibility (25%), Content Quality (25%)
 

{aeo_scanner-2.2.0 → aeo_scanner-2.2.2}/README.md

@@ -39,7 +39,7 @@ claude mcp add aeo-scanner -- uvx aeo-scanner
 | Tool | What it does | Price |
 |------|-------------|-------|
 | `scan_site` | Quick triple-score scan + AI Identity Card + mention readiness + business profile + top issues | **Free** |
-| `audit_site` | Full 58+ check breakdown across 12 categories (4 AEO + 4 GEO + 4 Agent) | $1.00 |
+| `audit_site` | Full 67+ check breakdown across 12 categories (4 AEO + 4 GEO + 4 Agent) | $1.00 |
 | `compare_sites` | Two-site gap analysis + category winners + overtake fix code | $3.00 |
 | `fix_site` | Generated fix code with two-tier score projections — apply directly with Claude Code | $5.00 |
 
@@ -51,12 +51,9 @@ Rate limits: 20 scans/hour per IP, 5 per URL per day.
 
 ## Paid tools
 
-`audit_site`, `compare_sites`, and `fix_site` require an API key:
+`audit_site`, `compare_sites`, and `fix_site` are pay-per-call via the [x402 protocol](https://www.x402.org/) — USDC on Base or Solana. No API key, no account.
 
-1. Get your key at [scan.convrgent.ai](https://scan.convrgent.ai)
-2. Set `AEO_API_KEY` in your MCP config
-
-Or pay per call with USDC via [x402 protocol](https://www.x402.org/) (Base network).
+Without payment, the tool returns a structured `payment_required` error containing the full x402 payload (payTo address, amount, asset). x402-capable clients retry automatically with a signed `X-PAYMENT` header; other agents can relay the payment details to their operator.
 
 ## Workflow
 
@@ -70,7 +67,7 @@ The included `optimize_site` prompt guides the full workflow:
 
 ## Scoring
 
-58+ checks across 12 categories. See the built-in `aeo://reference/scoring-methodology` resource for full details.
+67+ checks across 12 categories. See the built-in `aeo://reference/scoring-methodology` resource for full details.
 
 **AEO categories:** Structured Data (30%), Meta & Technical (20%), AI Accessibility (25%), Content Quality (25%)
 

{aeo_scanner-2.2.0 → aeo_scanner-2.2.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "aeo-scanner"
-version = "2.2.0"
+version = "2.2.2"
 description = "MCP server for AI search visibility auditing. Triple scoring: AEO (search findability), GEO (citation readiness), Agent Readiness (agent interaction). Plus AI Identity Card and business profile detection."
 readme = "README.md"
 license = {text = "MIT"}

aeo_scanner-2.2.2/server.json

@@ -0,0 +1,27 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.Convrgent/aeo-scanner",
+  "title": "AEO Scanner",
+  "description": "AI visibility for ChatGPT/Perplexity/Claude — triple score (AEO+GEO+Agent) with fix code. Free.",
+  "repository": {
+    "url": "https://github.com/Convrgent/aeo-saas",
+    "source": "github"
+  },
+  "version": "2.2.2",
+  "remotes": [
+    {
+      "type": "streamable-http",
+      "url": "https://aeo-mcp.convrgent.ai/mcp"
+    }
+  ],
+  "packages": [
+    {
+      "registryType": "pypi",
+      "identifier": "aeo-scanner",
+      "version": "2.2.2",
+      "transport": {
+        "type": "stdio"
+      }
+    }
+  ]
+}

{aeo_scanner-2.2.0 → aeo_scanner-2.2.2}/src/server.py

@@ -9,42 +9,59 @@ mcp = FastMCP(
 )
 
 API_BASE = os.environ.get("AEO_API_URL", "https://scan.convrgent.ai")
-AEO_API_KEY = os.environ.get("AEO_API_KEY")
 
-
-def _get_paid_headers() -> dict:
-    """Build headers for paid API calls."""
-    headers = {"Content-Type": "application/json"}
-    if AEO_API_KEY:
-        headers["Authorization"] = f"Bearer {AEO_API_KEY}"
-    return headers
-
-
-def _payment_required_response() -> str:
-    """Structured 402 response that agents can relay to their operators."""
+# Single source of truth for tool name + price per endpoint — mirrors
+# TOOL_PRICING in mcp/workers/src/api-client.ts. Keep the two in sync.
+TOOL_PRICING = {
+    "/api/aeo/audit": ("audit_site", "$1.00"),
+    "/api/aeo/compare": ("compare_sites", "$3.00"),
+    "/api/aeo/fix": ("fix_site", "$5.00"),
+}
+
+
+def _payment_required_response(resp: httpx.Response, tool: str, price: str) -> str:
+    """Pass the backend's x402 v2 payload through verbatim so x402-capable
+    agents can auto-pay, and agents without a wallet can relay payTo/amount
+    to their operator. Never swallow the payload behind a static message —
+    that was the exact bug fixed in the worker (PR #3, 2026-04-17). The old
+    AEO_API_KEY / Bearer flow was dead config: the backend only ever checked
+    x402 payment headers."""
+    try:
+        x402_payload = resp.json()
+    except Exception:
+        x402_payload = {"raw": resp.text[:500]}
     return json.dumps(
         {
             "error": "payment_required",
-            "message": "This tool requires a paid API key.",
-            "how_to_pay": {
-                "stripe": "Get your API key at https://scan.convrgent.ai",
-                "crypto": "Pay per call via x402 (USDC on Base). See https://scan.convrgent.ai",
-            },
-            "setup": "Set AEO_API_KEY in your MCP server config env vars.",
-            "pricing": {"audit_site": "$1.00", "compare_sites": "$3.00", "fix_site": "$5.00"},
-            "tip": "scan_site is free — try it first to see your scores.",
+            "status": 402,
+            "tool": tool,
+            "price": price,
+            "message": (
+                f"{tool} is pay-per-call ({price}) via the x402 protocol — USDC on "
+                "Base or Solana. Retry with a signed X-PAYMENT header from an "
+                "x402-capable client, or relay the payment details below to your "
+                "operator. The x402 payload has the payTo address, amount, and asset."
+            ),
+            "x402": x402_payload,
+            "docs": "https://www.x402.org/",
+            "free_alternative": "scan_site is free — try it to see the three scores before paying for the full audit.",
         },
         indent=2,
     )
 
 
 async def _handle_paid_request(endpoint: str, payload: dict) -> str:
-    """Call a paid endpoint with proper 402 handling."""
-    headers = _get_paid_headers()
+    """Call a paid endpoint with proper 402 handling.
+
+    X-MCP-Tool tags the request as MCP-originated so the backend can measure
+    discovery->tool-call conversion (mirrors mcp/workers/src/api-client.ts).
+    """
+    tool, price = TOOL_PRICING[endpoint]
+    headers = {"Content-Type": "application/json", "X-MCP-Tool": tool}
     async with httpx.AsyncClient(timeout=180) as client:
         resp = await client.post(f"{API_BASE}{endpoint}", json=payload, headers=headers)
         if resp.status_code == 402:
-            return _payment_required_response()
+            return _payment_required_response(resp, tool, price)
         if resp.status_code >= 400:
             try:
                 error_data = resp.json()
@@ -68,13 +85,13 @@ async def scan_site(url: str, pages: int = 5) -> str:
     and Agent Readiness Score (0-100, AI agent interaction). Also returns
     AI Identity Card with mention readiness (0-100, predicts how likely AI
     will mention the brand), detected competitors, business profile
-    (commerce/saas/media/general), and top issues. 58+ checks across
-    12 categories. Free — no API key needed."""
+    (commerce/saas/media/general), and top issues. 67+ checks across
+    12 categories. Free — no payment or setup needed."""
     async with httpx.AsyncClient(timeout=120) as client:
         resp = await client.post(
             f"{API_BASE}/api/aeo/scan",
             json={"url": url, "pages": min(max(1, pages), 5)},
-            headers={"Content-Type": "application/json"},
+            headers={"Content-Type": "application/json", "X-MCP-Tool": "scan_site"},
         )
         if resp.status_code >= 400:
             try:
@@ -96,13 +113,13 @@ async def scan_site(url: str, pages: int = 5) -> str:
 async def audit_site(
     url: str, pages: int = 5, categories: list[str] | None = None
 ) -> str:
-    """Full AI visibility audit across 58+ checks in 12 categories:
+    """Full AI visibility audit across 67+ checks in 12 categories:
     AEO (structured data, meta & technical, AI accessibility, content quality),
     GEO (brand narrative, citation readiness with 3 research-backed checks,
     authority signals, entity definition), and Agent Readiness (machine
     identity, API discoverability, structured actions, programmatic access).
     Returns AI Identity Card with mention readiness and detected competitors.
-    Requires API key (set AEO_API_KEY env var). $1.00 per call."""
+    Pay per call ($1.00) via x402 — USDC on Base or Solana."""
     payload: dict = {"url": url, "pages": min(max(1, pages), 5)}
     if categories:
         payload["categories"] = categories
@@ -117,7 +134,7 @@ async def compare_sites(url: str, competitor_url: str, pages: int = 5) -> str:
     fix code with projected scores after closing gaps. Use when the user
     wants to benchmark against a competitor or when scan_site detects
     competitors in the AI Identity Card.
-    Requires API key (set AEO_API_KEY env var). $3.00 per call."""
+    Pay per call ($3.00) via x402 — USDC on Base or Solana."""
     return await _handle_paid_request(
         "/api/aeo/compare",
         {"url": url, "competitorUrl": competitor_url, "maxPages": min(max(1, pages), 5)},
@@ -132,7 +149,7 @@ async def fix_site(url: str, pages: int = 5, format: str = "generic") -> str:
     quick wins (critical + high fixes only) and full implementation
     ceiling (all fixes). Content recommendations include research citations.
     Set format to 'claude_code' for Claude Code optimized output.
-    Requires API key (set AEO_API_KEY env var). $5.00 per call."""
+    Pay per call ($5.00) via x402 — USDC on Base or Solana."""
     return await _handle_paid_request(
         "/api/aeo/fix",
         {"url": url, "pages": min(max(1, pages), 5), "format": format},
@@ -141,7 +158,7 @@ async def fix_site(url: str, pages: int = 5, format: str = "generic") -> str:
 
 @mcp.resource("aeo://reference/scoring-methodology")
 async def scoring_methodology() -> str:
-    """How AEO, GEO, and Agent Readiness scores are calculated across 58+ checks in 12 categories. Includes mention readiness, business profiles, and research sources."""
+    """How AEO, GEO, and Agent Readiness scores are calculated across 67+ checks in 12 categories. Includes mention readiness, business profiles, and research sources."""
     path = os.path.join(os.path.dirname(__file__), "..", "scoring-methodology.md")
     with open(path) as f:
         return f.read()
@@ -184,9 +201,10 @@ Priority focus: {priority}
 If priority is "auto", use the detected business profile to decide emphasis.
 
 If any paid tool returns a payment_required error, tell the user:
-- Get an API key at https://scan.convrgent.ai
-- Set it as AEO_API_KEY in your MCP config
-- Or pay per call with USDC via x402 protocol
+- The tools are pay-per-call via the x402 protocol (USDC on Base or Solana)
+- The error includes the full x402 payload (payTo address, amount, asset)
+- An x402-capable client can retry with a signed X-PAYMENT header
+- Details: https://www.x402.org/ and https://scan.convrgent.ai
 """