r06-alirezarezvani-claude-code-tresor-seo
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
Chineser06-alirezarezvani-claude-code-tresor-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.
由ara.so开发的Skill——营销技能合集。
这是一套SEO与内容营销Skill套件,提供关键词研究、内容审计、SERP分析、技术SEO诊断以及内容策略自动化功能。源自alirezarezvani/claude-code-tresor,具备结构化输出、进度跟踪和多步骤工作流编排能力。
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
该Skill套件提供10个专业SEO命令和5个多步骤工作流:
核心命令:
- 带聚类和意图映射的关键词研究
- 全站内容审计与关键词 cannibalization(自竞争)检测
- 技术SEO爬取(Core Web Vitals、Schema、可索引性)
- 竞品差距分析(反向链接、主题、摘要)
- 带NLP术语的AI生成内容简报
- 带波动警报的SERP排名跟踪
- 链接挖掘与外展自动化
- 映射排名影响的页面速度诊断
- 本地SEO审计(NAP、GBP、引用)
- 数据驱动的内容日历生成
工作流:
- 完整SEO冲刺(审计→关键词映射→内容规划)
- 上线前SEO检查清单
- 内容更新流水线
- 权威构建活动
- AI内容生产流水线
Installation
安装
bash
undefinedbash
undefinedClone the skill suite
克隆Skill套件
Copy to Claude Code skills directory
复制到Claude Code技能目录
cp -r r06-alirezarezvani-claude-code-tresor-seo ~/.claude/skills/
cp -r r06-alirezarezvani-claude-code-tresor-seo ~/.claude/skills/
Or install via npm if available
若可用也可通过npm安装
npm install -g r06-alirezarezvani-claude-code-tresor-seo
**Register in Claude Code session:**
```bash
/read ~/.claude/skills/r06-alirezarezvani-claude-code-tresor-seo/SKILL.mdnpm install -g r06-alirezarezvani-claude-code-tresor-seo
**在Claude Code会话中注册:**
```bash
/read ~/.claude/skills/r06-alirezarezvani-claude-code-tresor-seo/SKILL.mdKey Commands
核心命令
Keyword Research
关键词研究
Performs deep keyword clustering with SERP intent analysis and opportunity scoring.
bash
undefined执行深度关键词聚类,包含SERP意图分析和机会评分。
bash
undefinedBasic keyword research
基础关键词研究
/keyword-research "project management software"
/keyword-research "project management software"
Advanced with filters
带筛选条件的高级研究
/keyword-research "project management software"
--min-volume 500
--max-difficulty 40
--intent commercial,transactional
--output json
--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)
undefined/keyword-research "project management software"
--min-volume 500
--max-difficulty 40
--intent commercial,transactional
--output json
--min-volume 500
--max-difficulty 40
--intent commercial,transactional
--output json
**预期输出结构:**╔═══════════════════════════════════════════════════╗
║ 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)
undefinedContent Audit
内容审计
Full-site content quality analysis with duplication and cannibalization detection.
bash
undefined全站内容质量分析,包含重复内容和关键词自竞争检测。
bash
undefinedBasic audit
基础审计
/content-audit https://example.com
/content-audit https://example.com
Full scope with exports
带导出功能的完整范围审计
/content-audit https://example.com
--scope full
--check-duplicates
--check-cannibalization
--output md,csv
--scope full
--check-duplicates
--check-cannibalization
--output md,csv
**Code Pattern (Integration Example):**
```javascript
// 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
// }/content-audit https://example.com
--scope full
--check-duplicates
--check-cannibalization
--output md,csv
--scope full
--check-duplicates
--check-cannibalization
--output md,csv
**代码模式(集成示例):**
```javascript
// 若与自定义爬虫集成
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
技术SEO审计
Crawl budget, Core Web Vitals, schema markup, and indexability diagnostics.
bash
undefined爬取预算、Core Web Vitals、Schema标记和可索引性诊断。
bash
undefinedBasic technical audit
基础技术审计
/technical-seo https://example.com
/technical-seo https://example.com
Detailed with specific checks
带特定检查项的详细审计
/technical-seo https://example.com
--check-cwv
--check-schema
--check-robots
--check-sitemap
--check-mobile
--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)
undefined/technical-seo https://example.com
--check-cwv
--check-schema
--check-robots
--check-sitemap
--check-mobile
--check-cwv
--check-schema
--check-robots
--check-sitemap
--check-mobile
**输出结构:**┌─────────────────────┬──────────┬──────────┬──────────┐
│ 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)
undefinedCompetitor Gap Analysis
竞品差距分析
Backlink gap, topic gap, and featured snippet opportunities.
bash
undefined反向链接差距、主题差距和精选摘要机会分析。
bash
undefinedCompare against competitors
与竞品对比
/competitor-gap https://example.com
--competitors competitor1.com,competitor2.com,competitor3.com
--analyze backlinks,topics,snippets
--competitors competitor1.com,competitor2.com,competitor3.com
--analyze backlinks,topics,snippets
/competitor-gap https://example.com
--competitors competitor1.com,competitor2.com,competitor3.com
--analyze backlinks,topics,snippets
--competitors competitor1.com,competitor2.com,competitor3.com
--analyze backlinks,topics,snippets
Focus on specific gap type
聚焦特定差距类型
undefinedundefinedContent Brief Generation
内容简报生成
AI-generated SEO content brief with structure, NLP terms, and targets.
bash
undefinedAI生成的SEO内容简报,包含结构、NLP术语和目标指标。
bash
undefinedGenerate brief for target keyword
为目标关键词生成简报
/content-brief "how to manage remote teams"
/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
--analyze-serp
--competitors 5
--include-nlp
--target-wordcount 2500
**Output Example:**
```markdown/content-brief "how to manage remote teams"
--analyze-serp
--competitors 5
--include-nlp
--target-wordcount 2500
--analyze-serp
--competitors 5
--include-nlp
--target-wordcount 2500
**输出示例:**
```markdownContent Brief: "how to manage remote teams"
Content Brief: "how to manage remote teams"
Target Metrics
Target Metrics
- Word Count: 2,200-2,800 words
- Reading Level: Grade 8-10
- Target Intent: Informational + Commercial
- Word Count: 2,200-2,800 words
- Reading Level: Grade 8-10
- Target Intent: Informational + Commercial
Outline
Outline
-
Introduction (150-200 words)
- Hook: Remote work statistics
- Problem statement
-
Core Challenges (400-500 words)
- Communication barriers
- Time zone differences
- Building trust remotely
-
Proven Strategies (800-1000 words)
- Daily standups & async updates
- Tool stack recommendations
- Performance tracking
-
Best Practices (400-500 words)
- Team culture building
- 1-on-1 check-ins
-
Conclusion & CTA (150-200 words)
-
Introduction (150-200 words)
- Hook: Remote work statistics
- Problem statement
-
Core Challenges (400-500 words)
- Communication barriers
- Time zone differences
- Building trust remotely
-
Proven Strategies (800-1000 words)
- Daily standups & async updates
- Tool stack recommendations
- Performance tracking
-
Best Practices (400-500 words)
- Team culture building
- 1-on-1 check-ins
-
Conclusion & CTA (150-200 words)
NLP Terms to Include
NLP Terms to Include
- remote team management
- asynchronous communication
- distributed workforce
- virtual collaboration tools
- remote employee engagement [...25 more terms]
- remote team management
- asynchronous communication
- distributed workforce
- virtual collaboration tools
- remote employee engagement [...25 more terms]
SERP Analysis
SERP Analysis
Top 5 competitors average:
- Word count: 2,350
- Images: 8
- Videos: 1-2
- Internal links: 12
- External links: 8
undefinedTop 5 competitors average:
- Word count: 2,350
- Images: 8
- Videos: 1-2
- Internal links: 12
- External links: 8
undefinedSERP Monitoring
SERP监控
Daily rank tracking with volatility alerts and CTR optimization.
bash
undefined每日排名跟踪,带波动警报和CTR优化建议。
bash
undefinedMonitor keywords
监控关键词
/serp-monitor
--keywords "keyword1,keyword2,keyword3"
--domain example.com
--frequency daily
--keywords "keyword1,keyword2,keyword3"
--domain example.com
--frequency daily
/serp-monitor
--keywords "keyword1,keyword2,keyword3"
--domain example.com
--frequency daily
--keywords "keyword1,keyword2,keyword3"
--domain example.com
--frequency daily
With alerts
带警报功能
/serp-monitor
--keywords-file keywords.csv
--alert-threshold 3
--notify email
--keywords-file keywords.csv
--alert-threshold 3
--notify email
undefined/serp-monitor
--keywords-file keywords.csv
--alert-threshold 3
--notify email
--keywords-file keywords.csv
--alert-threshold 3
--notify email
undefinedLink Prospecting
链接挖掘
Quality backlink prospect list with DA/DR filters and outreach templates.
bash
undefined带DA/DR筛选和外展模板的高质量反向链接候选列表。
bash
undefinedFind link prospects
寻找链接候选
/link-prospecting
--niche "project management"
--min-dr 30
--max-results 100
--include-contacts
--niche "project management"
--min-dr 30
--max-results 100
--include-contacts
/link-prospecting
--niche "project management"
--min-dr 30
--max-results 100
--include-contacts
--niche "project management"
--min-dr 30
--max-results 100
--include-contacts
With outreach templates
带外展模板
/link-prospecting
--niche "project management"
--generate-templates
--output csv
--niche "project management"
--generate-templates
--output csv
undefined/link-prospecting
--niche "project management"
--generate-templates
--output csv
--niche "project management"
--generate-templates
--output csv
undefinedPage Speed SEO
页面速度SEO
Render-blocking, LCP, CLS, FID diagnosis mapped to ranking impact.
bash
undefined阻塞渲染、LCP、CLS、FID诊断,并映射排名影响。
bash
undefinedAnalyze page speed
分析页面速度
/page-speed-seo https://example.com/page
/page-speed-seo https://example.com/page
Multiple pages
分析多个页面
undefinedundefinedLocal SEO Audit
本地SEO审计
NAP consistency, Google Business Profile optimization, and citation audit.
bash
undefinedNAP一致性、Google Business Profile优化和引用审计。
bash
undefinedLocal SEO check
本地SEO检查
/local-seo
--business "Example Corp"
--location "New York, NY"
--check-nap
--check-gbp
--check-citations
--business "Example Corp"
--location "New York, NY"
--check-nap
--check-gbp
--check-citations
undefined/local-seo
--business "Example Corp"
--location "New York, NY"
--check-nap
--check-gbp
--check-citations
--business "Example Corp"
--location "New York, NY"
--check-nap
--check-gbp
--check-citations
undefinedContent Calendar
内容日历
Data-driven editorial calendar from search demand and seasonality.
bash
undefined基于搜索需求和季节性的数据驱动编辑日历。
bash
undefinedGenerate calendar
生成日历
/content-calendar
--niche "project management"
--duration 90
--frequency weekly
--include-trending
--niche "project management"
--duration 90
--frequency weekly
--include-trending
/content-calendar
--niche "project management"
--duration 90
--frequency weekly
--include-trending
--niche "project management"
--duration 90
--frequency weekly
--include-trending
Export to tools
导出到工具
/content-calendar
--niche "project management"
--export notion,airtable,trello
--niche "project management"
--export notion,airtable,trello
undefined/content-calendar
--niche "project management"
--export notion,airtable,trello
--niche "project management"
--export notion,airtable,trello
undefinedWorkflows (Multi-Step)
工作流(多步骤)
Full SEO Sprint
完整SEO冲刺
12-step comprehensive SEO sprint workflow.
bash
/workflows:full-seo-sprint https://example.com \
--scope full \
--duration 30daysSteps:
- Technical audit
- Content audit
- Keyword research
- Competitor analysis
- Gap identification
- Content strategy
- Link building plan
- On-page optimization
- Schema implementation
- Performance monitoring
- Reporting dashboard
- Next sprint planning
12步骤的全面SEO冲刺工作流。
bash
/workflows:full-seo-sprint https://example.com \
--scope full \
--duration 30days步骤:
- 技术审计
- 内容审计
- 关键词研究
- 竞品分析
- 差距识别
- 内容策略
- 链接构建计划
- 页面内优化
- Schema实施
- 性能监控
- 报告仪表盘
- 下一冲刺规划
Launch SEO
上线前SEO
Pre-launch SEO checklist and validation.
bash
/workflows:launch-seo https://newsite.com \
--pre-launch \
--check-allValidates:
- Canonical tags
- Hreflang (if applicable)
- Sitemap generation
- Robots.txt configuration
- Schema markup
- Core Web Vitals
- Mobile optimization
- Analytics setup
上线前SEO检查清单和验证。
bash
/workflows:launch-seo https://newsite.com \
--pre-launch \
--check-all验证项:
- 规范标签
- Hreflang(如适用)
- 站点地图生成
- Robots.txt配置
- Schema标记
- Core Web Vitals
- 移动端优化
- 分析工具设置
Content Refresh
内容更新
Identify and refresh underperforming pages.
bash
/workflows:content-refresh https://example.com \
--min-age 180days \
--traffic-drop 30%识别并更新表现不佳的页面。
bash
/workflows:content-refresh https://example.com \
--min-age 180days \
--traffic-drop 30%Authority Building
权威构建
End-to-end digital PR and link building campaign.
bash
/workflows:authority-building \
--niche "project management" \
--target-dr 50 \
--duration 90days端到端的数字PR和链接构建活动。
bash
/workflows:authority-building \
--niche "project management" \
--target-dr 50 \
--duration 90daysAI Content Pipeline
AI内容流水线
Keyword → brief → draft → optimize → publish automation.
bash
/workflows:ai-content-pipeline \
--keywords-file keywords.csv \
--auto-publish false \
--review-mode true关键词→简报→草稿→优化→发布的自动化流程。
bash
/workflows:ai-content-pipeline \
--keywords-file keywords.csv \
--auto-publish false \
--review-mode trueConfiguration
配置
Create a configuration file at :
~/.r06-seo/config.jsonjson
{
"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:
bash
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="alerts@example.com"
export SLACK_WEBHOOK_URL="https://hooks.slack.com/..."在创建配置文件:
~/.r06-seo/config.jsonjson
{
"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
}
}环境变量:
bash
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="alerts@example.com"
export SLACK_WEBHOOK_URL="https://hooks.slack.com/..."Common Patterns
常见模式
Integration with CI/CD
与CI/CD集成
yaml
undefinedyaml
undefined.github/workflows/seo-monitor.yml
.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"}'undefinedname: 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"}'undefinedProgrammatic Usage
程序化使用
javascript
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);javascript
const SEOSuite = require('r06-seo-suite');
const suite = new SEOSuite({
apiKey: process.env.SEMRUSH_API_KEY,
config: {
country: 'US',
language: 'en'
}
});
// 关键词研究
const keywords = await suite.keywordResearch({
seed: 'project management software',
minVolume: 500,
maxDifficulty: 40
});
// 内容审计
const audit = await suite.contentAudit({
domain: 'https://example.com',
scope: 'full',
options: {
checkDuplicates: true,
checkCannibalization: true
}
});
// 生成内容简报
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
批处理
bash
undefinedbash
undefinedProcess multiple domains
处理多个域名
cat domains.txt | while read domain; do
/technical-seo "$domain" --output json > "results/${domain////_}.json"
done
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
--seeds-file keywords.txt
--batch-size 50
--output csv > keyword-report.csv
undefined/keyword-research
--seeds-file keywords.txt
--batch-size 50
--output csv > keyword-report.csv
--seeds-file keywords.txt
--batch-size 50
--output csv > keyword-report.csv
undefinedCustom Reporting
自定义报告
javascript
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');javascript
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
API速率限制
If you encounter rate limit errors:
bash
undefined如果遇到速率限制错误:
bash
undefinedCheck current rate limit status
检查当前速率限制状态
/debug:rate-limits
/debug:rate-limits
Configure retry with backoff
配置重试与退避
export SEO_SUITE_RETRY_COUNT=3
export SEO_SUITE_RETRY_DELAY=5000
undefinedexport SEO_SUITE_RETRY_COUNT=3
export SEO_SUITE_RETRY_DELAY=5000
undefinedSlow Crawls
爬取缓慢
For large sites, optimize crawl performance:
bash
undefined对于大型站点,优化爬取性能:
bash
undefinedLimit concurrent requests
限制并发请求
Crawl specific sections
爬取特定部分
undefinedundefinedMissing Dependencies
缺失依赖
bash
undefinedbash
undefinedInstall all optional dependencies
安装所有可选依赖
npm install r06-seo-suite --include=optional
npm install r06-seo-suite --include=optional
Specific tools
特定工具
npm install puppeteer # For page speed tests
npm install cheerio # For content parsing
undefinednpm install puppeteer # 用于页面速度测试
npm install cheerio # 用于内容解析
undefinedAuthentication Issues
认证问题
bash
undefinedbash
undefinedVerify API keys
验证API密钥
/debug:check-auth
/debug:check-auth
Test individual APIs
测试单个API
curl -H "Authorization: Bearer ${SEMRUSH_API_KEY}"
"https://api.semrush.com/analytics/v1/?key=${SEMRUSH_API_KEY}&type=domain_ranks&domain=example.com"
"https://api.semrush.com/analytics/v1/?key=${SEMRUSH_API_KEY}&type=domain_ranks&domain=example.com"
undefinedcurl -H "Authorization: Bearer ${SEMRUSH_API_KEY}"
"https://api.semrush.com/analytics/v1/?key=${SEMRUSH_API_KEY}&type=domain_ranks&domain=example.com"
"https://api.semrush.com/analytics/v1/?key=${SEMRUSH_API_KEY}&type=domain_ranks&domain=example.com"
undefinedOutput Format Issues
输出格式问题
bash
undefinedbash
undefinedForce specific output format
强制指定输出格式
/keyword-research "topic" --output json --pretty
/keyword-research "topic" --output json --pretty
Validate output schema
验证输出 schema
/keyword-research "topic" --validate-output
/keyword-research "topic" --validate-output
Debug mode for detailed logs
调试模式查看详细日志
DEBUG=r06-seo:* /technical-seo https://example.com
undefinedDEBUG=r06-seo:* /technical-seo https://example.com
undefinedBest Practices
最佳实践
- Always use environment variables for API keys
- Start with scoped audits before running full-site scans
- Set up notifications for critical issues
- Cache results for frequently accessed data
- Use batch processing for multiple domains/keywords
- Export to CSV/JSON for integration with other tools
- Schedule regular monitoring via cron or CI/CD
- Review action plans before implementing changes
- Track changes in version control
- Validate fixes with follow-up audits
- 始终使用环境变量存储API密钥
- 先进行范围限定的审计,再运行全站扫描
- 设置通知以接收关键问题警报
- 缓存结果用于频繁访问的数据
- 使用批处理处理多个域名/关键词
- 导出为CSV/JSON以集成到其他工具
- 通过 cron 或 CI/CD定期安排监控
- 在实施更改前审查行动计划
- 在版本控制中跟踪更改
- 通过后续审计验证修复效果