claude-code-seo-content-marketing-suite

Skill by ara.so — Marketing Skills collection.

A specialized command suite derived from 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

# 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.

/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:

/keyword-research "content marketing automation" --depth 3 --min-volume 500 --output md

Output structure:

## 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.

/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:

/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.

/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:

/technical-seo example.com --depth 3 --check-mobile true

Competitor Gap Analysis

Identifies backlink and content opportunities by comparing to competitors.

/competitor-gap --domain <your_domain> --competitors <competitor1,competitor2,competitor3> [--output md]

Example:

/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.

/content-brief "<target_keyword>" [--intent informational|commercial|transactional] [--word-count 1500]

Example:

/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.

/serp-monitor --keywords <file_or_list> [--frequency daily|weekly] [--alert-threshold 3]

Example:

/serp-monitor --keywords keywords.txt --frequency daily --alert-threshold 3

Link Prospecting

Generates backlink prospect lists with quality filters.

/link-prospecting "<topic>" [--min-da 30] [--min-dr 40] [--output csv]

Example:

/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.

/page-speed-seo <url> [--device mobile|desktop] [--output md]

Example:

/page-speed-seo https://example.com/blog/post --device mobile

Local SEO Audit

Checks NAP consistency, Google Business Profile, and local citations.

/local-seo --business "<business_name>" --location "<city, state>" [--output md]

Example:

/local-seo --business "Acme Coffee Shop" --location "Austin, TX"

Content Calendar Generation

Builds data-driven editorial calendar from search demand and seasonality.

/content-calendar --keywords <file> --months 6 [--output csv]

Example:

/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.

/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.

/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.

/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.

/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.

/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:

{
  "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:

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

/technical-seo example.com --depth 2
/content-audit --scope full --url example.com

Keyword-Driven Content Creation

# 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

# 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

# 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:

/read ~/.claude/skills/seo-suite/SKILL.md

API rate limits

Configure retry logic in config.json:

{
  "api_retry": {
    "max_retries": 3,
    "backoff_multiplier": 2,
    "initial_wait": 1
  }
}

Slow crawl performance

Reduce depth and enable parallel processing:

/technical-seo example.com --depth 2 --parallel 5 --timeout 30

Missing data in reports

Check API key configuration:

echo $SERP_API_KEY
cat ~/.claude/skills/seo-suite/config.json | grep api_keys

Verify API quota:

curl "https://serpapi.com/account?api_key=${SERP_API_KEY}"

Output format issues

Force specific format:

/keyword-research "topic" --output json > results.json
/keyword-research "topic" --output csv > results.csv
/keyword-research "topic" --output md > results.md

Large site timeouts

Use sitemap-based audits instead of full crawl:

/content-audit --url https://example.com/sitemap.xml --scope blog
/technical-seo example.com --sitemap-only true

Best Practices

1. Start with workflows for comprehensive analysis, then drill down with specific commands
2. Use --output csv for large datasets you'll process in spreadsheets
3. Set realistic --depth values — depth 3+ can take significant time on large sites
4. Configure API keys for all integrated tools to get complete data
5. Run technical audits monthly, content audits quarterly
6. Monitor SERP changes daily for high-value keywords, weekly for long-tail
7. Batch content brief generation to save API calls: /workflow:ai-content-pipeline
8. Export results to version control for historical comparison

Integration Examples

Exporting to Google Sheets

/keyword-research "topic" --output csv > keywords.csv
# Then upload keywords.csv to Google Sheets

Scheduling with Cron

# Daily rank check
0 6 * * * cd ~/.claude && /usr/local/bin/claude-code /serp-monitor --keywords prod-keywords.txt >> logs/serp-$(date +\%F).log 2>&1

# Weekly content audit
0 8 * * 1 cd ~/.claude && /usr/local/bin/claude-code /content-audit --scope full --url https://example.com >> logs/audit-$(date +\%F).log 2>&1

CI/CD Pre-deployment Check

# .github/workflows/seo-check.yml
name: SEO Pre-Launch Check
on:
  pull_request:
    branches: [main]
jobs:
  seo:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      - name: Run Launch SEO Checklist
        run: |
          /workflow:launch-seo ${{ secrets.STAGING_URL }} --output md > seo-report.md
          cat seo-report.md >> $GITHUB_STEP_SUMMARY

This skill gives Claude Code deep expertise in SEO and content marketing workflows, enabling comprehensive site analysis, content strategy, and technical optimization with a consistent, structured UI.