# Convrgent AEO Fix Generator

> Convrgent AEO Fix Generator is a paid API for AI agents from scan.convrgent.ai, paid per call via x402, $5/call, status unknown (last checked 2026-09-14).

Audits a website's AI search visibility signals and generates site-specific copy-paste fix code to improve discoverability in ChatGPT, Perplexity, Google AI Overviews, and Bing Copilot

## Facts

- Endpoint: POST https://scan.convrgent.ai/api/aeo/fix
- Price: $5/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/scan-convrgent-ai-3b2c18d5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7NwRX4w_GFpji6JBiT-Af

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability scan-convrgent-ai-3b2c18d5 -d '<json body>'
```

Example prompt: Can you audit my tech blog at example-tech-blog.com (scanning up to 3 pages, compared against competitor-tech-blog.com) and generate copy-paste JSON-LD fixes, meta tag updates, and an llms.txt so it shows up better in ChatGPT, Perplexity, and Google AI Overviews?

## When to prefer this

Choose this endpoint when you need not just an audit but actionable, site-specific fix code — including JSON-LD, meta tags, llms.txt, robots.txt, sitemap patches, and a SKILL.md — rather than a read-only scan. Use it when you want a PDF report and score projection alongside the fixes, or when you need competitor comparison integrated into the fix recommendations. Prefer the sibling /api/aeo/scan endpoints if you only need diagnostic scores without generated fix artifacts.

## Known failure modes

- Payment not provided or insufficient (402 Payment Required with USDC payment details on Base or Solana)
- Invalid or unreachable URL provided (connection error or 4xx/5xx response)
- maxPages exceeds allowed limit (validation error)
- Competitor URL unreachable or blocked (partial results returned without competitor analysis)
- Site blocks crawlers via robots.txt (limited scan results)

## How this service works

Scanner + fix generator for AI search visibility (AEO, GEO) and agent readiness — audits JSON-LD Schema.org structured data, meta tags, robots.txt, llms.txt, sitemap, then outputs site-specific copy-paste code to improve discoverability in ChatGPT, Perplexity, Google AI Overviews, and Bing Copilot. Includes SKILL.md for Claude Code, PDF report, and score projection.

## Output

Returns site-specific copy-paste code fixes for JSON-LD Schema.org structured data, meta tags, robots.txt, llms.txt, and sitemap; a SKILL.md file for Claude Code integration; a PDF audit report; and a projected score improvement for AI search visibility across ChatGPT, Perplexity, Google AI Overviews, and Bing Copilot.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "properties": {
      "url": {
       "type": "string",
       "description": "Full URL of the site to fix (required unless scanId is given)"
      },
      "scanId": {
       "type": "string",
       "description": "id from a recent /api/aeo/audit response (kept 1 hour) — skips the re-crawl, instant response, same price"
      },
      "maxPages": {
       "type": "integer",
       "default": 10,
       "maximum": 10,
       "minimum": 1,
       "description": "Maximum pages to crawl (1-10); ignored when scanId is used"
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "fixes": {
       "type": "array"
      },
      "product": {
       "type": "string"
      },
      "aeoGrade": {
       "type": "string"
      },
      "aeoScore": {
       "type": "integer"
      },
      "pagesScanned": {
       "type": "integer"
      },
      "scoreProjection": {
       "type": "object"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "fixes": [
   {
    "code": "<script type=\"application/ld+json\">...",
    "type": "json-ld",
    "priority": "critical",
    "description": "Add Organization schema description"
   }
  ],
  "product": "AEO",
  "aeoGrade": "B",
  "aeoScore": 73,
  "geoReadiness": {
   "grade": "D",
   "score": 45
  },
  "pagesScanned": 5,
  "agentReadiness": {
   "grade": "C",
   "score": 62
  },
  "scoreProjection": {
   "quickWins": {
    "aeo": 89,
    "geo": 67,
    "agent": 75
   },
   "fullCeiling": {
    "aeo": 95,
    "geo": 91,
    "agent": 89
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/scan-convrgent-ai-3b2c18d5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from scan.convrgent.ai](https://www.zero.xyz/host/scan.convrgent.ai/llms.txt)