aeo-auditor

aeo-auditor is an agent for Claude Code from Houseofmvps/claude-rank. It costs 28 tokens per session (1,031 once invoked), scanned A, original, MIT.

An audit tool for improving how websites appear in direct-answer search results, such as featured snippets, voice search, and “People Also Ask” boxes.

In plain words
What is it for?
It is for finding snippet opportunities and checking FAQ, HowTo, and speakable structured data on blogs, SaaS sites, shops, and local-business websites.
Why use it?
It identifies content and structured-data gaps that can prevent search engines and voice assistants from presenting a site as an answer.

Agent for Claude Code

Written for Claude Code: ${CLAUDE_PLUGIN_ROOT} variable. Also seen: model in frontmatter.

Runs only inside its plugin — its command needs a path that Claude Code sets for a plugin’s own hooks and for nothing else. Install the plugin, not this.

Part of the claude-rank plugin — 6 skills, 12 commands, 9 agents, 1 hook shipped together

Good fit It is for finding snippet opportunities and checking FAQ, HowTo, and speakable structured data on blogs, SaaS sites, shops, and local-business websites.

Compare 6 agents from other repositories ↓
Install

Getting it into your agent

This one installs as part of its plugin. Adding the marketplace and installing the plugin brings it with everything else the plugin ships.

Claude Code
/plugin marketplace add Houseofmvps/claude-rank
Claude Code
/plugin install claude-rank

Made for: Claude Code.

Or install claude-rank, the plugin that ships this one along with the rest of its 6 skills, 12 commands, 9 agents, 1 hook.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for aeo-auditor

README.md
[![agentmods](https://agentmods.dev/badge/agents/houseofmvps/claude-rank/aeo-auditor/github.svg)](https://agentmods.dev/agents/houseofmvps/claude-rank/aeo-auditor)
Your own site
<a href="https://agentmods.dev/agents/houseofmvps/claude-rank/aeo-auditor"><img src="https://agentmods.dev/badge/agents/houseofmvps/claude-rank/aeo-auditor/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for aeo-auditor

Your own site · 80×15
<a href="https://agentmods.dev/agents/houseofmvps/claude-rank/aeo-auditor"><img src="https://agentmods.dev/badge/agents/houseofmvps/claude-rank/aeo-auditor.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 28 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 1,031 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00028 $0.01031
Opus 5 $0.00014 $0.00515
Sonnet 5 $0.00006 $0.00206
Haiku 4.5 $0.00003 $0.00103

Measured 9d ago against content hash 5d8809d4b020, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-09, from the pricing page.

Security

Grade A, and why

aeo-auditor scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 9d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

agents/aeo-auditor.md · 90 lines

How it starts

The opening of the file, as written. The whole thing — 90 lines — stays where its author put it; the contents beside it link to each section on GitHub.

You are the AEO Auditor agent for claude-rank. Audit a site's readiness for featured snippets, People Also Ask boxes, voice search results, and other direct answer features.

Step 1: Identify Snippet Opportunities

Before scanning, assess the site's answer engine potential:

  • Blog/content sites: High snippet opportunity — look for how-to, what-is, comparison content
  • SaaS: Medium opportunity — pricing FAQs, feature comparisons, "how does [product] work?"
  • E-commerce: High opportunity — product FAQs, buying guides, "best [category]" content
  • Local business: High opportunity — service FAQs, "near me" patterns, operating hours

Step 2: Run Scanner

node ${CLAUDE_PLUGIN_ROOT}/tools/aeo-scanner.mjs <project-directory>

Parse the JSON output.

Step 3: Schema Gap Analysis

Check which answer-engine schemas are present vs missing:

Schema Purpose Priority
FAQPage Powers FAQ rich results and People Also Ask Critical for any site with Q&A content
HowTo Powers how-to rich results with steps Critical for tutorial/guide content
speakable Tells voice assistants which content to read aloud High for voice search optimization
Article/BlogPosting Enables article rich results with author, date High for content sites
BreadcrumbList Shows page hierarchy in search results Medium — improves CTR

Don't just flag "missing FAQPage" — explain: "Your /pricing page has 6 questions with answers but no FAQPage schema. Adding it would make these eligible for FAQ rich results in Google, which typically increases CTR by 20-30%."

Step 4: Snippet Fitness Analysis

Evaluate content readiness for featured snippets:

  • Paragraph snippets (most common): Need a direct, concise answer in 40-60 words immediately after a question H2. Check if the site's answers are too long, too vague, or buried in paragraphs.
  • List snippets: Need numbered/bulleted lists under "how to" or "best" H2s. Check for procedural content that isn't using ordered lists.
  • Table snippets: Need HTML tables for comparison content. Check for comparison pages without proper table markup.
  • Voice search: Google voice answers average 29 words. Check if any answers are concise enough.

Read the full file on GitHub · 90 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 9d ago First seen · 90 lines · 28 tokens per session scan A 5d8809d4b020

Subscribe to this mod's changes

aeo-auditor is an agent published in the GitHub repository Houseofmvps/claude-rank (143 stars, last pushed 2mo ago), licensed MIT. It adds 28 tokens to every session and 1,031 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other agents, from other repositories

geo-content

Content quality specialist evaluating E-E-A-T signals (Experience, Expertise, Authoritativeness, Trustworthiness), content depth, readability, AI content detection, and topical authority.

asale-ai/seo-geo-skill · 37 tokens

geo-schema

Schema markup specialist detecting, validating, and generating structured data (JSON-LD preferred). Focuses on schemas that improve AI discoverability including Organization, Person, Article, sameAs, and speakable properties.

asale-ai/seo-geo-skill · 44 tokens

geo-technical

Technical SEO specialist analyzing crawlability, indexability, security, URL structure, mobile optimization, Core Web Vitals (INP replaces FID), server-side rendering, and JavaScript dependency.

asale-ai/seo-geo-skill · 42 tokens

geo-platform-analysis

Platform optimization specialist analyzing readiness for Google AI Overviews, ChatGPT web search, Perplexity AI, Google Gemini, and Bing Copilot.

asale-ai/seo-geo-skill · 33 tokens

geo-ai-visibility

GEO specialist analyzing AI search visibility: citability scoring, AI crawler access, llms.txt compliance, and brand mention presence across AI-cited platforms. Delegates to geo-citability, geo-crawlers, geo-llmstxt, and geo-brand-mentions skills.

asale-ai/seo-geo-skill · 62 tokens

seo-backlinks

Backlink profile analyst using free and paid sources. Fetches data from Moz API, Bing Webmaster Tools, Common Crawl web graphs, and verification crawler. Merges multi-source data with confidence-weighted scoring.

asale-ai/seo-geo-skill · 45 tokens