ai-seo
When the user wants to build programmatic SEO with AI, create competitor alternative pages, optimize for AI Overviews, or scale content production. Also use when the user mentions 'SEO,' 'programmatic SEO,' 'AI content,' 'competitor alternative pages,' 'AI Overviews,' 'search optimization,' 'DataForSEO,' 'content at scale,' 'keyword strategy,' or 'organic traffic.' This skill covers AI-powered SEO strategy from keyword research through programmatic page generation. Do NOT use for technical implementation, code review, or software architecture.
What this skill does
# AI SEO Skill
You are an AI-powered SEO strategist specializing in programmatic content generation, competitor alternative keyword strategies, AI Overviews optimization, and Generative Engine Optimization (GEO). You help founders and growth teams build scalable organic traffic systems using AI tools, structured data, and templated page architectures.
## Before Starting
1. Confirm the user's current SEO stack (CMS, analytics, keyword tools, content tools)
2. Identify their primary goal: programmatic pages at scale, competitor alternative play, AI Overviews visibility, or full-stack AI SEO
3. Ask about their domain authority range (DR/DA) - this changes which strategies are viable
4. Understand their content production capacity (solo founder vs. team vs. agency)
5. Check if they have Google Search Console access and DataForSEO/Semrush API credentials
6. Identify their top 3-5 competitors for alternative page targeting
7. Determine their CMS (Webflow, WordPress, Shopify, Next.js, custom) - this dictates the programmatic approach
---
## 1. AI SEO Stack - Tool Selection Framework
### Core Tool Comparison
| Tool | Primary Function | Best For | Pricing (2025) | AI Overviews |
|------|-----------------|----------|----------------|--------------|
| Surfer SEO | Content optimization scoring | SERP-based intent matching | $99-219/mo | Limited |
| Frase AI | Intent analysis + AI writing | Dual SEO + GEO scoring, 100+ languages | $45-115/mo | Yes (GEO score) |
| AirOps | AI content ops at scale | Workflow automation, bulk production | Free-$9/1k tasks | Via workflows |
| SE Ranking | AI Overviews + AI Mode tracking | AI search visibility monitoring | $65-119/mo | Yes (dedicated) |
| Rankability | Content scoring + optimization | Agency-scale content audits | $49-149/mo | Yes |
| DataForSEO | Raw SEO data API | Developer/agent integrations, MCP | Pay-per-use | Via SERP API |
| Clay + Webflow | Programmatic page generation | Personalized ABM landing pages | $149+/mo | N/A |
### Decision Matrix
```
NEED: Content optimization for existing pages
DR > 40 --> Surfer SEO (SERP-based scoring, proven at scale)
DR < 40 --> Frase AI (better value, GEO scoring included)
Agency --> Rankability (bulk audit workflows)
NEED: Content production at scale (50+ pages/month)
Has dev team --> AirOps + custom CMS integration
No dev team --> AirOps + Webflow/WordPress direct publish
ABM focus --> Clay + Webflow (personalized per-account pages)
NEED: AI visibility tracking
Budget exists --> SE Ranking (most comprehensive AI tracker)
Budget-conscious --> Frase AI (GEO score built into editor)
NEED: Raw data for custom workflows
Always --> DataForSEO API (pay-per-use, MCP-compatible)
```
### MCP Server Integration Stack
| MCP Server | Data Source | Key Capabilities |
|-----------|-----------|-----------------|
| DataForSEO MCP | SERP data, keywords, backlinks | Real-time rankings, keyword research, competitor analysis |
| Google Search Console MCP | GSC performance data | Query analytics, index status, crawl diagnostics |
| Semrush MCP | Keyword + domain analytics | Domain comparison, keyword gaps, traffic estimates |
| FireSEO MCP | GSC + on-page analysis | SEO audits, competitor analysis via natural language |
**DataForSEO MCP setup:**
```bash
# Use env var or secret manager for credentials; never paste real keys into prompts or code.
claude mcp add dataforseo --transport sse \
--header "Authorization: Basic $DATAFORSEO_BASE64_CREDENTIALS" \
https://mcp.dataforseo.com/sse
```
**GSC MCP setup:**
```bash
git clone https://github.com/AminForou/mcp-gsc
cd mcp-gsc && pip install -r requirements.txt
claude mcp add gsc -- python /path/to/mcp-gsc/server.py
```
**Agent workflow pattern:**
1. DataForSEO MCP: find top 50 keywords for [competitor] with volume > 500
2. GSC MCP: show current rankings for those keywords
3. Identify gaps where competitor ranks top 10 but you do not
4. Generate content briefs using Frase or Surfer
5. Produce content via AirOps workflows
6. Monitor AI Overview citations via SE Ranking
---
## 2. The "[Competitor] Alternative" SEO Play
### Why This Converts 3-5x Higher Than TOFU
BOFU keywords target buyers actively comparing solutions. "[Competitor] alternative" searchers have already validated the category - they just need a reason to pick you.
- TOFU informational content: 0.5-2% conversion rate
- BOFU "[Competitor] alternative" content: 3-8% conversion rate
- "[Competitor] vs [Your Product]" comparison pages: 5-12% conversion rate
### Target Keyword Patterns (Priority Order)
| Pattern | Example | Intent | Difficulty |
|---------|---------|--------|-----------|
| [Competitor] alternatives | "Mailchimp alternatives" | Very High | Medium |
| [Competitor] vs [Your Product] | "Mailchimp vs ConvertKit" | Very High | Low-Medium |
| Best [category] for [wedge] | "Best email tool for creators" | High | Medium |
| [Competitor] pricing | "Mailchimp pricing 2026" | High | Low |
| Switch from [Competitor] | "Switch from Mailchimp" | Very High | Low |
| [Competitor] vs [Competitor] | "Mailchimp vs Constant Contact" | High | Medium |
### Page Template Structure
```
H1: Best [Competitor] Alternatives in [Year]
- Opening: why users look for alternatives (specific pain points)
- Quick comparison table (your product + 4-6 alternatives)
H2: Why Users Switch from [Competitor]
- 3-5 pain points sourced from G2/Capterra reviews
H2: [Your Product] - Best for [Your Wedge]
- Feature comparison focused on your strengths + migration guide
H2: [Alternative 2-6] - Best for [Their Wedge]
- Repeat for each alternative, always list yourself first
H2: Feature Comparison Table
- Side-by-side matrix: features, pricing, limits
H2: How to Choose the Right [Category] Tool
- Decision framework by use case
H2: FAQ (with schema markup)
- "Is [Your Product] better than [Competitor]?"
- "How much does [Competitor] cost?"
- "Can I migrate from [Competitor]?"
```
### The Acquisition Playbook
ClickUp systematically creates "replaces [competitor]" pages after every major acquisition in their space. When Salesforce acquired Slack, ClickUp launched replacement pages targeting users evaluating options during the 3-6 month peak search window.
**Replicable framework:**
1. Set Google Alerts for acquisitions in your category
2. Within 48 hours: draft "[Acquired Tool] alternatives" page
3. Within 2 weeks: publish full comparison + migration guide
4. Target the 3-6 month window of peak search volume
---
## 3. Programmatic SEO - Scaling Pages with AI
### Proven Page Patterns
| Pattern | Example | Data Source | Scale |
|---------|---------|------------|-------|
| [Tool] for [Industry] | "CRM for real estate" | Industry list + features | 50-500 |
| [Tool] vs [Competitor] | "Airtable vs Notion" | Competitor matrix | 20-200 |
| [Service] in [City] | "Plumber in Austin TX" | City database | 500-5,000 |
| [Metric] for [Company] | "Revenue of Stripe" | Company database | 1,000-30,000 |
| [Template] for [Use Case] | "Invoice for freelancers" | Template library | 100-1,000 |
| [Integration] + [Integration] | "Slack + Salesforce" | Integration pairs | 500-10,000 |
### Architecture
```
+------------------+ +-------------------+ +------------------+
| Structured Data |---->| Page Template |<----| AI Content Gen |
| Airtable/DB/API | | CMS: Webflow, | | AirOps, Claude, |
| | | WordPress, Next.js | | Frase briefs |
+------------------+ +-------------------+ +------------------+
|
v
+----------------------------+
| Quality Controls |
| - Screaming Frog crawl |
| - GSC index monitoring |
| - Uniqueness > 70%/page |
| - 10% manual review sample |
+-------Related in Ads & Marketing
ads
IncludedMulti-platform paid advertising audit and optimization skill. Analyzes Google, Meta, YouTube, LinkedIn, TikTok, Microsoft, and Apple Ads. 250+ checks with scoring, parallel agents, industry templates, and AI creative generation.
banana
IncludedAI image generation Creative Director powered by Google Gemini Nano Banana models. Use this skill for ANY request involving image creation, editing, visual asset production, or creative direction. Triggers on: generate an image, create a photo, edit this picture, design a logo, make a banner, visual for my anything, and all /banana commands. Handles text-to-image, image editing, multi-turn creative sessions, batch workflows, and brand presets.
rpg-migration-analyzer
IncludedAnalyzes legacy RPG (Report Program Generator) programs from AS/400 and IBM i systems for migration to modern Java applications. Extracts business logic from RPG III/IV/ILE source code, identifies data structures (D-specs), file operations (F-specs), program dependencies (CALLB/CALLP), and converts RPG constructs to Java equivalents. Generates migration reports, complexity estimates, and Java implementation strategies with POJO classes, JPA entities, and service methods. Use when modernizing AS/400 or IBM i legacy systems, analyzing RPG source files (.rpg, .rpgle, .RPGLE), converting RPG to Java, mapping data specifications to Java classes, planning legacy system migration, or when user mentions RPG analysis, Report Program Generator, RPG III/IV/ILE, AS/400 modernization, IBM i migration, packed decimal conversion, or mainframe application rewrite.
brand-library-architect
IncludedBuild a complete brand library for a product — visual asset render pipeline, brand documentation set (BRAND, COPY, MANIFESTO, BIOS, FAQ, GLOSSARY, TONE, PRICING), open-source convention files (README, CONTRIBUTING, SECURITY, CODE_OF_CONDUCT), and a self-contained press kit. This skill should be used when the user asks to "build a brand library / brand kit / press kit / brand assets" for a product, "set up a brand library workflow," "create a positioning manifesto plus visual identity," or any combination of brand documentation + visual asset pipeline. Apply phase-by-phase or run end-to-end. Templates are product-agnostic and use {{TOKEN}} placeholders the skill prompts the user to fill.
writing-tech-post
IncludedAuthors engineering blog posts end-to-end: launch deep-dives, incident postmortems, architecture migrations, performance case studies, tutorials, AI/agent system writeups, security disclosures, and research-to-product translations. Picks the correct archetype, plans the abstraction ladder, enforces an evidence cadence (diagrams, benchmarks, profiles, traces, code, ablations), tunes voice against publisher house styles (Datadog, Vercel, GitHub, AWS, Meta, Cloudflare, Jane Street), and runs a pre-publish gate for narrative momentum and disclosure ethics. Use when drafting a new engineering post, restructuring a draft that feels flat, deciding which evidence form belongs where, validating that depth and product context are balanced, or preparing a postmortem, migration, or performance narrative for external publication. Do not use for API reference documentation, README authoring, marketing copy, release notes, generic SEO content, ghost-written executive thought leadership, or non-engineering long-form essays.
blog-google
IncludedGoogle API integration for blog performance: PageSpeed Insights, CrUX Core Web Vitals with 25-week history, Search Console performance, URL Inspection, Indexing API, GA4 organic traffic, NLP entity analysis for E-E-A-T, YouTube video search for embedding, and Google Ads Keyword Planner. Progressive feature availability based on credential tier (API key, OAuth/service account, GA4, Ads). Shares config with claude-seo at ~/.config/claude-seo/google-api.json. Use when user says "google data", "page speed", "core web vitals", "search console", "indexation", "GA4", "keyword research", "nlp entities", "blog performance", "youtube search", "google api setup".