AI Agent · 22 tools · Open Source

AEO Agent

Measures and improves your brand’s visibility in AI-powered search engines — ChatGPT, Perplexity, Claude, Gemini, Google AI Overviews. Tracks citations, audits entity recognition, optimizes content for AI citability, and auto-fixes issues via GitHub PRs.

AI SDK v6Gemini 2.0 FlashNext.jsOpenAI APIGoogle AI APIPerplexity API
Tools: 22
Schedules: Daily / Weekly / Monthly
Notifications: Discord

Capabilities

What it does for you

1

Multi-model visibility testing

Tests your brand across ChatGPT, Gemini, Perplexity with intent-segmented queries (navigational, informational, transactional, comparison). Tracks citation rates and response snapshots over time.

2

Entity & knowledge audit

Checks if AI models correctly identify your brand. Audits Wikidata, Google Knowledge Panel, Crunchbase presence. Maps entity relationships.

3

Content optimization for AI

Scores pages for AI citability (8 criteria, 0-100). Audits JSON-LD schemas. Optimizes llms.txt. Generates FAQ content grounded in real page data.

4

AI crawler monitoring

Audits robots.txt for 10 AI bots (GPTBot, ClaudeBot, PerplexityBot...). Tracks crawler visit patterns from server logs. Monitors content freshness.

5

Automated fixes via GitHub PRs

Generates schema markup, FAQ sections, llms.txt improvements. Creates PRs with duplicate detection. Tracks change impact — measures visibility before and after.

6

Strategy & reporting

Data-driven improvement suggestions based on actual audit data. HTML reports with trend charts. Discord notifications with action items.

Architecture

How it works

Next.js App

Chat UI

useChat

/api/chat

Route Handler

ToolLoopAgent

Gemini 2.0 Flash

Visibility

4 tools

Entity

3 tools

Content

4 tools

Crawl

3 tools

Action

4 tools

Strategy

3 tools

AI Model APIs

Target Website

GitHub

Discord

Vercel Blob

The agent uses Vercel AI SDK’s ToolLoopAgent pattern. Given a prompt, the LLM autonomously decides which tools to call and in what order. A full audit triggers all 22 tools across visibility testing, entity auditing, and content optimization.

Multi-model testing strategy: Every visibility test runs across ChatGPT, Gemini, and Perplexity simultaneously with intent-segmented queries — navigational, informational, transactional, and comparison. Gemini 2.0 Flash handles the orchestration at low cost.

22 Tools

Complete tool inventory

Visibility (4)

testMultiModelVisibilityTests brand visibility across ChatGPT, Gemini, Perplexity with intent-segmented queries
trackCitationSourcesTracks citation rates and response snapshots over time
analyzeAIOverviewPresenceChecks presence in Google AI Overviews and featured AI responses
benchmarkCompetitorsAEOBenchmarks brand visibility against competitors across AI models

Entity & Knowledge (3)

analyzeEntityRecognitionChecks if AI models correctly identify and describe your brand
auditKnowledgeGraphAudits Wikidata, Google Knowledge Panel, and Crunchbase presence
mapEntityRelationshipsMaps entity relationships and brand associations in AI knowledge bases

Content Optimization (4)

analyzeContentForAIScores pages for AI citability across 8 criteria (0-100)
auditSchemaForAIAudits JSON-LD schemas for AI comprehension and citation eligibility
optimizeLlmsTxtOptimizes llms.txt for AI crawler guidance and content framing
generateFAQContentGenerates FAQ content grounded in real page data for AI citability

Crawl & Freshness (3)

auditAICrawlersAudits robots.txt for 10 AI bots: GPTBot, ClaudeBot, PerplexityBot, and more
trackAICrawlerVisitsTracks crawler visit patterns from server logs
monitorContentFreshnessMonitors content freshness and update frequency for AI indexing signals

Action (4)

createGitHubPRCreates pull requests with duplicate detection for automated fixes
writeAEOReportGenerates HTML reports with trend charts and citation data
notifyTeamSends Discord notifications with visibility scores and action items
generateStructuredDataGenerates schema markup and FAQ sections for improved AI citability

Strategy (3)

suggestAEOImprovementsData-driven improvement suggestions based on actual audit results
identifyCitationOpportunitiesIdentifies content gaps and topics where AI models could cite the brand
analyzeQueryPatternsAnalyzes query intent patterns to prioritize visibility improvements

Autonomous Workflow

Runs on cron, reports via Discord

Daily · 7:00 UTC

AI Bot Check

Robots.txt audit for 10 AI bots, sitemap validation, quick health check of AI crawler access.

Weekly · Monday 7:00 UTC

Visibility Test & Benchmark

Multi-model visibility test across ChatGPT, Gemini, Perplexity. Citation tracking, competitor benchmark, Discord report. Strategy adaptation on 3+ weeks stagnation.

Monthly · 1st, 8:00 UTC

Full AEO Audit

Complete audit in 3 checkpoint phases: entity recognition, schema, content, knowledge graph. Auto-fix PR generation. HTML report with trend charts.

Discord Integration

AEO Agent

Weekly Visibility Report— yoursite.com

Visibility: 45% (+3%) | Citations: 12 | Models: 4/4 responding

ChatGPT: mentioned in 3/5 queries (+1)
Perplexity: cited as source 2x
Gemini: brand recognized, no citation
Claude: not mentioned

Action needed: Add FAQPage schema to /pricing

Get Started

Deploy your own in 5 steps

The full source code is on GitHub. Clone it, add your API keys, deploy to Vercel, and you have a production AEO agent tracking your AI search visibility.

1

Clone the repo

git clone https://github.com/jamnyjakub700-cloud/aeo-agent — then npm install. The README covers everything.

2

Connect AI model APIs

OpenAI, Google AI, and Anthropic API keys — all needed for multi-model visibility testing. Perplexity API key optional but recommended.

3

Add your site config

Set SITE_URL, COMPANY_NAME, TARGET_KEYWORDS, and COMPETITORS in environment variables. The agent uses these for all queries and benchmarks.

4

Choose notification channel

Discord webhook for daily, weekly, and monthly reports. The agent sends visibility scores, citation tracking, and action items.

5

Deploy to Vercel

Connect the repo to Vercel, add environment variables, deploy. Cron jobs are pre-configured — daily 7:00, weekly Monday 7:00, monthly 1st 8:00.

Contact

Let’s talk.

Currently open to

  • Founding roles at early-stage B2B SaaS (Europe, remote)
  • Fixed-scope AI agent sprints (4 to 8 weeks)
  • Advisory for non-technical founders building with AI

or email jakub.jamny@cyrcid.com