AEO/SEO Audit Playbook
Run a full SEO audit, generate comparison pages for keyword gaps, and build social distribution — all from prompts.
Why this playbook
Most SEO audits produce a spreadsheet of issues. This playbook produces a spreadsheet of issues AND the content that fixes them. The audit identifies keyword gaps, the comparison writer generates pages targeting those gaps, and the social pack creates distribution for your new pages.
Designed for content teams running monthly SEO sprints. The three prompts chain together — each step's output feeds the next — so you go from 'what's broken' to 'here's the fix, published and promoted' in a single session.
Works for any site, not just AGNT. The prompts are generic enough to audit an e-commerce store, a SaaS landing page, or a content hub.
Prerequisites
- Claude Code with web browsing or crawl capability
- Target site URL (your own site or a client's)
- Google Search Console access for validation (recommended, not required)
- Basic understanding of SEO concepts (title tags, meta descriptions, keyword density)
Input requirements
| Input | Type | Required | Description |
|---|---|---|---|
| Target site URL | URL | Yes | The site to audit. Can be a full domain (crawls all pages) or a specific section (e.g., /blog/). |
| Competitor URLs | URL[] | No | 1-3 competitor sites for keyword gap analysis. The audit compares your coverage against theirs. |
| Google Search Console export | CSV | No | Performance report CSV from GSC (last 3 months). Enables CTR analysis and impression-weighted keyword prioritization. |
Step-by-step workflow
Crawl and audit the target site
Open promptThis prompt crawls your site and produces a structured audit: technical issues (broken links, missing meta, slow pages), content gaps (keywords competitors rank for but you don't), and opportunities (high-impression, low-CTR pages to optimize).
If you provide a GSC export, the audit weights recommendations by real traffic data instead of guessing. Without GSC, it falls back to competitor analysis and content-gap heuristics.
Generate comparison pages for keyword gaps
Open promptFeed the keyword gaps from step 1 into this prompt. It generates full comparison pages in AGNT's format: a neutral, structured comparison with feature tables, 'when to pick A/B' sections, and a verdict.
Each page targets a specific keyword gap identified in the audit. The prompt enforces editorial quality — no strawman comparisons, no unsourced claims, every assertion backed by a specific feature or metric.
Build social distribution for new pages
Open promptThe final step takes your new comparison pages and generates platform-optimized social posts: X threads, LinkedIn posts, Reddit comments, and Hacker News submissions.
Each post links back to a specific comparison page, creating a distribution flywheel: social posts drive traffic, traffic signals improve ranking, better ranking drives organic traffic.
Expected outputs
SEO audit report
Structured audit with technical issues, content gaps, keyword opportunities, and prioritized recommendations.
Produced by step 1Comparison pages
2-5 production-ready comparison pages targeting identified keyword gaps, with feature tables and verdicts.
Produced by step 2Social distribution pack
Platform-optimized social posts (X, LinkedIn, Reddit, HN) for each new comparison page, ready to copy-paste.
Produced by step 3Tool requirements
- Claude Code with web access
- Google Search Console access (recommended)
- Target site URL
Troubleshooting
Crawl stops at login wall or CAPTCHA
Comparison writer generates biased content
Social posts exceed platform character limits
Audit finds hundreds of issues — where to start
Share as social post
AEO/SEO Audit Playbook 3 steps, 90-120 minutes. Run a full SEO audit, generate comparison pages for keyword gaps, and build social distribution — all from prompts. https://agntdot.com/playbooks/seo-audit-playbook
214 / 280 chars