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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aeo-scanner
-Version: 2.2.2
+Version: 2.2.3
 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

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

@@ -1,6 +1,6 @@
 [project]
 name = "aeo-scanner"
-version = "2.2.2"
+version = "2.2.3"
 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 → aeo_scanner-2.2.3}/server.json

@@ -7,7 +7,7 @@
     "url": "https://github.com/Convrgent/aeo-saas",
     "source": "github"
   },
-  "version": "2.2.2",
+  "version": "2.2.3",
   "remotes": [
     {
       "type": "streamable-http",
@@ -18,7 +18,7 @@
     {
       "registryType": "pypi",
       "identifier": "aeo-scanner",
-      "version": "2.2.2",
+      "version": "2.2.3",
       "transport": {
         "type": "stdio"
       }

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

@@ -119,6 +119,8 @@ async def audit_site(
     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.
+    TIP: the response's id can be passed as scan_id to fix_site within
+    1 hour to get fix code without a re-crawl.
     Pay per call ($1.00) via x402 — USDC on Base or Solana."""
     payload: dict = {"url": url, "pages": min(max(1, pages), 5)}
     if categories:
@@ -142,18 +144,26 @@ async def compare_sites(url: str, competitor_url: str, pages: int = 5) -> str:
 
 
 @mcp.tool()
-async def fix_site(url: str, pages: int = 5, format: str = "generic") -> str:
+async def fix_site(
+    url: str = "", pages: int = 5, format: str = "generic", scan_id: str = ""
+) -> str:
     """Generate complete fix code for all AI visibility issues across
     AEO, GEO, and Agent Readiness. Returns working code that coding
     agents can apply directly. Includes two-tier score projections:
     quick wins (critical + high fixes only) and full implementation
-    ceiling (all fixes). Content recommendations include research citations.
+    ceiling (all fixes). TIP: pass scan_id from a fresh audit_site result
+    (kept 1 hour) to skip the re-crawl — instant response, same price.
+    Content recommendations include research citations.
     Set format to 'claude_code' for Claude Code optimized output.
     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},
-    )
+    # Backend reads maxPages (not pages) — this also fixes a latent drift
+    # where the old payload key was silently ignored and the default applied.
+    payload: dict = {"maxPages": min(max(1, pages), 10), "format": format}
+    if url:
+        payload["url"] = url
+    if scan_id:
+        payload["scanId"] = scan_id
+    return await _handle_paid_request("/api/aeo/fix", payload)
 
 
 @mcp.resource("aeo://reference/scoring-methodology")

{aeo_scanner-2.2.2 → aeo_scanner-2.2.3}/workers/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "aeo-scanner-mcp",
-	"version": "2.2.2",
+	"version": "2.2.3",
 	"private": true,
 	"scripts": {
 		"deploy": "wrangler deploy",

{aeo_scanner-2.2.2 → aeo_scanner-2.2.3}/workers/src/api-client.test.ts

@@ -150,6 +150,26 @@ describe("paid tools — payment proxy behavior", () => {
     expect(sentBody(fetchCalls[0]).format).toBe("claude_code");
   });
 
+  it("callFix passes scan_id through as scanId and omits url when absent", async () => {
+    mockFetchResponse(200, "{}");
+
+    await callFix(env, undefined, 5, "generic", null, "scan_1_abc123");
+
+    const body = sentBody(fetchCalls[0]);
+    expect(body.scanId).toBe("scan_1_abc123");
+    expect(body.url).toBeUndefined();
+  });
+
+  it("callFix sends both url and scanId when both provided", async () => {
+    mockFetchResponse(200, "{}");
+
+    await callFix(env, "https://example.com", 5, "generic", null, "scan_1_abc123");
+
+    const body = sentBody(fetchCalls[0]);
+    expect(body.url).toBe("https://example.com");
+    expect(body.scanId).toBe("scan_1_abc123");
+  });
+
   it("callCompare sends both URLs, clamps maxPages to 5, uses compare_sites pricing", async () => {
     mockFetchResponse(402, "{}");
 

{aeo_scanner-2.2.2 → aeo_scanner-2.2.3}/workers/src/api-client.ts

@@ -100,16 +100,21 @@ export async function callAudit(
 
 export async function callFix(
   env: Env,
-  url: string,
+  url: string | undefined,
   pages: number,
   format: string,
   clientPaymentHeader: string | null,
+  scanId?: string,
 ): Promise<ApiResult> {
-  return handlePaidRequest(env, "/api/aeo/fix", {
-    url,
+  const payload: Record<string, unknown> = {
     maxPages: Math.min(Math.max(1, pages), 10),
     format,
-  }, clientPaymentHeader);
+  };
+  if (url) payload.url = url;
+  // scanId reuses a recent audit's crawl server-side (1h TTL) — same price,
+  // instant response. Backend contract: url OR scanId required.
+  if (scanId) payload.scanId = scanId;
+  return handlePaidRequest(env, "/api/aeo/fix", payload, clientPaymentHeader);
 }
 
 export async function callCompare(

{aeo_scanner-2.2.2 → aeo_scanner-2.2.3}/workers/src/index.ts

@@ -6,7 +6,7 @@ import { registerPrompts } from "./prompts";
 
 export class AeoScannerMcp extends McpAgent<Env> {
   server = new McpServer(
-    { name: "aeo-scanner", version: "2.2.2" },
+    { name: "aeo-scanner", version: "2.2.3" },
     {
       instructions:
         "AI search visibility audit for any website. Returns three scores (AEO, GEO, Agent Readiness), AI Identity Card with mention readiness and detected competitors, and business profile. Use scan_site first (free), then audit_site for details, fix_site for fix code, or compare_sites to benchmark against a competitor. The optimize_site prompt guides the full workflow.",

{aeo_scanner-2.2.2 → aeo_scanner-2.2.3}/workers/src/tools.ts

@@ -37,7 +37,7 @@ export function registerTools(server: McpServer, env: Env) {
 
   server.tool(
     "audit_site",
-    "Full AI visibility audit across 67+ checks in 12 categories (4 AEO + 4 GEO + 4 Agent Readiness). Returns detailed per-check scores with specific issues and recommendations, AI Identity Card with mention readiness and detected competitors, and business profile. GEO checks include 3 research-backed citation signals: factual density, answer frontloading, and source citations. Agent Readiness covers emerging agent-discovery standards Cloudflare's isitagentready.com evaluates: RFC 9727 api-catalog, SEP-1649 MCP Server Card, and IETF Content-Signal (draft-romm-aipref). Does NOT generate fix code — use fix_site for that, or compare_sites to benchmark against a competitor. Pay per call ($1.00) via x402 — USDC on Base or Solana. Machine payment via signed X-PAYMENT header; see https://www.x402.org/. On payment_required, the response includes the full x402 payload with payTo/amount/asset.",
+    "Full AI visibility audit across 67+ checks in 12 categories (4 AEO + 4 GEO + 4 Agent Readiness). Returns detailed per-check scores with specific issues and recommendations, AI Identity Card with mention readiness and detected competitors, and business profile. GEO checks include 3 research-backed citation signals: factual density, answer frontloading, and source citations. Agent Readiness covers emerging agent-discovery standards Cloudflare's isitagentready.com evaluates: RFC 9727 api-catalog, SEP-1649 MCP Server Card, and IETF Content-Signal (draft-romm-aipref). Does NOT generate fix code — pass this response's id as scan_id to fix_site (within 1 hour) to get fixes WITHOUT a re-crawl, or use compare_sites to benchmark against a competitor. Pay per call ($1.00) via x402 — USDC on Base or Solana. Machine payment via signed X-PAYMENT header; see https://www.x402.org/. On payment_required, the response includes the full x402 payload with payTo/amount/asset.",
     {
       url: z.string().describe("Full URL to audit"),
       pages: z
@@ -63,25 +63,29 @@ export function registerTools(server: McpServer, env: Env) {
 
   server.tool(
     "fix_site",
-    "Generate complete fix code for all AI visibility issues across AEO, GEO, and Agent Readiness. Returns working code you can apply directly — schema generation, robots.txt, sitemap, llms.txt, meta tags, structured data, citation signals, entity markup. Also returns two-tier score projections: quick wins (critical + high fixes only) and full implementation ceiling (all fixes). Content recommendations include research citations. Run scan_site first to see which issues exist. Pay per call ($5.00) via x402 — USDC on Base or Solana. On payment_required, the response includes the full x402 payload with payTo/amount/asset.",
+    "Generate complete fix code for all AI visibility issues across AEO, GEO, and Agent Readiness. Returns working code you can apply directly — schema generation, robots.txt, sitemap, llms.txt, meta tags, structured data, citation signals, entity markup. Also returns two-tier score projections: quick wins (critical + high fixes only) and full implementation ceiling (all fixes). TIP: pass scan_id from a fresh audit_site result (kept 1 hour) to skip the re-crawl — instant response, same price. Content recommendations include research citations. Run scan_site first to see which issues exist. Pay per call ($5.00) via x402 — USDC on Base or Solana. On payment_required, the response includes the full x402 payload with payTo/amount/asset.",
     {
-      url: z.string().describe("Full URL to generate fixes for"),
+      url: z.string().optional().describe("Full URL to generate fixes for (required unless scan_id is given)"),
+      scan_id: z
+        .string()
+        .optional()
+        .describe("id from a recent audit_site response — reuses that crawl (1h TTL), instant response"),
       pages: z
         .number()
         .int()
         .min(1)
         .max(10)
         .default(5)
-        .describe("Number of pages to analyze (1-10)"),
+        .describe("Number of pages to analyze (1-10); ignored when scan_id is used"),
       format: z
         .enum(["generic", "claude_code"])
         .default("generic")
         .describe("Output format: generic or claude_code (optimized for Claude Code)"),
     },
     { openWorldHint: true },
-    async ({ url, pages, format }) => {
-      console.log(`[TOOL] fix_site | url=${url} | pages=${pages} | format=${format}`);
-      return toToolResult(await callFix(env, url, pages, format, null));
+    async ({ url, scan_id, pages, format }) => {
+      console.log(`[TOOL] fix_site | url=${url ?? "-"} | scan_id=${scan_id ?? "-"} | pages=${pages} | format=${format}`);
+      return toToolResult(await callFix(env, url, pages, format, null, scan_id));
     },
   );