# AgentAEO - Retrieval Marketing OS

> AgentAEO diagnoses how AI search engines (ChatGPT, Perplexity, Claude, Google AI) find, extract, and cite your brand. Get your AEO audit, fix citation gaps, and become the answer AI gives.

## Brand assets (for previews & citations)

- Logo (square PNG, 512×512): https://agentaeo.com/logo.png
- Favicon (SVG): https://agentaeo.com/favicon.svg
- Apple touch icon: https://agentaeo.com/apple-touch-icon.png

## Site Structure

- Homepage: https://agentaeo.com/
- Product (crawlable): https://agentaeo.com/product
- Pricing (crawlable): https://agentaeo.com/pricing
- Integrations & API overview: https://agentaeo.com/integrations
- API troubleshooting (crawlable): https://agentaeo.com/api/errors
- Free AEO Audit: https://agentaeo.com/audit/start
- Agent API & Developer Portal: https://agentaeo.com/agents
- MCP Server (crawlable): https://agentaeo.com/mcp
- API Documentation: https://agentaeo.com/agents/docs
- AEO Audit Details: https://agentaeo.com/aeo-audit
- Schema & Content for AI: https://agentaeo.com/aeo-content-schema
- Managed AEO Services: https://agentaeo.com/managed-services
- Sample Report: https://agentaeo.com/sample-report
- Resources & Blog: https://agentaeo.com/resources
- Resource — AI search visibility audits for agencies: https://agentaeo.com/resources/ai-search-visibility-audits-for-agencies
- Reviews — SEO agencies & AgentAEO: https://agentaeo.com/reviews/seo-agencies-2026
- Docs — Agency setup: https://agentaeo.com/docs/agency-setup
- Docs — Integrations guide: https://agentaeo.com/docs/integrations-guide
- Docs — Analytics integration: https://agentaeo.com/docs/analytics-integration
- Compare — AgentAEO vs Otterly: https://agentaeo.com/compare/agentaeo-vs-otterly
- Compare — AgentAEO vs Airanklab: https://agentaeo.com/compare/agentaeo-vs-airanklab
- Contact: https://agentaeo.com/contact

## API Endpoints

Base URL: https://agentaeo-api.onrender.com

Use this gateway for integrations (do not embed raw Supabase project URLs in public clients). Full request and response shapes, auth, and polling are documented at https://agentaeo.com/agents/docs and in https://agentaeo.com/openapi.json.

### POST /api/aeo-audit
Run an AEO audit. Requires authentication (Bearer token or `X-API-Key` from the Developer Portal after sign-in).

Request body (typical):
```json
{
  "url": "https://example.com",
  "keyword": "your industry keyword",
  "tier": "free",
  "async": true
}
```

Tiers:
- `free` - 8 queries across 4 AI platforms (ChatGPT, Perplexity, Claude, Google AI)
- `paid` - 40 queries across 4 AI platforms with full blueprint

Response (async): includes `auditId` and polling instructions. Poll until completion.

### GET /api/aeo-status/{auditId}
Poll audit status and retrieve results. Replace `{auditId}` with the ID returned from `POST /api/aeo-audit`.

Response (when complete): includes score, grade, findings, and platform breakdown fields as documented in the Developer Portal.

## MCP Server

- AgentAEO MCP Server: https://agentaeo.com/mcp
- Install: npx @agentaeo/mcp-server
- Registry: Anthropic official + Glama AAA
- Use case: AI citation audits inside Claude Desktop

Package: `@agentaeo/mcp-server`

Claude Desktop configuration:
```json
{
  "mcpServers": {
    "agentaeo": {
      "command": "npx",
      "args": ["@agentaeo/mcp-server"],
      "env": {
        "AGENTAEO_API_KEY": "your_api_key_here"
      }
    }
  }
}
```

## Webhook Events

Configure webhooks to receive notifications:
- `audit.completed` - Audit finished successfully
- `audit.failed` - Audit encountered an error
- `content.ready` - Content Suite generation complete

## Authentication

1. Sign up at https://agentaeo.com/auth
2. Navigate to https://agentaeo.com/agents
3. Generate an API key from the Developer Portal
4. Use the key via `X-API-Key` header or Bearer token

## Pricing

- Free Diagnosis: $0 - 8 queries across 4 AI platforms
- Full Diagnostic: $149 - 40 queries, citation gap analysis, 30-day blueprint
- Content Suite: $499 - AEO-optimized pages with JSON-LD schema + llms.txt for AI crawler optimization
- Managed Services: Custom - ongoing AI visibility program

## Contact

- Support: support@agentaeo.com
- Agent/API: agents@agentaeo.com
- Website: https://agentaeo.com

## OpenAPI Spec

Available at: https://agentaeo.com/openapi.json