MCPInstall

seo-content-marketing-claude-code-skill-suite

SEO & content marketing command suite for keyword research, content audits, SERP analysis, technical SEO and content strategy automation

Installs
947
Last 24h
—
Trending rank
—
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/reason-machines/marketing-skills --skill seo-content-marketing-claude-code-skill-suite
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads seo-content-marketing-claude-code-skill-suite automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

📈 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 directory
cd ~/.claude/skills/

# Clone this repository
git clone https://github.com/PrefectFlourish22/r18-anthropics-claude-code-seo.git seo-content-marketing/

# Or manually copy
cp -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 teams
Search Volume: 3,200/mo
Keyword Difficulty: 54
Intent: Commercial Investigation

## Recommended Word Count
2,800-3,200 words (competitor avg: 2,950)

## Outline
1. Introduction (200 words)
2. Top 10 Project Management Tools (1,800 words)
   - Tool comparison table
   - Feature breakdown
3. 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 Beat
1. 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_key
export SERP_CHECK_FREQUENCY=daily
export 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/100
SEO 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 marketing
social media strategy
seo best practices
content creation

Output (calendar.csv):

week,topic,keyword,volume,trend,priority
2026-W20,"Email Marketing Automation","email automation tools",4800,rising,high
2026-W21,"Social Media Calendar","social media content calendar",2100,stable,medium
2026-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_key
export CONTENT_OUTPUT_DIR=./content/drafts
export REVIEW_WEBHOOK_URL=https://your-cms.com/review

Common Patterns

Batch Keyword Research

# Process multiple seed keywords
cat seeds.txt | while read keyword; do
  /keyword-research "$keyword" --output json >> results.jsonl
done

Scheduled SERP Monitoring

# Add to crontab for daily checks
0 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.yml
seo_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-Bot
Allow: /

"Lighthouse timeout"

Increase timeout for slow pages:

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

"Missing API credentials"

Set required environment variables:

export SERP_API_KEY=your_key
export AHREFS_API_KEY=your_key
export 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.py
import json
import 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 2
done < "$KEYWORDS_FILE"

Integration with CI/CD

# .github/workflows/seo-check.yml
name: SEO Check
on:
  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 example
const { runCommand } = require('@claude-skills/seo-marketing');

const results = await runCommand('keyword-research', {
  seed: 'content marketing',
  volumeMin: 1000,
  difficultyMax: 50
});

console.log(results.keywords);
# python example
from 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


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

FAQ

What does the seo-content-marketing-claude-code-skill-suite skill do?

SEO & content marketing command suite for keyword research, content audits, SERP analysis, technical SEO and content strategy automation

How do I install seo-content-marketing-claude-code-skill-suite?

Run npx skills add https://github.com/reason-machines/marketing-skills --skill seo-content-marketing-claude-code-skill-suite in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/seo-content-marketing-claude-code-skill-suite/ (personal) or .claude/skills/seo-content-marketing-claude-code-skill-suite/ (project).

Which AI agents can use seo-content-marketing-claude-code-skill-suite?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is seo-content-marketing-claude-code-skill-suite safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains seo-content-marketing-claude-code-skill-suite?

It is published by reason-machines in reason-machines/marketing-skills. It has 947 recorded installs.

More from reason-machines/marketing-skills

View all →

marketing-for-founders-saas-growth

reason-machines/marketing-skills

Access curated marketing strategies and channels to acquire the first 10/100/1000 users for SaaS products and startups

Marketing & SEO1.1K installs

agentkits-marketing-automation

reason-machines/marketing-skills

Enterprise AI marketing automation toolkit with 18 agents, 93 commands, and 28 skills for campaign planning, content creation, SEO, CRO, and growth workflows

Marketing & SEO1K installs

SEO & content marketing skill suite with keyword research, content audits, technical SEO, competitor analysis, and AI-powered content workflows

Marketing & SEO1K installs

ai-marketing-skills-automation

reason-machines/marketing-skills

Open-source AI marketing automation skills for growth experiments, sales pipeline, content ops, outbound, SEO, and finance automation

Marketing & SEO1K installs

marketingskills-ai-agent-collection

reason-machines/marketing-skills

Marketing skills collection for AI agents - CRO, copywriting, SEO, analytics, and growth engineering

AI & Agents1K installs

ai-marketing-claude-suite

reason-machines/marketing-skills

Comprehensive AI marketing automation suite for Claude Code with 15 skills including website audits, copywriting, email sequences, ad campaigns, competitive analysis, and PDF reporting

Marketing & SEO1K installs

Popular marketing & seo skills

View category →

reddit-automation

flowkit-labs/skills

Find Reddit threads where people are genuinely asking for what you offer, then draft short, genuinely helpful replies — disclosing your affiliation honestly and naming your product only when it truly answers the question. Two moves: discovery — scan the right subreddits for real needs (recommendation asks, expressed pain, competitor mentions) and rank the few threads where you can actually help; drafting — write from real experience, respect each community's self-promo rules, and keep a human in the loop to review and post. This markets on Reddit the honest way: contribute value, disclose who you are, never astroturf. Distilled from the playbook behind doany.ai's Reddit agent. Triggers on "find reddit opportunities", "reddit marketing", "reddit automation", "reply on reddit for my product", "reddit community engagement", "reddit lead gen", or any ask to turn Reddit threads into genuine, disclosed marketing replies.

Marketing & SEO1.1M installs

twitter-automation

101-skills/superpowers

Automate Twitter/X with posting, engagement, and user management via inference.sh CLI. Apps: x/post-tweet, x/post-create (with media), x/post-like, x/post-retweet, x/dm-send, x/user-follow. Capabilities: post tweets, schedule content, like posts, retweet, send DMs, follow users, get profiles. Use for: social media automation, content scheduling, engagement bots, audience growth, X API. Triggers: twitter api, x api, tweet automation, post to twitter, twitter bot, social media automation, x automation, tweet scheduler, twitter integration, post tweet, twitter post, x post, send tweet

Marketing & SEO880K installs

twitter-automation

magentosh/superpowers

Automate Twitter/X with posting, engagement, and user management via inference.sh CLI. Apps: x/post-tweet, x/post-create (with media), x/post-like, x/post-retweet, x/dm-send, x/user-follow. Capabilities: post tweets, schedule content, like posts, retweet, send DMs, follow users, get profiles. Use for: social media automation, content scheduling, engagement bots, audience growth, X API. Triggers: twitter api, x api, tweet automation, post to twitter, twitter bot, social media automation, x automation, tweet scheduler, twitter integration, post tweet, twitter post, x post, send tweet

Marketing & SEO771.7K installs

twitter-automation

qu-skills/superpowers

Automate Twitter/X with posting, engagement, and user management via inference.sh CLI. Apps: x/post-tweet, x/post-create (with media), x/post-like, x/post-retweet, x/dm-send, x/user-follow. Capabilities: post tweets, schedule content, like posts, retweet, send DMs, follow users, get profiles. Use for: social media automation, content scheduling, engagement bots, audience growth, X API. Triggers: twitter api, x api, tweet automation, post to twitter, twitter bot, social media automation, x automation, tweet scheduler, twitter integration, post tweet, twitter post, x post, send tweet

Marketing & SEO564.3K installs

product-launch-video

heygen-com/hyperframes

Turn a product or marketing URL, pasted script, or brief into a product launch / promo video — SaaS promos, feature reveals, product demos, app and company launches. Use when the user wants to market, launch, promote, or reveal a product; the default for any commercial URL. Site tours / showcases of a website route here too — the brief carries the show-it-as-is intent. Unclear → /hyperframes.

Marketing & SEO538.7K installs

twitter-automation

skills-shell/superpowers

Automate Twitter/X with posting, engagement, and user management via inference.sh CLI. Apps: x/post-tweet, x/post-create (with media), x/post-like, x/post-retweet, x/dm-send, x/user-follow. Capabilities: post tweets, schedule content, like posts, retweet, send DMs, follow users, get profiles. Use for: social media automation, content scheduling, engagement bots, audience growth, X API. Triggers: twitter api, x api, tweet automation, post to twitter, twitter bot, social media automation, x automation, tweet scheduler, twitter integration, post tweet, twitter post, x post, send tweet

Marketing & SEO453.7K installs