name	r06-alirezarezvani-claude-code-tresor-seo
description	SEO & content marketing automation with keyword research, audits, SERP analysis, and content strategy workflows
triggers	help me with SEO keyword research, audit this website for SEO issues, analyze SERP rankings and competitors, create an SEO content brief, check technical SEO performance, build a content marketing calendar, find backlink opportunities, optimize page speed for SEO

r06-alirezarezvani-claude-code-tresor-seo

Skill by ara.so — Marketing Skills collection.

SEO & Content Marketing skill suite providing keyword research, content audits, SERP analysis, technical SEO diagnostics, and content strategy automation. Derived from alirezarezvani/claude-code-tresor with structured output, progress tracking, and multi-step workflow orchestration.

What This Project Does

This skill suite provides 10 specialized SEO commands and 5 multi-step workflows:

Core Commands:

• Keyword research with clustering and intent mapping
• Full-site content audits and cannibalization detection
• Technical SEO crawls (Core Web Vitals, schema, indexability)
• Competitor gap analysis (backlinks, topics, snippets)
• AI-generated content briefs with NLP terms
• SERP rank tracking with volatility alerts
• Link prospecting and outreach automation
• Page speed diagnostics mapped to ranking impact
• Local SEO audits (NAP, GBP, citations)
• Data-driven content calendar generation

Workflows:

• Full SEO sprint (audit → keyword map → content plan)
• Pre-launch SEO checklist
• Content refresh pipeline
• Authority building campaigns
• AI content production pipeline

Installation

# Clone the skill suite
git clone https://github.com/LairLightningDerrick/r06-alirezarezvani-claude-code-tresor-seo.git

# Copy to Claude Code skills directory
cp -r r06-alirezarezvani-claude-code-tresor-seo ~/.claude/skills/

# Or install via npm if available
npm install -g r06-alirezarezvani-claude-code-tresor-seo

Register in Claude Code session:

/read ~/.claude/skills/r06-alirezarezvani-claude-code-tresor-seo/SKILL.md

Key Commands

Keyword Research

Performs deep keyword clustering with SERP intent analysis and opportunity scoring.

# Basic keyword research
/keyword-research "project management software"

# Advanced with filters
/keyword-research "project management software" \
  --min-volume 500 \
  --max-difficulty 40 \
  --intent commercial,transactional \
  --output json

Expected Output Structure:

╔═══════════════════════════════════════════════════╗
║  Keyword Research  —  "project management software"  ║
╠═══════════════════════════════════════════════════╣
║  Fetching search volume …    [██████████] 100% ✓  ║
║  Analyzing SERP intent …     [██████████] 100% ✓  ║
║  Clustering keywords …       [██████████] 100% ✓  ║
║  Scoring opportunities …     [██████████] 100% ✓  ║
╚═══════════════════════════════════════════════════╝

┌──────────────────────────┬────────┬────────┬──────────┬──────────┐
│ Keyword                  │ Volume │ Diff.  │ Intent   │ Priority │
├──────────────────────────┼────────┼────────┼──────────┼──────────┤
│ project management tools │ 18,100 │   35   │ Comm.    │  🟢 High │
│ pm software for teams    │  8,900 │   28   │ Trans.   │  🟢 High │
│ best project tracker     │  6,400 │   42   │ Info.    │  🟡 Med  │
│ free pm software         │  4,200 │   18   │ Trans.   │  🟢 High │
└──────────────────────────┴────────┴────────┴──────────┴──────────┘

📊 Clusters Found: 5 primary, 12 secondary
🎯 Quick Wins: 8 keywords (low difficulty, high volume)

Content Audit

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

# Basic audit
/content-audit https://example.com

# Full scope with exports
/content-audit https://example.com \
  --scope full \
  --check-duplicates \
  --check-cannibalization \
  --output md,csv

Code Pattern (Integration Example):

// If integrating with custom crawler
const contentAudit = require('r06-seo-suite/content-audit');

const results = await contentAudit.run({
  domain: 'https://example.com',
  scope: 'full',
  options: {
    checkDuplicates: true,
    checkCannibalization: true,
    minWordCount: 300,
    maxTitleLength: 60
  }
});

console.log(results.summary);
// {
//   totalPages: 1204,
//   duplicateContent: 47,
//   cannibalizationIssues: 12,
//   missingMetaDesc: 302,
//   thinContent: 89,
//   qualityScore: 7.2
// }

Technical SEO Audit

Crawl budget, Core Web Vitals, schema markup, and indexability diagnostics.

# Basic technical audit
/technical-seo https://example.com

# Detailed with specific checks
/technical-seo https://example.com \
  --check-cwv \
  --check-schema \
  --check-robots \
  --check-sitemap \
  --check-mobile

Output Structure:

┌─────────────────────┬──────────┬──────────┬──────────┐
│ Metric              │ Current  │ Target   │ Status   │
├─────────────────────┼──────────┼──────────┼──────────┤
│ Crawlable pages     │    1,204 │    1,505 │  ⚠ 80%   │
│ Pages w/ title tag  │    1,180 │    1,204 │  ✓ 98%   │
│ Core Web Vitals     │     Good │     Good │  ✓ Pass  │
│ Schema markup       │      342 │    1,204 │  ✗ 28%   │
│ Mobile-friendly     │       97 │      100 │  ⚠ 97%   │
└─────────────────────┴──────────┴──────────┴──────────┘

🔴 Critical Issues (3)
  • 301 pages blocked by robots.txt
  • Sitemap contains 124 404 URLs
  • 18 pages with duplicate H1 tags

🟠 Warnings (8)
  • 302 pages missing meta descriptions
  • LCP > 2.5s on 23% of pages
  • 89 pages with thin content (<300 words)

Competitor Gap Analysis

Backlink gap, topic gap, and featured snippet opportunities.

# Compare against competitors
/competitor-gap https://example.com \
  --competitors competitor1.com,competitor2.com,competitor3.com \
  --analyze backlinks,topics,snippets

# Focus on specific gap type
/competitor-gap https://example.com \
  --competitors competitor1.com \
  --gap-type backlinks \
  --min-dr 40

Content Brief Generation

AI-generated SEO content brief with structure, NLP terms, and targets.

# Generate brief for target keyword
/content-brief "how to manage remote teams"

# Advanced brief with competitors
/content-brief "how to manage remote teams" \
  --analyze-serp \
  --competitors 5 \
  --include-nlp \
  --target-wordcount 2500

Output Example:

# Content Brief: "how to manage remote teams"

## Target Metrics
- **Word Count:** 2,200-2,800 words
- **Reading Level:** Grade 8-10
- **Target Intent:** Informational + Commercial

## Outline
1. Introduction (150-200 words)
   - Hook: Remote work statistics
   - Problem statement
   
2. Core Challenges (400-500 words)
   - Communication barriers
   - Time zone differences
   - Building trust remotely
   
3. Proven Strategies (800-1000 words)
   - Daily standups & async updates
   - Tool stack recommendations
   - Performance tracking
   
4. Best Practices (400-500 words)
   - Team culture building
   - 1-on-1 check-ins
   
5. Conclusion & CTA (150-200 words)

## NLP Terms to Include
- remote team management
- asynchronous communication
- distributed workforce
- virtual collaboration tools
- remote employee engagement
[...25 more terms]

## SERP Analysis
Top 5 competitors average:
- Word count: 2,350
- Images: 8
- Videos: 1-2
- Internal links: 12
- External links: 8

SERP Monitoring

Daily rank tracking with volatility alerts and CTR optimization.

# Monitor keywords
/serp-monitor \
  --keywords "keyword1,keyword2,keyword3" \
  --domain example.com \
  --frequency daily

# With alerts
/serp-monitor \
  --keywords-file keywords.csv \
  --alert-threshold 3 \
  --notify email

Link Prospecting

Quality backlink prospect list with DA/DR filters and outreach templates.

# Find link prospects
/link-prospecting \
  --niche "project management" \
  --min-dr 30 \
  --max-results 100 \
  --include-contacts

# With outreach templates
/link-prospecting \
  --niche "project management" \
  --generate-templates \
  --output csv

Page Speed SEO

Render-blocking, LCP, CLS, FID diagnosis mapped to ranking impact.

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

# Multiple pages
/page-speed-seo \
  --sitemap https://example.com/sitemap.xml \
  --top-pages 20 \
  --mobile

Local SEO Audit

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

# Local SEO check
/local-seo \
  --business "Example Corp" \
  --location "New York, NY" \
  --check-nap \
  --check-gbp \
  --check-citations

Content Calendar

Data-driven editorial calendar from search demand and seasonality.

# Generate calendar
/content-calendar \
  --niche "project management" \
  --duration 90 \
  --frequency weekly \
  --include-trending

# Export to tools
/content-calendar \
  --niche "project management" \
  --export notion,airtable,trello

Workflows (Multi-Step)

Full SEO Sprint

12-step comprehensive SEO sprint workflow.

/workflows:full-seo-sprint https://example.com \
  --scope full \
  --duration 30days

Steps:

1. Technical audit
2. Content audit
3. Keyword research
4. Competitor analysis
5. Gap identification
6. Content strategy
7. Link building plan
8. On-page optimization
9. Schema implementation
10. Performance monitoring
11. Reporting dashboard
12. Next sprint planning

Launch SEO

Pre-launch SEO checklist and validation.

/workflows:launch-seo https://newsite.com \
  --pre-launch \
  --check-all

Validates:

• Canonical tags
• Hreflang (if applicable)
• Sitemap generation
• Robots.txt configuration
• Schema markup
• Core Web Vitals
• Mobile optimization
• Analytics setup

Content Refresh

Identify and refresh underperforming pages.

/workflows:content-refresh https://example.com \
  --min-age 180days \
  --traffic-drop 30%

Authority Building

End-to-end digital PR and link building campaign.

/workflows:authority-building \
  --niche "project management" \
  --target-dr 50 \
  --duration 90days

AI Content Pipeline

Keyword → brief → draft → optimize → publish automation.

/workflows:ai-content-pipeline \
  --keywords-file keywords.csv \
  --auto-publish false \
  --review-mode true

Configuration

Create a configuration file at ~/.r06-seo/config.json:

{
  "api": {
    "semrush_key": "${SEMRUSH_API_KEY}",
    "ahrefs_key": "${AHREFS_API_KEY}",
    "serpapi_key": "${SERPAPI_KEY}",
    "openai_key": "${OPENAI_API_KEY}"
  },
  "defaults": {
    "country": "US",
    "language": "en",
    "search_engine": "google.com",
    "mobile_first": true
  },
  "thresholds": {
    "min_word_count": 300,
    "max_title_length": 60,
    "max_meta_desc_length": 160,
    "target_cwv_lcp": 2.5,
    "target_cwv_fid": 100,
    "target_cwv_cls": 0.1
  },
  "notifications": {
    "email": "${NOTIFICATION_EMAIL}",
    "slack_webhook": "${SLACK_WEBHOOK_URL}",
    "enabled": true
  }
}

Environment Variables:

export SEMRUSH_API_KEY="your-key-here"
export AHREFS_API_KEY="your-key-here"
export SERPAPI_KEY="your-key-here"
export OPENAI_API_KEY="your-key-here"
export NOTIFICATION_EMAIL="[email protected]"
export SLACK_WEBHOOK_URL="https://hooks.slack.com/..."

Common Patterns

Integration with CI/CD

# .github/workflows/seo-monitor.yml
name: Daily SEO Monitor

on:
  schedule:
    - cron: '0 9 * * *'

jobs:
  seo-check:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      
      - name: Run SEO audit
        run: |
          npx r06-seo-suite technical-seo https://example.com \
            --output json > audit-results.json
      
      - name: Check for critical issues
        run: |
          node scripts/check-critical.js audit-results.json
      
      - name: Notify on failures
        if: failure()
        run: |
          curl -X POST ${{ secrets.SLACK_WEBHOOK }} \
            -d '{"text":"SEO audit found critical issues"}'

Programmatic Usage

const SEOSuite = require('r06-seo-suite');

const suite = new SEOSuite({
  apiKey: process.env.SEMRUSH_API_KEY,
  config: {
    country: 'US',
    language: 'en'
  }
});

// Keyword research
const keywords = await suite.keywordResearch({
  seed: 'project management software',
  minVolume: 500,
  maxDifficulty: 40
});

// Content audit
const audit = await suite.contentAudit({
  domain: 'https://example.com',
  scope: 'full',
  options: {
    checkDuplicates: true,
    checkCannibalization: true
  }
});

// Generate content brief
const brief = await suite.contentBrief({
  keyword: 'how to manage remote teams',
  analyzeSERP: true,
  competitors: 5,
  targetWordCount: 2500
});

console.log(brief.outline);
console.log(brief.nlpTerms);

Batch Processing

# Process multiple domains
cat domains.txt | while read domain; do
  /technical-seo "$domain" --output json > "results/${domain//\//_}.json"
done

# Bulk keyword research
/keyword-research \
  --seeds-file keywords.txt \
  --batch-size 50 \
  --output csv > keyword-report.csv

Custom Reporting

const { generateReport } = require('r06-seo-suite/reporting');

const data = {
  technicalAudit: await suite.technicalSEO('https://example.com'),
  contentAudit: await suite.contentAudit('https://example.com'),
  keywordData: await suite.keywordResearch({ seed: 'main topic' })
};

const report = await generateReport({
  data,
  template: 'executive-summary',
  format: 'pdf',
  includeCharts: true
});

await report.save('monthly-seo-report.pdf');

Troubleshooting

API Rate Limits

If you encounter rate limit errors:

# Check current rate limit status
/debug:rate-limits

# Configure retry with backoff
export SEO_SUITE_RETRY_COUNT=3
export SEO_SUITE_RETRY_DELAY=5000

Slow Crawls

For large sites, optimize crawl performance:

# Limit concurrent requests
/technical-seo https://example.com \
  --concurrent 5 \
  --delay 1000

# Crawl specific sections
/content-audit https://example.com \
  --path "/blog/*" \
  --exclude "/archive/*"

Missing Dependencies

# Install all optional dependencies
npm install r06-seo-suite --include=optional

# Specific tools
npm install puppeteer  # For page speed tests
npm install cheerio    # For content parsing

Authentication Issues

# Verify API keys
/debug:check-auth

# Test individual APIs
curl -H "Authorization: Bearer ${SEMRUSH_API_KEY}" \
  "https://api.semrush.com/analytics/v1/?key=${SEMRUSH_API_KEY}&type=domain_ranks&domain=example.com"

Output Format Issues

# Force specific output format
/keyword-research "topic" --output json --pretty

# Validate output schema
/keyword-research "topic" --validate-output

# Debug mode for detailed logs
DEBUG=r06-seo:* /technical-seo https://example.com

Best Practices

1. Always use environment variables for API keys
2. Start with scoped audits before running full-site scans
3. Set up notifications for critical issues
4. Cache results for frequently accessed data
5. Use batch processing for multiple domains/keywords
6. Export to CSV/JSON for integration with other tools
7. Schedule regular monitoring via cron or CI/CD
8. Review action plans before implementing changes
9. Track changes in version control
10. Validate fixes with follow-up audits