Seo Content Marketing Claude Code Skill Suite

📈 SEO & Content Marketing Skills Suite

Skill by ara.so — Marketing Skills collection.

This skill suite extends Claude Code with 10 specialized SEO and content marketing commands and 5 multi-step workflows for comprehensive search optimization and content strategy. Built on the anthropics/claude-code framework, it provides structured, actionable SEO analysis with visual progress tracking and prioritized recommendations.

What This Project Does

The SEO & Content Marketing Skills Suite automates:

• Keyword research with clustering, intent mapping and opportunity scoring
• Content audits detecting duplication, cannibalization and quality gaps
• Technical SEO analysis (crawl budget, Core Web Vitals, schema, indexability)
• Competitor analysis for backlink gaps, topic gaps and SERP features
• Content optimization with AI-generated briefs, outlines and NLP term extraction
• Rank tracking with volatility alerts and CTR optimization
• Link prospecting filtered by authority metrics
• Local SEO audits for NAP consistency and GBP optimization

All commands return structured output with progress bars, findings tables, action checklists and next-step suggestions.

Installation

Clone the Skill Suite

# Navigate to Claude Code skills directorycd ~/.claude/skills/
# Clone this repositorygit clone https://github.com/PrefectFlourish22/r18-anthropics-claude-code-seo.git seo-content-marketing/
# Or manually copycp -r /path/to/r18-anthropics-claude-code-seo ~/.claude/skills/seo-content-marketing/

Register with Claude Code

In a Claude Code session:

/read ~/.claude/skills/seo-content-marketing/SKILL.md

Or add to your ~/.claude/config.yml:

skills:  - path: ~/.claude/skills/seo-content-marketing    enabled: true

Core Commands

1. Keyword Research

Deep keyword clustering with intent mapping and opportunity scoring.

/keyword-research "saas marketing automation"

Options:

/keyword-research <seed_keyword> \  --volume-min 100 \  --difficulty-max 60 \  --output json

Output Structure:

┌─────────────────────────┬────────┬────────┬──────────┬─────────┐│ Keyword                 │ Volume │ Diff   │ Intent   │ Opportunity │├─────────────────────────┼────────┼────────┼──────────┼─────────┤│ marketing automation    │ 12 100 │   58   │ Info     │   8.2   ││ email automation tools  │  4 800 │   42   │ Comm     │   9.1   ││ best crm for startups   │  2 900 │   51   │ Comm     │   7.8   │└─────────────────────────┴────────┴────────┴──────────┴─────────┘

2. Content Audit

Full-site content quality scoring with duplication and cannibalization detection.

/content-audit https://example.com --scope full

Flags:

• --scope full|sample — crawl entire site or sample 100 pages
• --output md|json|csv — export format
• --check-duplicates — include content similarity matrix

Example Output:

Content Quality Distribution:  🟢 Excellent (80-100): 23 pages (15%)  🟡 Good (60-79):       67 pages (44%)  🟠 Fair (40-59):       48 pages (32%)  🔴 Poor (0-39):        14 pages (9%)
Cannibalization Issues:  "seo tools" — 4 pages competing (consolidate recommended)  "link building" — 3 pages competing

3. Technical SEO Audit

Comprehensive technical SEO check covering crawlability, indexability, Core Web Vitals and schema.

/technical-seo https://example.com

Configuration:

Create .seo-config.json in project root:

{  "crawl_depth": 5,  "user_agent": "SEO-Audit-Bot/1.0",  "check_vitals": true,  "lighthouse_categories": ["performance", "seo", "accessibility"],  "schema_validation": true}

Output:

Technical SEO Score: 78/100
Critical Issues (🔴):  - 47 pages blocked by robots.txt  - 12 pages with 4xx status  - Missing XML sitemap
Warnings (🟠):  - 203 pages missing meta descriptions  - 89 pages with slow LCP (>2.5s)
Passed (🟢):  - HTTPS enabled  - Mobile-friendly  - Structured data present

4. Competitor Gap Analysis

Identify backlink gaps, topic gaps and featured snippet opportunities.

/competitor-gap \  --target https://yoursite.com \  --competitors https://competitor1.com,https://competitor2.com

Example Usage:

/competitor-gap \  --target $YOUR_DOMAIN \  --competitors $COMPETITOR_DOMAINS \  --backlink-min-dr 40 \  --output md

Output:

Backlink Gap Analysis:  Competitor 1 has 847 linking domains you don't  Top opportunities:    - industry-blog.com (DR: 72, relevant: yes)    - tech-news-site.com (DR: 68, relevant: yes)
Topic Gap:  Missing content on:    - "automation workflow examples" (competitor ranks #3, vol: 1.2k)    - "crm integration guide" (competitor ranks #5, vol: 890)

5. Content Brief Generation

AI-generated SEO content brief with outline, NLP terms and word count targets.

/content-brief "best project management tools for remote teams"

Output Structure:

# Content Brief: Best Project Management Tools for Remote Teams
Target Keyword: best project management tools for remote teamsSearch Volume: 3,200/moKeyword Difficulty: 54Intent: Commercial Investigation
## Recommended Word Count2,800-3,200 words (competitor avg: 2,950)
## Outline1. Introduction (200 words)2. Top 10 Project Management Tools (1,800 words)   - Tool comparison table   - Feature breakdown3. Selection Criteria (400 words)4. Implementation Tips (300 words)5. FAQ (300 words)
## NLP Terms to Include- asynchronous collaboration- task dependencies- gantt charts- time tracking- integrations- mobile app- free tier
## Competitors to Beat1. monday.com/blog/... (3,100 words, DA: 82)2. asana.com/resources/... (2,600 words, DA: 88)

6. SERP Monitoring

Daily rank tracking with volatility alerts and CTR optimization.

/serp-monitor \  --keywords keywords.csv \  --location "United States" \  --device desktop

keywords.csv format:

keyword,target_url"saas analytics",https://example.com/analytics"product metrics",https://example.com/metrics

Environment Variables:

export SERP_API_KEY=your_serp_api_keyexport SERP_CHECK_FREQUENCY=dailyexport SERP_ALERT_THRESHOLD=5  # positions

7. Link Prospecting

Quality backlink prospect discovery with authority filters.

/link-prospecting \  --topic "content marketing" \  --min-dr 30 \  --max-results 50 \  --export prospects.csv

Output:

50 Link Prospects Found
Top Prospects:┌────────────────────────┬─────┬─────┬──────────────┐│ Domain                 │ DR  │ Rel │ Contact      │├────────────────────────┼─────┼─────┼──────────────┤│ marketing-blog.com     │  68 │ High│ editor@...   ││ industry-news.com      │  72 │ Med │ submissions@...││ podcast-host.com       │  54 │ High│ guest@...    │└────────────────────────┴─────┴─────┴──────────────┘
Outreach template saved to: outreach-template.md

8. Page Speed SEO Analysis

Render-blocking resource detection with ranking impact mapping.

/page-speed-seo https://example.com/page

Output:

Performance Score: 67/100SEO Impact: Medium (🟠)
Core Web Vitals:  LCP: 3.2s (🟠 Needs Improvement)  FID: 85ms (🟢 Good)  CLS: 0.08 (🟢 Good)
Ranking Impact Analysis:  - Slow LCP may reduce mobile rankings by ~5-10 positions  - Above-fold content delayed by 1.2s
Fixes (prioritized):  1. Defer non-critical CSS (impact: -1.1s LCP)  2. Optimize hero image (impact: -0.7s LCP)  3. Remove unused JavaScript (impact: -0.3s LCP)

9. Local SEO Audit

NAP consistency check, Google Business Profile optimization and citation audit.

/local-seo \  --business-name "Acme Coffee Shop" \  --location "San Francisco, CA"

Configuration in .seo-config.json:

{  "local_seo": {    "business_name": "Acme Coffee Shop",    "address": "123 Main St, San Francisco, CA 94102",    "phone": "+1-415-555-0123",    "citation_sources": [      "yelp.com",      "yellowpages.com",      "foursquare.com"    ]  }}

10. Content Calendar Generation

Data-driven editorial calendar from search demand and seasonality.

/content-calendar \  --topics topics.txt \  --months 3 \  --output calendar.csv

topics.txt:

email marketingsocial media strategyseo best practicescontent creation

Output (calendar.csv):

week,topic,keyword,volume,trend,priority2026-W20,"Email Marketing Automation","email automation tools",4800,rising,high2026-W21,"Social Media Calendar","social media content calendar",2100,stable,medium2026-W22,"SEO for Beginners","seo basics tutorial",3400,rising,high

Multi-Step Workflows

Full SEO Sprint

12-step comprehensive SEO process:

/workflows:full-seo-sprint https://example.com --scope full

Steps:

1. Technical audit
2. Content audit
3. Keyword research
4. Competitor analysis
5. Content gap identification
6. Link profile analysis
7. On-page optimization recommendations
8. Content brief generation
9. Internal linking suggestions
10. Schema markup recommendations
11. Priority action plan
12. Implementation roadmap

Launch SEO

Pre-launch SEO validation:

/workflows:launch-seo https://staging.example.com

Checklist:

• ✓ Canonical tags configured
• ✓ Hreflang tags (if multi-language)
• ✓ XML sitemap generated and submitted
• ✓ Robots.txt configured
• ✓ 404 page created
• ✓ Redirects mapped
• ✓ Google Search Console verified
• ✓ Google Analytics installed
• ✓ Core Web Vitals passing
• ✓ Mobile-friendly test passed

Content Refresh

Identify and refresh underperforming content:

/workflows:content-refresh --min-rank 11 --max-rank 30

Process:

1. Find pages ranking positions 11-30
2. Analyze SERP competition
3. Identify content gaps
4. Generate refresh brief
5. Create optimization checklist
6. Schedule re-publication

Authority Building

End-to-end link building campaign:

/workflows:authority-building \  --topic "saas analytics" \  --duration 90days \  --target-links 20

Stages:

1. Link prospect research
2. Contact discovery
3. Outreach template generation
4. Personalization guide
5. Follow-up sequence
6. Tracking spreadsheet creation
7. Progress monitoring

AI Content Pipeline

Keyword → brief → draft → optimize → publish:

/workflows:ai-content-pipeline \  --keywords keywords.csv \  --auto-draft true \  --review-required true

Environment Variables:

export OPENAI_API_KEY=your_openai_keyexport CONTENT_OUTPUT_DIR=./content/draftsexport REVIEW_WEBHOOK_URL=https://your-cms.com/review

Common Patterns

Batch Keyword Research

# Process multiple seed keywordscat seeds.txt | while read keyword; do  /keyword-research "$keyword" --output json >> results.jsonldone

Scheduled SERP Monitoring

# Add to crontab for daily checks0 9 * * * cd /path/to/project && /claude-code /serp-monitor --keywords keywords.csv --alert-email $ALERT_EMAIL

Content Audit with Export

# Full audit with CSV export for spreadsheet analysis/content-audit https://example.com \  --scope full \  --output csv \  --export-path ./audit-results.csv

Competitor Tracking Loop

# Monitor competitor changes weekly/competitor-gap \  --target $YOUR_DOMAIN \  --competitors $COMPETITORS \  --diff-since 7d \  --notify slack

Configuration Reference

Global Config (~/.claude/skills/seo-content-marketing/config.yml)

seo_tools:  serp_api: serpapi  # serpapi, brightdata, custom  backlink_api: ahrefs  # ahrefs, semrush, moz  lighthouse_api: pagespeed_insights
defaults:  crawl_delay: 1.0  # seconds  max_concurrent: 5  user_agent: "SEO-Audit-Bot/1.0 (+https://example.com/bot)"  respect_robots_txt: true
output:  default_format: md  # md, json, csv  progress_bars: true  color: true
notifications:  slack_webhook: ${SLACK_WEBHOOK_URL}  email_alerts: ${ALERT_EMAIL}  alert_on: [critical, warnings]

Project Config (.seo-config.json)

{  "target_domain": "https://example.com",  "competitors": [    "https://competitor1.com",    "https://competitor2.com"  ],  "keyword_targets": {    "primary": ["saas analytics", "product metrics"],    "secondary": ["user tracking", "dashboard software"]  },  "technical_seo": {    "crawl_depth": 5,    "check_vitals": true,    "lighthouse_threshold": 80  },  "content_audit": {    "min_word_count": 800,    "check_duplicates": true,    "quality_threshold": 60  }}

Troubleshooting

"API rate limit exceeded"

Most SERP/backlink APIs have rate limits. Configure delays:

# config.ymlseo_tools:  rate_limit_delay: 2.0  # seconds between requests

Or use environment variable:

export SEO_API_DELAY=2.0

"Crawl blocked by robots.txt"

Check your user agent configuration:

defaults:  respect_robots_txt: false  # Use carefully, only for owned sites

Or verify robots.txt allows your bot:

User-agent: SEO-Audit-BotAllow: /

"Lighthouse timeout"

Increase timeout for slow pages:

{  "technical_seo": {    "lighthouse_timeout": 60000  }}

"Missing API credentials"

Set required environment variables:

export SERP_API_KEY=your_keyexport AHREFS_API_KEY=your_keyexport OPENAI_API_KEY=your_key

Check which APIs are needed:

/check-config --show-required-keys

"Content audit incomplete"

Large sites may timeout. Use sampling:

/content-audit https://example.com --scope sample --max-pages 100

Or increase crawl timeout:

{  "content_audit": {    "timeout": 300,    "max_pages": 1000  }}

Code Examples

Custom Keyword Filter Script

# filter_keywords.pyimport jsonimport sys
min_volume = int(sys.argv[1])max_difficulty = int(sys.argv[2])
for line in sys.stdin:    kw = json.loads(line)    if kw['volume'] >= min_volume and kw['difficulty'] <= max_difficulty:        print(json.dumps(kw))

Usage:

/keyword-research "saas tools" --output jsonl | python filter_keywords.py 500 50

Automated Content Brief Generation

#!/bin/bash# generate_briefs.sh
KEYWORDS_FILE=$1
while IFS= read -r keyword; do  echo "Generating brief for: $keyword"  /content-brief "$keyword" --output md > "briefs/${keyword// /_}.md"  sleep 2done < "$KEYWORDS_FILE"

Integration with CI/CD

# .github/workflows/seo-check.ymlname: SEO Checkon:  pull_request:    paths:      - 'content/**'
jobs:  seo-audit:    runs-on: ubuntu-latest    steps:      - uses: actions/checkout@v3      - name: Run SEO Audit        env:          SERP_API_KEY: ${{ secrets.SERP_API_KEY }}        run: |          /technical-seo https://preview.example.com \            --output json > seo-report.json      - name: Comment PR        uses: actions/github-script@v6        with:          script: |            const report = require('./seo-report.json');            github.rest.issues.createComment({              issue_number: context.issue.number,              body: `SEO Score: ${report.score}/100`            });

API Reference

Command-Line Interface

All commands follow this pattern:

/<command> <target> [options]

Global Options:

• --output <format> — md, json, csv, jsonl
• --export-path <path> — save results to file
• --config <path> — use custom config file
• --verbose — detailed logging
• --quiet — minimal output
• --no-progress — disable progress bars

Programmatic Usage

If extending with custom scripts:

// node exampleconst { runCommand } = require('@claude-skills/seo-marketing');
const results = await runCommand('keyword-research', {  seed: 'content marketing',  volumeMin: 1000,  difficultyMax: 50});
console.log(results.keywords);

# python examplefrom claude_skills.seo_marketing import SEOAudit
audit = SEOAudit(    target='https://example.com',    config_path='.seo-config.json')
results = audit.run_technical_audit()print(results.critical_issues)

Best Practices

1. Always set realistic crawl delays to avoid overwhelming target servers
2. Use environment variables for API keys, never commit them
3. Start with sample audits on large sites before running full crawls
4. Export results to CSV/JSON for further analysis in spreadsheets
5. Schedule SERP monitoring via cron for consistent tracking
6. Combine commands in workflows for comprehensive analysis
7. Review generated briefs before content creation — AI is a starting point
8. Track changes over time by keeping historical exports

Additional Resources

• Project Repository: https://github.com/PrefectFlourish22/r18-anthropics-claude-code-seo
• Claude Code Documentation: https://github.com/anthropics/claude-code
• SEO Best Practices: https://developers.google.com/search/docs
• Core Web Vitals Guide: https://web.dev/vitals/

License: MIT
Maintained by: PrefectFlourish22
Based on: anthropics/claude-code