claude-code-seo-content-marketing-suite

# claude-code-seo-content-marketing-suite > Skill by [ara.so](https://ara.so) — Marketing Skills collection. A specialized command suite derived from [anthropics/claude-code](https://github.com/anthropics/claude-code) that provides 10 SEO-focused commands and 5 multi-step workflows for keyword research, content audits, technical SEO analysis, and content strategy. ## What It Does This skill suite extends Claude Code with domain-specific commands for: - **Keyword Research** — clustering, opportunity scoring, SERP intent mapping - **Content Audits** — quality scoring, duplication detection, cannibalization reports - **Technical SEO** — crawl budget, Core Web Vitals, schema markup, indexability - **Competitor Analysis** — backlink gaps, topic gaps, featured snippet opportunities - **Content Strategy** — AI-generated briefs, editorial calendars, refresh workflows - **Local SEO** — NAP consistency, Google Business Profile optimization - **Link Building** — prospect lists with DA/DR filters, outreach templates All commands output structured, prioritized results with visual progress tracking. ## Installation ```bash # Clone into Claude Code skills directory mkdir -p ~/.claude/skills cd ~/.claude/skills git clone https://github.com/PrefectFlourish22/r18-anthropics-claude-code-seo.git seo-suite # Or copy manually cp -r /path/to/r18-anthropics-claude-code-seo ~/.claude/skills/seo-suite/ # Register the skill in Claude Code session /read ~/.claude/skills/seo-suite/SKILL.md ``` ## Core Commands ### Keyword Research Discovers keyword opportunities with clustering and SERP intent analysis. ```bash /keyword-research <seed_keyword> [--depth 2|3|5] [--min-volume 100] [--output json|md|csv] ``` **Options:** - `--depth` — levels of related keywords to explore (default: 2) - `--min-volume` — minimum monthly search volume (default: 100) - `--output` — output format (default: md) - `--country` — target country code (default: US) - `--language` — target language (default: en) **Example:** ```bash /keyword-research "content marketing automation" --depth 3 --min-volume 500 --output md ``` **Output structure:** ```markdown ## Keyword Clusters (4 found) ### 1. Automation Tools (Primary) - content marketing automation [2,400/mo] [KD: 42] 🟢 Low competition - marketing automation content [1,300/mo] [KD: 38] 🟢 Low competition - automated content marketing [880/mo] [KD: 45] 🟡 Medium competition ### 2. Strategy & Planning - content marketing automation strategy [590/mo] [KD: 31] 🟢 Quick win ... ## Top Opportunities (Quick Wins) 1. "content marketing automation strategy" — 590/mo, KD 31, informational intent 2. "best content automation tools" — 720/mo, KD 28, commercial intent ... ## Next Steps - Run `/content-brief "content marketing automation strategy"` to generate outline - Check `/competitor-gap` for backlink opportunities ``` ### Content Audit Analyzes existing content for quality, duplication, and cannibalization issues. ```bash /content-audit [--scope full|blog|landing] [--url <sitemap_url>] [--output md|csv] ``` **Options:** - `--scope` — audit scope (default: full) - `--url` — sitemap URL or domain (required) - `--min-words` — minimum word count threshold (default: 300) - `--check-duplicates` — enable duplicate content detection (default: true) **Example:** ```bash /content-audit --scope blog --url https://example.com/sitemap.xml --output md ``` **Output includes:** - Pages missing meta descriptions, title tags, H1s - Thin content (below word count threshold) - Duplicate/similar content clusters - Keyword cannibalization warnings - Content quality score per page ### Technical SEO Audit Comprehensive technical SEO analysis covering crawlability, performance, and markup. ```bash /technical-seo <domain> [--depth 3] [--check-mobile true] [--output md] ``` **Checks:** - Crawl budget and indexability - Core Web Vitals (LCP, FID, CLS) - Schema markup validation - Mobile-friendliness - Canonical tag issues - XML sitemap health - Robots.txt configuration **Example:** ```bash /technical-seo example.com --depth 3 --check-mobile true ``` ### Competitor Gap Analysis Identifies backlink and content opportunities by comparing to competitors. ```bash /competitor-gap --domain <your_domain> --competitors <competitor1,competitor2,competitor3> [--output md] ``` **Example:** ```bash /competitor-gap --domain mysite.com --competitors competitor1.com,competitor2.com,competitor3.com ``` **Output:** - Backlinks competitors have that you don't - Topics competitors rank for that you don't cover - Featured snippet opportunities - Content gap recommendations ### Content Brief Generation Creates SEO-optimized content briefs with outlines, NLP terms, and targets. ```bash /content-brief "<target_keyword>" [--intent informational|commercial|transactional] [--word-count 1500] ``` **Example:** ```bash /content-brief "email marketing automation guide" --intent informational --word-count 2500 ``` **Output includes:** - Target keyword + LSI/NLP terms - Recommended outline (H2/H3 structure) - Word count target - SERP competitor analysis - Internal linking suggestions - Meta title/description templates ### SERP Monitoring Tracks keyword rankings with volatility alerts and CTR optimization tips. ```bash /serp-monitor --keywords <file_or_list> [--frequency daily|weekly] [--alert-threshold 3] ``` **Example:** ```bash /serp-monitor --keywords keywords.txt --frequency daily --alert-threshold 3 ``` ### Link Prospecting Generates backlink prospect lists with quality filters. ```bash /link-prospecting "<topic>" [--min-da 30] [--min-dr 40] [--output csv] ``` **Example:** ```bash /link-prospecting "content marketing resources" --min-da 40 --min-dr 50 --output csv ``` **Output:** - Prospect domain + contact info - DA/DR scores - Relevance score - Outreach template suggestion ### Page Speed SEO Analysis Diagnoses page speed issues mapped to ranking impact. ```bash /page-speed-seo <url> [--device mobile|desktop] [--output md] ``` **Example:** ```bash /page-speed-seo https://example.com/blog/post --device mobile ``` ### Local SEO Audit Checks NAP consistency, Google Business Profile, and local citations. ```bash /local-seo --business "<business_name>" --location "<city, state>" [--output md] ``` **Example:** ```bash /local-seo --business "Acme Coffee Shop" --location "Austin, TX" ``` ### Content Calendar Generation Builds data-driven editorial calendar from search demand and seasonality. ```bash /content-calendar --keywords <file> --months 6 [--output csv] ``` **Example:** ```bash /content-calendar --keywords seed-keywords.txt --months 6 --output csv ``` ## Workflows Multi-step workflows orchestrate multiple commands for end-to-end processes. ### Full SEO Sprint 12-step comprehensive SEO audit and action plan. ```bash /workflow:full-seo-sprint <domain> --scope full [--output md] ``` **Steps:** 1. Technical SEO audit 2. Content audit 3. Keyword research 4. Competitor gap analysis 5. SERP monitoring setup 6. Content brief generation (top 5 opportunities) 7. Link prospecting 8. Page speed analysis (top pages) 9. Local SEO audit (if applicable) 10. Content calendar creation 11. Priority action plan 12. Timeline and resource allocation ### Launch SEO Checklist Pre-launch SEO validation. ```bash /workflow:launch-seo <staging_url> [--checklist comprehensive] ``` **Validates:** - Canonical tags - Hreflang tags (if multi-language) - XML sitemap - Robots.txt - Meta tags - Schema markup - Mobile-friendliness - Page speed baseline ### Content Refresh Workflow Identifies and updates underperforming content. ```bash /workflow:content-refresh --domain <domain> --min-age 180 --rank-drop 5 ``` **Process:** 1. Identify pages with ranking drops 2. Content quality re-assessment 3. Keyword opportunity check 4. Content gap analysis 5. Refresh recommendations 6. Internal linking updates ### Authority Building Campaign End-to-end link building workflow. ```bash /workflow:authority-building "<topic>" --target-links 50 --timeframe 90 ``` **Steps:** 1. Link prospecting 2. Competitor backlink analysis 3. Content asset creation recommendations 4. Outreach template generation 5. Tracking spreadsheet setup ### AI Content Pipeline Automated keyword → publish workflow. ```bash /workflow:ai-content-pipeline --keywords <file> --batch-size 10 [--auto-publish false] ``` **Pipeline:** 1. Keyword prioritization 2. Content brief generation (batch) 3. Draft generation (if enabled) 4. SEO optimization check 5. Internal linking suggestions 6. Publishing schedule ## Configuration Create a config file at `~/.claude/skills/seo-suite/config.json`: ```json { "api_keys": { "serp_api": "${SERP_API_KEY}", "ahrefs": "${AHREFS_API_KEY}", "semrush": "${SEMRUSH_API_KEY}", "moz": "${MOZ_API_KEY}" }, "defaults": { "country": "US", "language": "en", "min_volume": 100, "min_da": 30, "crawl_depth": 3, "user_agent": "SEOBot/1.0" }, "output": { "format": "md", "progress_bars": true, "severity_colors": true }, "integrations": { "google_search_console": "${GSC_CREDENTIALS_PATH}", "google_analytics": "${GA_CREDENTIALS_PATH}", "screaming_frog": { "enabled": false, "path": "/Applications/Screaming Frog SEO Spider.app" } } } ``` **Environment variables:** ```bash export SERP_API_KEY="your_serpapi_key" export AHREFS_API_KEY="your_ahrefs_key" export SEMRUSH_API_KEY="your_semrush_key" export MOZ_API_KEY="your_moz_key" export GSC_CREDENTIALS_PATH="~/.config/gsc-credentials.json" export GA_CREDENTIALS_PATH="~/.config/ga-credentials.json" ``` ## Common Patterns ### Quick Site Health Check ```bash /technical-seo example.com --depth 2 /content-audit --scope full --url example.com ``` ### Keyword-Driven Content Creation ```bash # 1. Research /keyword-research "topic" --depth 3 --min-volume 500 # 2. Generate brief /content-brief "chosen keyword" --intent informational # 3. Check competition /competitor-gap --domain mysite.com --competitors competitor.com # 4. Add to calendar /content-calendar --keywords keywords.txt --months 3 ``` ### Recovery from Rankings Drop ```bash # 1. Identify affected pages /serp-monitor --keywords affected-keywords.txt --alert-threshold 5 # 2. Technical check /technical-seo example.com/affected-page # 3. Content refresh /workflow:content-refresh --domain example.com --rank-drop 5 # 4. Link analysis /competitor-gap --domain example.com --competitors ranking-competitor.com ``` ### Local Business SEO Setup ```bash # 1. Baseline audit /local-seo --business "Business Name" --location "City, State" # 2. Citation building /link-prospecting "city + industry" --min-da 20 --local true # 3. Content strategy /keyword-research "industry + city" --depth 2 /content-calendar --keywords local-keywords.txt --months 6 ``` ## Troubleshooting ### Command not found Ensure skill is loaded: ```bash /read ~/.claude/skills/seo-suite/SKILL.md ``` ### API rate limits Configure retry logic in `config.json`: ```json {