Subchapter 2.2
prd.mdMarkdown35 KBView on GitHub
Goal: Generate machine-readable content that earns citations and links from ChatGPT, Claude, Gemini, and Google AI Overviews.
Not in scope: Building automation tools or complex workflows. This is a content generation guide for manual/Claude-assisted implementation.
These principles are derived from LLM citation behavior analysis and should inform all content optimization decisions:
domain.com/specific-concept rather than comprehensive guidesWhen analyzing a website for AEO optimization, Claude Code should produce:
A concise definition that appears immediately under the H1, including:
Structured question-answer pairs optimized for AI extraction:
For every important assertion, add a citation-worthy evidence panel:
Complete, working schema for:
When relevant, add step-by-step guides with:
Front-load value propositions
Structure for scannability
Optimize for quotability and extraction
Extraction-Ready Sentence Examples:
Critical: 95% of ChatGPT citations come from content updated in the last 10 months.
Required freshness indicators:
AI engines reward specificity over marketing claims:
✅ Good: “In a benchmark of 1,000 queries (July 2025), our system achieved 127ms median latency using the GPT-4 API.”
❌ Bad: “Our system is incredibly fast and delivers amazing results.”
Include:
Essential schema types:
Technical requirements:
<script type="application/ld+json"> in <head><article id="product-overview">
<h1>What is [Product Name]?</h1>
<div class="overview-answer">
<p>[Product Name] is a [category] that [core function].
As of [Month Year], it [key differentiator/scope].
This matters because [value proposition in one sentence].</p>
<p class="meta">Last updated: 2025-10-31</p>
</div>
<!-- Schema markup -->
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Product",
"name": "[Product Name]",
"description": "[50-word description from above]",
"brand": {
"@type": "Brand",
"name": "[Your Company]"
},
"offers": {
"@type": "Offer",
"url": "https://example.com/product",
"priceCurrency": "USD",
"price": "99.00",
"availability": "https://schema.org/InStock"
}
}
</script>
</article>Example:
What is AEO Optimizer?
AEO Optimizer is a content analysis tool that identifies gaps in website
structure for AI search engines. As of October 2025, it supports ChatGPT,
Claude, and Gemini analysis. This matters because 60% of searches now end
without a click, making AI citation the new discovery channel.
Last updated: 2025-10-31<section id="faq">
<h2>Frequently Asked Questions</h2>
<div class="faq-item" id="faq-what-is-aeo">
<h3>What is Answer Engine Optimization?</h3>
<p>Answer Engine Optimization (AEO) is the practice of structuring
website content so AI systems like ChatGPT, Claude, and Gemini can
easily extract, cite, and link to your information. It focuses on
machine-readable formats like JSON-LD and 30-50 word answers.</p>
<p class="meta">Last updated: 2025-10-31</p>
</div>
<div class="faq-item" id="faq-how-different-from-seo">
<h3>How is AEO different from SEO?</h3>
<p>SEO optimizes for ranking in search result lists, while AEO
optimizes for being cited in AI-generated answers. AEO requires
shorter, more structured answers (30-50 words), strict schema markup,
and evidence blocks that AI can verify and quote directly.</p>
<p class="meta">Last updated: 2025-10-31</p>
</div>
<!-- Add 13 more FAQ items following same pattern -->
<!-- FAQPage Schema -->
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "FAQPage",
"mainEntity": [
{
"@type": "Question",
"name": "What is Answer Engine Optimization?",
"datePublished": "2025-01-15",
"dateModified": "2025-10-31",
"acceptedAnswer": {
"@type": "Answer",
"text": "Answer Engine Optimization (AEO) is the practice of structuring website content so AI systems like ChatGPT, Claude, and Gemini can easily extract, cite, and link to your information. It focuses on machine-readable formats like JSON-LD and 30-50 word answers."
}
},
{
"@type": "Question",
"name": "How is AEO different from SEO?",
"datePublished": "2025-01-15",
"dateModified": "2025-10-31",
"acceptedAnswer": {
"@type": "Answer",
"text": "SEO optimizes for ranking in search result lists, while AEO optimizes for being cited in AI-generated answers. AEO requires shorter, more structured answers (30-50 words), strict schema markup, and evidence blocks that AI can verify and quote directly."
}
}
// Add remaining 13 FAQs with datePublished and dateModified
]
}
</script>
</section>FAQ Generation Guidelines:
Date Fields Explained:
datePublished: When the FAQ was first created (YYYY-MM-DD format)dateModified: When the FAQ was last updated (YYYY-MM-DD format)<p class="meta">Last updated: ...</p> is for humans; datePublished/dateModified are for AI engines<aside class="evidence-panel" id="evidence-latency-benchmark">
<h4>Evidence: Response Time Benchmark</h4>
<dl>
<dt>Claim:</dt>
<dd>Median API response time of 127ms for standard queries</dd>
<dt>Methodology:</dt>
<dd>Measured 1,000 API calls using standardized test queries
against GPT-4 endpoint</dd>
<dt>Data Source:</dt>
<dd><a href="https://example.com/benchmarks/2025-07">Internal
Benchmark Report Q3 2025</a></dd>
<dt>Date:</dt>
<dd>July 15, 2025</dd>
<dt>Limitations:</dt>
<dd>Results measured under optimal network conditions with pre-warmed
connections; production performance may vary ±20ms</dd>
<dt>Contact:</dt>
<dd>research@example.com</dd>
</dl>
<p class="meta">Last updated: 2025-07-15</p>
</aside>Machine-Readable Facts JSON (optional but recommended):
{
"page": "https://example.com/product-performance",
"version": "2025-10-31",
"lastUpdated": "2025-10-31T14:30:00Z",
"facts": [
{
"id": "latency_median",
"value": "127ms",
"source": "https://example.com/benchmarks/2025-07",
"as_of": "2025-07-15",
"method": "1000 API calls, GPT-4 endpoint, standard queries"
},
{
"id": "price",
"value": "$99/month",
"source": "https://example.com/pricing",
"as_of": "2025-10-01"
}
]
}Facts JSON Field Definitions:
page: URL of the page this data describesversion: Human-readable version date (YYYY-MM-DD)lastUpdated: ISO 8601 timestamp when this JSON was last generated (YYYY-MM-DDTHH:MM:SSZ)facts[].as_of: When each specific fact’s data was collectedWhy lastUpdated matters: Enables AI agents to programmatically check data staleness and determine whether to fetch fresh data.
Host this as page-name.json alongside the HTML page so agents can fetch structured data directly.
<article id="how-to-implement-faq-schema">
<h2>How to Implement FAQ Schema on Your Website</h2>
<ol>
<li>
<strong>Identify your top 15 customer questions</strong>
<p>Review support tickets, "People Also Ask" results, and sales
call recordings to find the most common questions.</p>
</li>
<li>
<strong>Write 30-50 word answers for each question</strong>
<p>Keep answers concise and factual. Front-load the direct answer,
then add supporting details.</p>
</li>
<li>
<strong>Add HTML structure with semantic markup</strong>
<p>Use H3 for questions, paragraph tags for answers, and assign
unique IDs to each FAQ item (#faq-question-slug).</p>
</li>
<li>
<strong>Generate FAQPage JSON-LD schema</strong>
<p>Use the template above or a schema generator. Place the script
in your page's <head> section.</p>
</li>
<li>
<strong>Validate with Google Rich Results Test</strong>
<p>Visit search.google.com/test/rich-results and enter your page
URL. Fix any errors reported.</p>
</li>
</ol>
<p class="meta">Last updated: 2025-10-31</p>
<!-- HowTo Schema -->
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "HowTo",
"name": "How to Implement FAQ Schema on Your Website",
"description": "Step-by-step guide to adding FAQPage schema markup for better AI search visibility",
"step": [
{
"@type": "HowToStep",
"name": "Identify your top 15 customer questions",
"text": "Review support tickets, 'People Also Ask' results, and sales call recordings to find the most common questions."
},
{
"@type": "HowToStep",
"name": "Write 30-50 word answers for each question",
"text": "Keep answers concise and factual. Front-load the direct answer, then add supporting details."
},
{
"@type": "HowToStep",
"name": "Add HTML structure with semantic markup",
"text": "Use H3 for questions, paragraph tags for answers, and assign unique IDs to each FAQ item."
},
{
"@type": "HowToStep",
"name": "Generate FAQPage JSON-LD schema",
"text": "Use the template above or a schema generator. Place the script in your page's head section."
},
{
"@type": "HowToStep",
"name": "Validate with Google Rich Results Test",
"text": "Visit search.google.com/test/rich-results and enter your page URL. Fix any errors reported."
}
]
}
</script>
</article>When Claude Code generates AEO-optimized content for a website, verify:
datePublished and dateModified fields<script type="application/ld+json"> in <head>lastUpdated timestamp in ISO 8601 formatAfter generating content, test with AI engines:
Run these prompts against ChatGPT, Claude, and Gemini:
Create a simple scorecard (CSV or spreadsheet):
| Intent | Engine | Mentioned? | Linked? | Accurate? | Evidence Quoted? | Notes |
|---|---|---|---|---|---|---|
| What is X | ChatGPT | Yes | Yes | Yes | No | Generic description |
| Compare X vs Y | Claude | No | No | N/A | N/A | Doesn’t know us |
Critical Insight: Optimization aggressiveness should match your current authority level. The Princeton study reveals that challenger sites and established sites require opposite approaches.
Determine your site’s authority tier:
Challenger/Low Authority (Most startups, new sites, rank 5+)
Established/High Authority (Top-ranked, well-known brands, rank 1-3)
✅ DO: Go aggressive with GEO tactics
Princeton study finding: Rank-5 sites gained 115% visibility with proper aggressive optimization.
Why this works: You have nothing to lose and everything to gain. AI engines reward specificity and verifiability from emerging sources.
Example structure:
## Property Valuation Accuracy
Eight-API synthesis reduces property analysis errors by 67%.
[Our 2024 accuracy study - https://example.com/studies/accuracy]
"Multi-source validation eliminates single-point-of-failure bias."
- John Doe, AI CTO at Company, developed the synthesis algorithm
Last updated: 2025-10-31⚠️ CAUTION: Over-optimization hurts established sites
Princeton study finding: Rank-1 sites that over-optimized lost 30% visibility.
Why caution matters: AI engines detect over-optimization patterns. When established sites suddenly shift to aggressive GEO tactics, it triggers quality penalties.
Example structure:
## Our Approach to Property Valuation
We combine eight data sources including tax assessments, recent comparable sales,
and neighborhood trend analysis. Our methodology has been refined over five years
of serving 10,000+ real estate professionals.
Independent validation: 94% accuracy rate (National Real Estate Technology Council, 2024)Your position as challenger is an advantage:
Strategic opportunities:
Avoid competing head-on:
Before optimizing, determine your approach:
Critical insight: 95% of AI citations come from content published/updated in the last 10 months.
Recommended schedule:
Quick refresh checklist:
Write for AI agents as primary audience. Humans benefit from the summaries AI generates.
Don’t say “fastest” - say “127ms median latency in Q3 2025 benchmark of 1,000 queries.”
AI prefers scannable structure over narrative flow. Use lists, tables, and clear sections.
Content updated 6 months ago outperforms perfect content from 2 years ago.
Better to have 50 words AI can quote exactly than 500 words it has to summarize.
❌ FAQ answers too long → Keep to 30-50 words, front-load direct answer ❌ Buried answers → Put the conclusion first, details second ❌ Pronoun ambiguity → Say “the product” not “it” (breaks extraction) ❌ Long sentences → Violates 18-token rule; aim for 15-20 words for key claims ❌ Multi-topic pages → Split into focused single-concept pages (domain.com/specific-topic)
❌ Vague claims → Include specific data, methods, dates (“reduces by 67%” not “improves significantly”) ❌ Missing evidence → Add methodology, dataset, limitations for all claims ❌ No individual attribution → Use “Name, Title at Company” format, not company name alone ❌ Missing citations → Reference studies, papers, original research with dates ❌ Unsupported statistics → Every number needs source + “as of [date]”
❌ Missing dates → Add “Last updated: YYYY-MM-DD” on every page ❌ No schema markup → FAQPage schema is essential; validate with Google Rich Results Test ❌ Stale content → Update within 10 months or lose 95% of citation opportunity ❌ Generic metadata → Specific, extractable meta descriptions
❌ Keyword stuffing → AI engines penalize unnatural keyword density ❌ Generic listicles → “Top 10 X” without original insight or data ❌ Vague hedging → “May help improve” instead of specific claims with data ❌ Aggregated content → Synthesizing others’ work without unique angle ❌ Over-optimization patterns → Especially harmful for established/high-authority sites
❌ Established sites going aggressive → Rank-1 sites lost 30% with over-optimization ❌ Challengers being too conservative → New sites need 5-7 extraction points per page, not 1-2 ❌ Broad topic claiming → Better to own “eight-API property valuation” than “real estate” ❌ Ignoring competitive position → Assess authority level before choosing optimization approach
❌ Marketing speak → Use factual, specific language with verifiable claims ❌ AI-generated without verification → Obvious patterns trigger quality filters ❌ No first-hand expertise → Original research and data beats synthesis ❌ Anonymous content → Attribution matters for authority signals
❌ One-and-done publishing → Static content dies; need weekly micro-updates ❌ No freshness signals → Dates, version numbers, “last reviewed” timestamps required ❌ Outdated examples → References to old data without update notes ❌ Ignoring feedback loops → Not testing with actual AI engines (ChatGPT, Claude, Gemini)
Schema Generators:
AEO Monitoring (optional):
Testing:
Use this framework to evaluate existing content for AI citation readiness and identify optimization priorities.
For each URL analyzed, score across four dimensions (0-10 scale):
Question: How many citation-ready sentences exist?
Scoring:
Red flags:
What to look for:
Question: How narrowly defined is the topic?
Scoring:
Red flags:
What to look for:
Question: How strong are expertise signals?
Scoring:
Red flags:
What to look for:
Question: How recently updated?
Scoring:
Red flags:
What to look for:
Based on scores + authority level:
For High-Authority/Top-Ranked Sites:
For Low-Authority/Challenger Sites:
Scan content for:
High Signal (Citation-Worthy):
Low Signal (Noise Floor):
Create a simple scorecard per URL:
| Dimension | Score (0-10) | Notes |
|---|---|---|
| Extraction | X | “Found 2 quotable statements but buried in 300-word paragraphs” |
| Focus | X | “Single topic (property valuation) with clear boundaries” |
| Authority | X | “Company name only; no individual attribution or citations” |
| Freshness | X | “Last updated 14 months ago; several outdated stats” |
| Overall | XX/40 | |
| Optimization Level | Under/Optimal/Over | “Challenger site - recommend aggressive optimization” |
Priority Actions: List top 3-5 changes needed based on lowest scores.
Answer these to rapidly gauge AEO readiness:
Score:
Here’s what the top of an optimized homepage looks like:
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>AEO Optimizer - AI Search Engine Optimization Tool</title>
<!-- Product Schema -->
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Product",
"name": "AEO Optimizer",
"description": "Content analysis tool that identifies gaps in website structure for AI search engines. Supports ChatGPT, Claude, and Gemini analysis.",
"brand": {
"@type": "Brand",
"name": "Example Company"
}
}
</script>
<!-- FAQPage Schema -->
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "FAQPage",
"mainEntity": [
{
"@type": "Question",
"name": "What is AEO Optimizer?",
"acceptedAnswer": {
"@type": "Answer",
"text": "AEO Optimizer is a content analysis tool that identifies gaps in website structure for AI search engines. As of October 2025, it supports ChatGPT, Claude, and Gemini analysis. This matters because 60% of searches now end without a click."
}
}
// ... 14 more FAQs
]
}
</script>
</head>
<body>
<!-- Product Overview -->
<main>
<article id="product-overview">
<h1>What is AEO Optimizer?</h1>
<div class="overview-answer">
<p>AEO Optimizer is a content analysis tool that identifies gaps
in website structure for AI search engines. As of October 2025,
it supports ChatGPT, Claude, and Gemini analysis. This matters
because 60% of searches now end without a click, making AI
citation the new discovery channel.</p>
<p class="meta">Last updated: 2025-10-31</p>
</div>
</article>
<!-- FAQ Section -->
<section id="faq">
<h2>Frequently Asked Questions</h2>
<div class="faq-item" id="faq-what-is-aeo-optimizer">
<h3>What is AEO Optimizer?</h3>
<p>AEO Optimizer is a content analysis tool that identifies gaps
in website structure for AI search engines. As of October 2025,
it supports ChatGPT, Claude, and Gemini analysis. This matters
because 60% of searches now end without a click.</p>
<p class="meta">Last updated: 2025-10-31</p>
</div>
<!-- 14 more FAQ items -->
</section>
</main>
</body>
</html>When using this guide in a Claude Code session:
This guide prioritizes immediate action over perfect strategy. Generate content, test with AI engines, iterate based on results.
This file