📈 SEO & Content Marketing Skills Suite
📈 SEO与内容营销技能套件
Skill by
ara.so — Marketing Skills collection.
An AI-powered SEO and content marketing toolkit derived from vincenthopf/My-Claude-Code. This skill suite provides 10 specialized commands and 5 multi-step workflows for keyword research, content audits, SERP analysis, technical SEO, and content strategy with structured, actionable output.
这是一款基于vincenthopf/My-Claude-Code开发的AI驱动型SEO与内容营销工具包。该技能套件提供10个专业命令和5个多步骤工作流,用于关键词研究、内容审核、SERP分析、技术SEO及内容策略制定,输出结构化、可落地的结果。
What This Project Does
项目功能
This skill suite transforms Claude Code into an SEO and content marketing specialist with:
- 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
- Link Building — prospect discovery, outreach automation, authority campaigns
All commands follow a consistent 5-step interaction pattern with visual progress tracking, prioritized findings, and time-boxed action plans.
该技能套件可将Claude Code转变为SEO与内容营销专家,具备以下能力:
- 关键词研究 —— 聚类、机会评分、SERP意图映射
- 内容审核 —— 质量评分、重复内容检测、关键词 cannibalization(内部竞争)报告
- 技术SEO —— 抓取预算、Core Web Vitals、Schema标记、可索引性分析
- 竞品分析 —— 反向链接差距、话题差距、特色摘要机会挖掘
- 内容策略 —— AI生成brief、编辑日历、内容更新工作流
- 链接建设 —— 潜在合作方挖掘、 outreach(外推)自动化、权威提升活动
所有命令遵循统一的5步交互模式,包含可视化进度跟踪、优先级结果划分和限时行动计划。
Method 1: Manual Installation
方法1:手动安装
Copy to Claude skills directory
复制到Claude技能目录
mkdir -p ~/.claude/skills
cp -r r12-vincenthopf-my-claude-code-seo ~/.claude/skills/seo-content-marketing
mkdir -p ~/.claude/skills
cp -r r12-vincenthopf-my-claude-code-seo ~/.claude/skills/seo-content-marketing
Register in Claude Code session
在Claude Code会话中注册
In Claude Code:
在Claude Code中执行:
/read ~/.claude/skills/seo-content-marketing/SKILL.md
/read ~/.claude/skills/seo-content-marketing/SKILL.md
Method 2: Direct Clone to Skills Directory
方法2:直接克隆到技能目录
bash
cd ~/.claude/skills
git clone https://github.com/Splitflucover93/r12-vincenthopf-my-claude-code-seo.git seo-content-marketing
bash
cd ~/.claude/skills
git clone https://github.com/Splitflucover93/r12-vincenthopf-my-claude-code-seo.git seo-content-marketing
After installation, verify the skill is available:
In Claude Code session:
在Claude Code会话中执行:
Should show: seo-content-marketing
应显示:seo-content-marketing
All commands output structured data with progress tracking, findings tables, and actionable recommendations.
所有命令输出结构化数据,包含进度跟踪、结果表格和可执行建议。
1. Keyword Research
1. 关键词研究
Basic keyword research
基础关键词研究
/keyword-research "project management software"
/keyword-research "project management software"
Advanced with filters
带筛选条件的高级研究
/keyword-research "saas analytics" --min-volume 500 --max-difficulty 60 --intent commercial
/keyword-research "saas analytics" --min-volume 500 --max-difficulty 60 --intent commercial
/keyword-research "email marketing" --output clusters.json --format json
**Output includes:**
- Keyword clusters with search volume
- Difficulty scores (0-100)
- SERP intent classification (informational/commercial/transactional/navigational)
- Opportunity score (volume × relevance / difficulty)
- Related questions and entities
/keyword-research "email marketing" --output clusters.json --format json
**输出内容包括:**
- 带搜索量的关键词聚类
- 难度评分(0-100)
- SERP意图分类(信息类/商业类/交易类/导航类)
- 机会评分(搜索量 × 相关性 / 难度)
- 相关问题及实体
/content-audit --scope full --url
https://example.com --output audit-report.md
**Analysis includes:**
- Content quality scores per page
- Duplicate/thin content detection
- Keyword cannibalization matrix
- Missing meta tags inventory
- Internal linking opportunities
/content-audit --scope full --url
https://example.com --output audit-report.md
**分析内容包括:**
- 单页内容质量评分
- 重复/低质内容检测
- 关键词内部竞争矩阵
- 缺失元标签清单
- 内部链接优化机会
3. Technical SEO Audit
3. 技术SEO审核
Full technical audit
完整技术审核
/technical-seo
https://example.com --verbose --output tech-audit.json
**Checks performed:**
- Crawl budget efficiency
- Core Web Vitals (LCP, FID, CLS)
- Schema markup validation
- Robots.txt and sitemap analysis
- Indexability issues
- Mobile-friendliness
/technical-seo
https://example.com --verbose --output tech-audit.json
**执行的检测:**
- 抓取预算效率
- Core Web Vitals(LCP、FID、CLS)
- Schema标记验证
- Robots.txt和站点地图分析
- 可索引性问题
- 移动端适配性
4. Competitor Gap Analysis
4. 竞品差距分析
Featured snippet opportunities
特色摘要机会
**Returns:**
- Domains linking to competitors but not to you
- Topics competitors rank for that you don't
- Featured snippet positions you could steal
- Content format gaps
**返回结果:**
- 链接到竞品但未链接到你的域名
- 竞品排名但你未排名的话题
- 你可以抢占的特色摘要位置
- 内容格式差距
5. Content Brief Generation
5. 内容Brief生成
Generate SEO content brief
生成SEO内容brief
/content-brief "how to improve email deliverability"
/content-brief "how to improve email deliverability"
With target word count and competitors
指定目标字数和竞品
/content-brief "conversion rate optimization guide" --output brief.md --template detailed
**Brief includes:**
- Target keyword + LSI keywords
- Recommended headings (H2-H4)
- NLP entities to include
- Word count range
- Competitor content analysis
- Questions to answer
- Internal linking suggestions
/content-brief "conversion rate optimization guide" --output brief.md --template detailed
**Brief包含:**
- 目标关键词+LSI关键词
- 推荐标题层级(H2-H4)
- 需要包含的NLP实体
- 字数范围
- 竞品内容分析
- 需要解答的问题
- 内部链接建议
6. SERP Monitoring
6. SERP监控
Track keyword rankings
跟踪关键词排名
/serp-monitor --keywords "seo tools,keyword research,backlink checker" --url
https://example.com/serp-monitor --keywords "seo tools,keyword research,backlink checker" --url
https://example.com/serp-monitor --keywords keywords.txt --url
https://example.com --alert-threshold 3 --frequency daily
/serp-monitor --keywords keywords.txt --url
https://example.com --alert-threshold 3 --frequency daily
Historical comparison
历史对比
/serp-monitor --keywords keywords.txt --url
https://example.com --compare 2026-04-01
**Tracks:**
- Daily rank positions
- Volatility alerts (±3+ positions)
- CTR optimization opportunities
- SERP feature presence (snippets, PAA, video)
/serp-monitor --keywords keywords.txt --url
https://example.com --compare 2026-04-01
**跟踪内容:**
- 每日排名位置
- 波动警报(±3+名次)
- CTR优化机会
- SERP功能存在情况(摘要、PAA、视频)
7. Link Prospecting
7. 链接潜在合作方挖掘
Find link prospects
寻找链接潜在合作方
/link-prospecting "marketing automation" --da-min 30 --dr-min 25 --limit 100
/link-prospecting "marketing automation" --da-min 30 --dr-min 25 --limit 100
With outreach context
带外推场景
/link-prospecting "content marketing" --context "We published a study on B2B content performance" --output prospects.csv
/link-prospecting "content marketing" --context "We published a study on B2B content performance" --output prospects.csv
/link-prospecting "seo" --types guest-post,resource-page,broken-link --da-min 40
**Returns:**
- Domain Authority/Rating filtered list
- Contact email discovery
- Outreach templates by type
- Relevance scores
/link-prospecting "seo" --types guest-post,resource-page,broken-link --da-min 40
**返回结果:**
- 按Domain Authority/Rating筛选的列表
- 联系邮箱挖掘
- 按类型划分的外推模板
- 相关性评分
8. Page Speed & SEO Impact
8. 页面速度与SEO影响分析
Analyze page speed impact
分析页面速度影响
/page-speed-seo --urls sitemap.xml --threshold 3.0
**Analyzes:**
- Render-blocking resources
- Largest Contentful Paint (LCP)
- Cumulative Layout Shift (CLS)
- First Input Delay (FID)
- SEO ranking impact estimation
- Optimization priorities
/page-speed-seo --urls sitemap.xml --threshold 3.0
**分析内容:**
- 阻塞渲染资源
- Largest Contentful Paint (LCP)
- Cumulative Layout Shift (CLS)
- First Input Delay (FID)
- SEO排名影响估算
- 优化优先级
9. Local SEO Audit
9. 本地SEO审核
/local-seo "My Business Name" --location "New York, NY"
/local-seo "My Business Name" --location "New York, NY"
NAP consistency check
NAP一致性检测
/local-seo "My Business Name" --checks nap-consistency --citations 50
/local-seo "My Business Name" --checks nap-consistency --citations 50
/local-seo "My Business Name" --checks gbp --output local-audit.md
**Checks:**
- NAP (Name, Address, Phone) consistency
- Google Business Profile completeness
- Local citation quality and quantity
- Review signals
- Local schema markup
- Local keyword rankings
/local-seo "My Business Name" --checks gbp --output local-audit.md
**执行的检测:**
- NAP(名称、地址、电话)一致性
- Google Business Profile完整性
- 本地引用质量与数量
- 评论信号
- 本地Schema标记
- 本地关键词排名
10. Content Calendar Generation
10. 内容日历生成
Generate data-driven calendar
生成数据驱动的日历
/content-calendar --topics "seo,content marketing,link building" --months 3
/content-calendar --topics "seo,content marketing,link building" --months 3
With search seasonality
包含搜索季节性
/content-calendar --topics topics.txt --months 6 --include-seasonality --output calendar.csv
/content-calendar --topics topics.txt --months 6 --include-seasonality --output calendar.csv
Prioritized by opportunity
按机会优先级排序
/content-calendar --topics keywords.json --months 3 --sort opportunity --min-volume 500
**Generates:**
- Topic schedule based on search demand
- Seasonal content opportunities
- Keyword targets per article
- Content type recommendations
- Publishing frequency optimization
/content-calendar --topics keywords.json --months 3 --sort opportunity --min-volume 500
**生成内容:**
- 基于搜索需求的话题时间表
- 季节性内容机会
- 单篇文章的关键词目标
- 内容类型建议
- 发布频率优化
Multi-Step Workflows
多步骤工作流
Workflows orchestrate multiple commands into end-to-end processes.
1. Full SEO Sprint
1. 完整SEO冲刺
12-step comprehensive SEO project:
bash
/workflows:full-seo-sprint https://example.com --output sprint-report/
Steps:
- Technical audit
- Content audit
- Keyword research
- Competitor gap analysis
- Content brief generation
- Internal linking map
- Schema markup recommendations
- Page speed optimization
- Link prospecting
- Content calendar
- Tracking setup
- Implementation checklist
12步全面SEO项目:
bash
/workflows:full-seo-sprint https://example.com --output sprint-report/
步骤:
- 技术审核
- 内容审核
- 关键词研究
- 竞品差距分析
- 内容Brief生成
- 内部链接映射
- Schema标记建议
- 页面速度优化
- 链接潜在合作方挖掘
- 内容日历
- 跟踪设置
- 实施清单
2. Pre-Launch SEO
2. 上线前SEO准备
bash
/workflows:launch-seo https://staging.example.com --checklist detailed
Validates:
- Canonical tags
- Hreflang implementation
- Sitemap configuration
- Robots.txt rules
- Meta tags completeness
- Schema markup
- Page speed baselines
- Analytics/Search Console setup
bash
/workflows:launch-seo https://staging.example.com --checklist detailed
验证内容:
- 规范标签
- Hreflang实现
- 站点地图配置
- Robots.txt规则
- 元标签完整性
- Schema标记
- 页面速度基准
- Analytics/Search Console设置
3. Content Refresh Workflow
3. 内容更新工作流
bash
/workflows:content-refresh https://example.com --pages underperforming --threshold -20
Process:
- Identify pages with ranking losses (>20%)
- Analyze current content gaps
- Generate refresh briefs
- Update recommendations
- Internal link injection opportunities
- Re-crawl triggers
bash
/workflows:content-refresh https://example.com --pages underperforming --threshold -20
流程:
- 识别排名下滑超过20%的页面
- 分析当前内容差距
- 生成更新brief
- 更新建议
- 内部链接注入机会
- 重新抓取触发
4. Authority Building Campaign
4. 权威提升活动
bash
/workflows:authority-building --domain example.com --target-da 50 --timeline 6-months
Campaign steps:
- Current authority baseline
- Competitor backlink analysis
- Link prospect discovery
- Outreach campaign setup
- Content asset creation
- Digital PR opportunities
- Progress tracking
bash
/workflows:authority-building --domain example.com --target-da 50 --timeline 6-months
活动步骤:
- 当前权威基准
- 竞品反向链接分析
- 链接潜在合作方挖掘
- 外推活动设置
- 内容资产创建
- 数字公关机会
- 进度跟踪
5. AI Content Pipeline
5. AI内容流水线
Automated content production workflow:
bash
/workflows:ai-content-pipeline --keywords keywords.csv --output-dir content-pipeline/
Pipeline:
- Keyword clustering
- Brief generation
- Content outline creation
- Draft generation (AI-assisted)
- SEO optimization pass
- Internal linking injection
- Publishing checklist
自动化内容生产工作流:
bash
/workflows:ai-content-pipeline --keywords keywords.csv --output-dir content-pipeline/
流水线:
- 关键词聚类
- Brief生成
- 内容大纲创建
- 草稿生成(AI辅助)
- SEO优化环节
- 内部链接注入
- 发布清单
Environment Variables
环境变量
Required API keys (use your own services)
必填API密钥(使用你自己的服务)
export AHREFS_API_KEY="your-key-here"
export SEMRUSH_API_KEY="your-key-here"
export GOOGLE_SEARCH_CONSOLE_CREDENTIALS="/path/to/credentials.json"
export SCREAMING_FROG_LICENSE="your-license-key"
export AHREFS_API_KEY="your-key-here"
export SEMRUSH_API_KEY="your-key-here"
export GOOGLE_SEARCH_CONSOLE_CREDENTIALS="/path/to/credentials.json"
export SCREAMING_FROG_LICENSE="your-license-key"
Optional integrations
可选集成
Create
~/.claude/skills/seo-content-marketing/config.yaml
:
创建
~/.claude/skills/seo-content-marketing/config.yaml
:
defaults:
output_format: markdown
progress_display: true
auto_export: false
defaults:
output_format: markdown
progress_display: true
auto_export: false
Command-specific settings
命令特定设置
keyword_research:
default_volume_min: 100
default_difficulty_max: 70
cluster_algorithm: semantic
serp_depth: 10
content_audit:
quality_threshold: 70
thin_content_words: 300
duplicate_similarity: 0.85
technical_seo:
cwv_thresholds:
lcp: 2.5
fid: 100
cls: 0.1
crawl_depth: 5
keyword_research:
default_volume_min: 100
default_difficulty_max: 70
cluster_algorithm: semantic
serp_depth: 10
content_audit:
quality_threshold: 70
thin_content_words: 300
duplicate_similarity: 0.85
technical_seo:
cwv_thresholds:
lcp: 2.5
fid: 100
cls: 0.1
crawl_depth: 5
rate_limits:
ahrefs: 500 # requests per day
semrush: 10000 # requests per month
rate_limits:
ahrefs: 500 # 每日请求数
semrush: 10000 # 每月请求数
export:
default_dir: ./seo-reports
timestamp_files: true
formats: [markdown, json, csv]
export:
default_dir: ./seo-reports
timestamp_files: true
formats: [markdown, json, csv]
Define custom workflows in
~/.claude/skills/seo-content-marketing/workflows/custom.yaml
:
yaml
my_saas_audit:
name: "SaaS Product SEO Audit"
steps:
- command: technical-seo
args: ["--checks", "all"]
- command: keyword-research
args: ["--intent", "commercial,transactional"]
- command: competitor-gap
args: ["--focus", "features"]
- command: content-brief
args: ["--template", "product-comparison"]
output: saas-audit-report.md
Run custom workflow:
bash
/workflows:my_saas_audit https://my-saas-product.com
在
~/.claude/skills/seo-content-marketing/workflows/custom.yaml
中定义自定义工作流:
yaml
my_saas_audit:
name: "SaaS产品SEO审核"
steps:
- command: technical-seo
args: ["--checks", "all"]
- command: keyword-research
args: ["--intent", "commercial,transactional"]
- command: competitor-gap
args: ["--focus", "features"]
- command: content-brief
args: ["--template", "product-comparison"]
output: saas-audit-report.md
运行自定义工作流:
bash
/workflows:my_saas_audit https://my-saas-product.com
Common Usage Patterns
常见使用模式
Pattern 1: New Site Launch SEO Setup
模式1:新站点上线SEO设置
Step 1: Pre-launch validation
步骤1:上线前验证
Step 2: Initial keyword research
步骤2:初始关键词研究
/keyword-research "primary product category" --min-volume 500 --output keywords.json
/keyword-research "primary product category" --min-volume 500 --output keywords.json
Step 3: Generate content calendar
步骤3:生成内容日历
/content-calendar --topics keywords.json --months 6 --output calendar.csv
/content-calendar --topics keywords.json --months 6 --output calendar.csv
Step 4: Create first content briefs
步骤4:创建首批内容brief
/content-brief "top keyword from research" --output briefs/article-1.md
/content-brief "top keyword from research" --output briefs/article-1.md
Pattern 2: Monthly SEO Review
模式2:月度SEO复盘
Step 1: Technical health check
步骤1:技术健康检测
Step 2: Ranking changes
步骤2:排名变化跟踪
Step 3: Content performance
步骤3:内容性能分析
/content-audit --scope full --url
https://example.com --output monthly-reports/$(date +%Y-%m)-content.md
/content-audit --scope full --url
https://example.com --output monthly-reports/$(date +%Y-%m)-content.md
Step 4: New opportunities
步骤4:新机会挖掘
/keyword-research "core topic" --discover-new --min-volume 300 --output new-opportunities.json
/keyword-research "core topic" --discover-new --min-volume 300 --output new-opportunities.json
Pattern 3: Competitor Overtake Campaign
模式3:竞品超越活动
Step 1: Identify competitor
步骤1:确定竞品
Step 2: Gap analysis
步骤2:差距分析
/competitor-gap topics --primary
https://mysite.com --competitors $COMPETITOR_URL --output gaps.json
/competitor-gap topics --primary
https://mysite.com --competitors $COMPETITOR_URL --output gaps.json
Step 3: Backlink opportunities
步骤3:反向链接机会
/competitor-gap backlinks --primary
https://mysite.com --competitors $COMPETITOR_URL --da-min 30
/competitor-gap backlinks --primary
https://mysite.com --competitors $COMPETITOR_URL --da-min 30
Step 4: Content strategy
步骤4:内容策略
/content-calendar --topics gaps.json --months 3 --sort opportunity
/content-calendar --topics gaps.json --months 3 --sort opportunity
Step 5: Content production
步骤5:内容生产
/workflows:ai-content-pipeline --keywords gaps.json --output-dir competitor-content/
/workflows:ai-content-pipeline --keywords gaps.json --output-dir competitor-content/
Pattern 4: Recovering Lost Rankings
模式4:恢复丢失排名
Step 1: Identify declining pages
步骤1:识别下滑页面
/serp-monitor --keywords all-keywords.txt --url
https://example.com --alert-threshold -5 --output declining.json
/serp-monitor --keywords all-keywords.txt --url
https://example.com --alert-threshold -5 --output declining.json
Step 2: Content refresh workflow
步骤2:内容更新工作流
Step 3: Technical issues check
步骤3:技术问题检测
Step 4: Backlink health
步骤4:反向链接维护
/link-prospecting "core topics" --context "We're updating our content" --output refresh-links.csv
/link-prospecting "core topics" --context "We're updating our content" --output refresh-links.csv
Pattern 5: Local Business SEO
模式5:本地商家SEO
Step 1: Local audit
步骤1:本地审核
/local-seo "Business Name" --location "City, State" --output local-audit.md
/local-seo "Business Name" --location "City, State" --output local-audit.md
Step 2: Citation building
步骤2:引用建设
/link-prospecting "industry + location" --types local-directory --output local-citations.csv
/link-prospecting "industry + location" --types local-directory --output local-citations.csv
Step 3: Local content calendar
步骤3:本地内容日历
/content-calendar --topics "local keywords" --include-seasonality --local "City, State" --months 12
/content-calendar --topics "local keywords" --include-seasonality --local "City, State" --months 12
Step 4: GBP optimization
步骤4:GBP优化
/local-seo "Business Name" --checks gbp --recommendations detailed
/local-seo "Business Name" --checks gbp --recommendations detailed
Export to Google Sheets
导出到Google Sheets
/keyword-research "topic" --output report.json
/keyword-research "topic" --output report.json
Use gsheet integration (if configured)
使用gsheet集成(需配置)
/export report.json --to google-sheets --sheet "SEO Research 2026"
/export report.json --to google-sheets --sheet "SEO Research 2026"
Slack Notifications
Slack通知
Configure webhook in config.yaml, then:
在config.yaml中配置webhook,然后执行:
Enable alerts for rank changes
启用排名变化警报
Add to
.github/workflows/seo-monitor.yml
:
yaml
name: Daily SEO Monitor
on:
schedule:
- cron: '0 9 * * *' # Daily at 9 AM UTC
jobs:
seo-check:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v3
- name: Run SEO Monitor
env:
AHREFS_API_KEY: ${{ secrets.AHREFS_API_KEY }}
run: |
/serp-monitor --keywords keywords.txt --url https://example.com --output reports/$(date +%Y-%m-%d).json
- name: Commit Report
run: |
git config user.name "SEO Bot"
git add reports/
git commit -m "Daily SEO report $(date +%Y-%m-%d)"
git push
添加到
.github/workflows/seo-monitor.yml
:
yaml
name: Daily SEO Monitor
on:
schedule:
- cron: '0 9 * * *' # 每天UTC时间9点执行
jobs:
seo-check:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v3
- name: Run SEO Monitor
env:
AHREFS_API_KEY: ${{ secrets.AHREFS_API_KEY }}
run: |
/serp-monitor --keywords keywords.txt --url https://example.com --output reports/$(date +%Y-%m-%d).json
- name: Commit Report
run: |
git config user.name "SEO Bot"
git add reports/
git commit -m "Daily SEO report $(date +%Y-%m-%d)"
git push
Verify skill installation
验证技能安装
ls ~/.claude/skills/seo-content-marketing/
ls ~/.claude/skills/seo-content-marketing/
/read ~/.claude/skills/seo-content-marketing/SKILL.md
/read ~/.claude/skills/seo-content-marketing/SKILL.md
Check current usage
查看当前使用情况
Adjust rate limits in config.yaml
在config.yaml中调整速率限制
rate_limits:
ahrefs: 400 # Reduce if hitting limits
rate_limits:
ahrefs: 400 # 若触发限制则降低数值
Use caching to reduce API calls
使用缓存减少API调用
cache:
enabled: true
ttl: 3600 # 1 hour
cache:
enabled: true
ttl: 3600 # 1小时
Limit keyword research scope
限制关键词研究范围
/keyword-research "topic" --max-keywords 500 --serp-depth 5
/keyword-research "topic" --max-keywords 500 --serp-depth 5
Use parallel processing
使用并行处理
Install required Python packages
安装所需Python包
pip install beautifulsoup4 requests pandas numpy
pip install beautifulsoup4 requests pandas numpy
Install Node.js dependencies (if using JS integrations)
安装Node.js依赖(若使用JS集成)
npm install cheerio axios
npm install cheerio axios
/diagnose --check-dependencies
/diagnose --check-dependencies
Check output directory permissions
检查输出目录权限
mkdir -p ./seo-reports
chmod 755 ./seo-reports
mkdir -p ./seo-reports
chmod 755 ./seo-reports
Specify absolute paths
指定绝对路径
/keyword-research "topic" --output /full/path/to/report.json
/keyword-research "topic" --output /full/path/to/report.json
Validate JSON output
验证JSON输出
cat report.json | python -m json.tool
cat report.json | python -m json.tool
Authentication Errors
认证错误
Verify API keys are set
验证API密钥已设置
/test-connection ahrefs
/test-connection semrush
/test-connection ahrefs
/test-connection semrush
Re-authenticate Google Search Console
重新认证Google Search Console
gcloud auth application-default login
gcloud auth application-default login
Output Interpretation
输出解读
Keyword Opportunity Score
关键词机会评分
Opportunity = (Search Volume × Relevance Score) / (Difficulty × 10)
High opportunity: > 100
Medium opportunity: 50-100
Low opportunity: < 50
机会评分 = (搜索量 × 相关性评分) / (难度 × 10)
高机会:> 100
中机会:50-100
低机会:< 50
Content Quality Score
内容质量评分
Quality = (Word Count × 0.2) + (Readability × 0.3) + (Originality × 0.3) + (Optimization × 0.2)
Excellent: 90-100
Good: 70-89
Fair: 50-69
Poor: < 50
质量评分 = (字数 × 0.2) + (可读性 × 0.3) + (原创性 × 0.3) + (优化程度 × 0.2)
优秀:90-100
良好:70-89
一般:50-69
较差:< 50
Technical SEO Severity
技术SEO严重程度
- 🔴 Critical: Blocks indexing or severely impacts UX
- 🟠 High: Notable ranking impact, fix within 1 week
- 🟡 Medium: Optimization opportunity, fix within 1 month
- 🟢 Low: Minor improvement, address when convenient
- 🔴 Critical(严重):阻碍索引或严重影响用户体验
- 🟠 High(高):对排名有显著影响,1周内修复
- 🟡 Medium(中):优化机会,1个月内修复
- 🟢 Low(低):微小改进,方便时处理
- Run technical audits monthly — catch issues early
- Update keyword research quarterly — search demand shifts
- Refresh top content every 6 months — maintain rankings
- Monitor competitors weekly — identify new opportunities
- Build links consistently — authority compounds over time
- Track Core Web Vitals daily — performance impacts rankings
- Validate schema markup after changes — avoid rich snippet loss
- Export reports for stakeholders — demonstrate ROI
- 每月运行技术审核 —— 尽早发现问题
- 每季度更新关键词研究 —— 搜索需求会变化
- 每6个月更新核心内容 —— 维持排名
- 每周监控竞品 —— 发现新机会
- 持续建设链接 —— 权威性随时间积累
- 每日跟踪Core Web Vitals —— 性能影响排名
- 修改后验证Schema标记 —— 避免富摘要丢失
- 导出报告给利益相关方 —— 展示投资回报率
Process multiple domains
处理多个域名
for domain in site1.com site2.com site3.com; do
/technical-seo https://$domain --output reports/$domain-audit.json
done
for domain in site1.com site2.com site3.com; do
/technical-seo https://$domain --output reports/$domain-audit.json
done
Batch keyword research from file
从文件批量进行关键词研究
while read keyword; do
/keyword-research "$keyword" --output keywords/$keyword.json
done < keyword-list.txt
while read keyword; do
/keyword-research "$keyword" --output keywords/$keyword.json
done < keyword-list.txt
Custom Scoring Functions
自定义评分函数
Edit
~/.claude/skills/seo-content-marketing/scoring.py
:
python
def custom_opportunity_score(volume, difficulty, relevance):
"""Custom opportunity calculation for niche market"""
if volume < 100:
return 0 # Ignore very low volume
base_score = (volume * relevance) / (difficulty * 10)
# Bonus for low difficulty in your niche
if difficulty < 30 and relevance > 0.7:
base_score *= 1.5
return round(base_score, 2)
编辑
~/.claude/skills/seo-content-marketing/scoring.py
:
python
def custom_opportunity_score(volume, difficulty, relevance):
"""针对细分市场的自定义机会计算"""
if volume < 100:
return 0 # 忽略极低搜索量
base_score = (volume * relevance) / (difficulty * 10)
# 细分市场低难度额外加分
if difficulty < 30 and relevance > 0.7:
base_score *= 1.5
return round(base_score, 2)
API Integration Example
API集成示例
python
import requests
import os
def export_to_dashboard(report_path):
"""Send SEO report to custom dashboard"""
with open(report_path) as f:
report_data = json.load(f)
response = requests.post(
'https://dashboard.example.com/api/seo-reports',
headers={'Authorization': f'Bearer {os.getenv("DASHBOARD_API_KEY")}'},
json=report_data
)
return response.json()
python
import requests
import os
def export_to_dashboard(report_path):
"""将SEO报告发送到自定义仪表盘"""
with open(report_path) as f:
report_data = json.load(f)
response = requests.post(
'https://dashboard.example.com/api/seo-reports',
headers={'Authorization': f'Bearer {os.getenv("DASHBOARD_API_KEY")}'},
json=report_data
)
return response.json()
License: MIT
Maintained by: Splitflucover93
Skill Version: 1.0.0
License: MIT
维护者: Splitflucover93
技能版本: 1.0.0