splitflucover93-r12-seo-content-marketing-suite

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

📈 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.
ara.so开发的技能集——营销技能合集。
这是一款基于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步交互模式,包含可视化进度跟踪、优先级结果划分和限时行动计划。

Installation

安装方法

Method 1: Manual Installation

方法1:手动安装

bash
undefined
bash
undefined

Clone the repository

克隆仓库

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
undefined
/read ~/.claude/skills/seo-content-marketing/SKILL.md
undefined

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

Verification

验证安装

After installation, verify the skill is available:
bash
undefined
安装完成后,验证技能是否可用:
bash
undefined

In Claude Code session:

在Claude Code会话中执行:

/skills list
/skills list

Should show: seo-content-marketing

应显示:seo-content-marketing

undefined
undefined

Core Commands

核心命令

All commands output structured data with progress tracking, findings tables, and actionable recommendations.
所有命令输出结构化数据,包含进度跟踪、结果表格和可执行建议。

1. Keyword Research

1. 关键词研究

bash
undefined
bash
undefined

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

Export results

导出结果

/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意图分类(信息类/商业类/交易类/导航类)
- 机会评分(搜索量 × 相关性 / 难度)
- 相关问题及实体

2. Content Audit

2. 内容审核

bash
undefined
bash
undefined

Full site audit

全站审核

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

Specific section

指定板块审核

/content-audit --scope /blog/* --url https://example.com
/content-audit --scope /blog/* --url https://example.com

With export

导出报告

/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审核

bash
undefined
bash
undefined

Full technical audit

完整技术审核

/technical-seo https://example.com
/technical-seo https://example.com

Specific checks

指定检测项

/technical-seo https://example.com --checks crawl,vitals,schema
/technical-seo https://example.com --checks crawl,vitals,schema

With detailed output

详细输出

/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. 竞品差距分析

bash
undefined
bash
undefined

Backlink gap

反向链接差距

/competitor-gap backlinks --primary https://mysite.com --competitors https://competitor1.com,https://competitor2.com
/competitor-gap backlinks --primary https://mysite.com --competitors https://competitor1.com,https://competitor2.com

Topic gap

话题差距

/competitor-gap topics --primary https://mysite.com --competitors https://competitor1.com --min-traffic 1000
/competitor-gap topics --primary https://mysite.com --competitors https://competitor1.com --min-traffic 1000

Featured snippet opportunities

特色摘要机会

/competitor-gap snippets --primary https://mysite.com --competitors https://competitor1.com,https://competitor2.com

**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
/competitor-gap snippets --primary https://mysite.com --competitors https://competitor1.com,https://competitor2.com

**返回结果:**
- 链接到竞品但未链接到你的域名
- 竞品排名但你未排名的话题
- 你可以抢占的特色摘要位置
- 内容格式差距

5. Content Brief Generation

5. 内容Brief生成

bash
undefined
bash
undefined

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 "b2b lead generation strategies" --words 2500 --competitors https://hubspot.com/blog/lead-generation,https://salesforce.com/blog/b2b-leads
/content-brief "b2b lead generation strategies" --words 2500 --competitors https://hubspot.com/blog/lead-generation,https://salesforce.com/blog/b2b-leads

Export as template

导出为模板

/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监控

bash
undefined
bash
undefined

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

With daily alerts

设置每日警报

/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. 链接潜在合作方挖掘

bash
undefined
bash
undefined

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

Filtered by type

按类型筛选

/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影响分析

bash
undefined
bash
undefined

Analyze page speed impact

分析页面速度影响

With mobile focus

聚焦移动端

/page-speed-seo https://example.com --device mobile --output speed-report.json
/page-speed-seo https://example.com --device mobile --output speed-report.json

Multiple pages

多页面分析

/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审核

bash
undefined
bash
undefined

Full local audit

完整本地审核

/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

GBP optimization

GBP优化

/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. 内容日历生成

bash
undefined
bash
undefined

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:
  1. Technical audit
  2. Content audit
  3. Keyword research
  4. Competitor gap analysis
  5. Content brief generation
  6. Internal linking map
  7. Schema markup recommendations
  8. Page speed optimization
  9. Link prospecting
  10. Content calendar
  11. Tracking setup
  12. Implementation checklist
12步全面SEO项目:
bash
/workflows:full-seo-sprint https://example.com --output sprint-report/
步骤:
  1. 技术审核
  2. 内容审核
  3. 关键词研究
  4. 竞品差距分析
  5. 内容Brief生成
  6. 内部链接映射
  7. Schema标记建议
  8. 页面速度优化
  9. 链接潜在合作方挖掘
  10. 内容日历
  11. 跟踪设置
  12. 实施清单

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:
  1. Identify pages with ranking losses (>20%)
  2. Analyze current content gaps
  3. Generate refresh briefs
  4. Update recommendations
  5. Internal link injection opportunities
  6. Re-crawl triggers
bash
/workflows:content-refresh https://example.com --pages underperforming --threshold -20
流程:
  1. 识别排名下滑超过20%的页面
  2. 分析当前内容差距
  3. 生成更新brief
  4. 更新建议
  5. 内部链接注入机会
  6. 重新抓取触发

4. Authority Building Campaign

4. 权威提升活动

bash
/workflows:authority-building --domain example.com --target-da 50 --timeline 6-months
Campaign steps:
  1. Current authority baseline
  2. Competitor backlink analysis
  3. Link prospect discovery
  4. Outreach campaign setup
  5. Content asset creation
  6. Digital PR opportunities
  7. Progress tracking
bash
/workflows:authority-building --domain example.com --target-da 50 --timeline 6-months
活动步骤:
  1. 当前权威基准
  2. 竞品反向链接分析
  3. 链接潜在合作方挖掘
  4. 外推活动设置
  5. 内容资产创建
  6. 数字公关机会
  7. 进度跟踪

5. AI Content Pipeline

5. AI内容流水线

Automated content production workflow:
bash
/workflows:ai-content-pipeline --keywords keywords.csv --output-dir content-pipeline/
Pipeline:
  1. Keyword clustering
  2. Brief generation
  3. Content outline creation
  4. Draft generation (AI-assisted)
  5. SEO optimization pass
  6. Internal linking injection
  7. Publishing checklist
自动化内容生产工作流:
bash
/workflows:ai-content-pipeline --keywords keywords.csv --output-dir content-pipeline/
流水线:
  1. 关键词聚类
  2. Brief生成
  3. 内容大纲创建
  4. 草稿生成(AI辅助)
  5. SEO优化环节
  6. 内部链接注入
  7. 发布清单

Configuration

配置

Environment Variables

环境变量

bash
undefined
bash
undefined

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

可选集成

export OPENAI_API_KEY="your-key-here" # For AI content generation export SLACK_WEBHOOK_URL="https://hooks.slack.com/services/YOUR/WEBHOOK" # For alerts
undefined
export OPENAI_API_KEY="your-key-here" # 用于AI内容生成 export SLACK_WEBHOOK_URL="https://hooks.slack.com/services/YOUR/WEBHOOK" # 用于警报
undefined

Configuration File

配置文件

Create
~/.claude/skills/seo-content-marketing/config.yaml
:
yaml
undefined
创建
~/.claude/skills/seo-content-marketing/config.yaml
yaml
undefined

Default settings

默认设置

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

API rate limits

API速率限制

rate_limits: ahrefs: 500 # requests per day semrush: 10000 # requests per month
rate_limits: ahrefs: 500 # 每日请求数 semrush: 10000 # 每月请求数

Export settings

导出设置

export: default_dir: ./seo-reports timestamp_files: true formats: [markdown, json, csv]
undefined
export: default_dir: ./seo-reports timestamp_files: true formats: [markdown, json, csv]
undefined

Custom Workflows

自定义工作流

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设置

bash
undefined
bash
undefined

Step 1: Pre-launch validation

步骤1:上线前验证

/workflows:launch-seo https://staging.newsite.com --output launch-checklist.md
/workflows:launch-seo https://staging.newsite.com --output launch-checklist.md

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
undefined
/content-brief "top keyword from research" --output briefs/article-1.md
undefined

Pattern 2: Monthly SEO Review

模式2:月度SEO复盘

bash
undefined
bash
undefined

Step 1: Technical health check

步骤1:技术健康检测

/technical-seo https://example.com --output monthly-reports/$(date +%Y-%m)-tech.json
/technical-seo https://example.com --output monthly-reports/$(date +%Y-%m)-tech.json

Step 2: Ranking changes

步骤2:排名变化跟踪

/serp-monitor --keywords tracked-keywords.txt --url https://example.com --compare 30-days
/serp-monitor --keywords tracked-keywords.txt --url https://example.com --compare 30-days

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
undefined
/keyword-research "core topic" --discover-new --min-volume 300 --output new-opportunities.json
undefined

Pattern 3: Competitor Overtake Campaign

模式3:竞品超越活动

bash
undefined
bash
undefined

Step 1: Identify competitor

步骤1:确定竞品

export COMPETITOR_URL="https://topcompetitor.com"
export COMPETITOR_URL="https://topcompetitor.com"

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/
undefined
/workflows:ai-content-pipeline --keywords gaps.json --output-dir competitor-content/
undefined

Pattern 4: Recovering Lost Rankings

模式4:恢复丢失排名

bash
undefined
bash
undefined

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:内容更新工作流

/workflows:content-refresh https://example.com --pages declining.json
/workflows:content-refresh https://example.com --pages declining.json

Step 3: Technical issues check

步骤3:技术问题检测

/technical-seo https://example.com --focus declining-urls.txt
/technical-seo https://example.com --focus declining-urls.txt

Step 4: Backlink health

步骤4:反向链接维护

/link-prospecting "core topics" --context "We're updating our content" --output refresh-links.csv
undefined
/link-prospecting "core topics" --context "We're updating our content" --output refresh-links.csv
undefined

Pattern 5: Local Business SEO

模式5:本地商家SEO

bash
undefined
bash
undefined

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
undefined
/local-seo "Business Name" --checks gbp --recommendations detailed
undefined

Integration Examples

集成示例

Export to Google Sheets

导出到Google Sheets

bash
undefined
bash
undefined

Generate report

生成报告

/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"
undefined
/export report.json --to google-sheets --sheet "SEO Research 2026"
undefined

Slack Notifications

Slack通知

Configure webhook in config.yaml, then:
bash
undefined
在config.yaml中配置webhook,然后执行:
bash
undefined

Enable alerts for rank changes

启用排名变化警报

/serp-monitor --keywords keywords.txt --url https://example.com --alert slack --threshold 3
undefined
/serp-monitor --keywords keywords.txt --url https://example.com --alert slack --threshold 3
undefined

CI/CD Integration

CI/CD集成

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

Troubleshooting

故障排除

Command Not Found

命令未找到

bash
undefined
bash
undefined

Verify skill installation

验证技能安装

ls ~/.claude/skills/seo-content-marketing/
ls ~/.claude/skills/seo-content-marketing/

Re-register skill

重新注册技能

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

Check skills list

查看技能列表

/skills list
undefined
/skills list
undefined

API Rate Limits

API速率限制

yaml
undefined
yaml
undefined

Check current usage

查看当前使用情况

/status api-usage
/status api-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
undefined
cache: enabled: true ttl: 3600 # 1小时
undefined

Slow Performance

性能缓慢

bash
undefined
bash
undefined

Reduce crawl depth

降低抓取深度

/technical-seo https://example.com --max-depth 3
/technical-seo https://example.com --max-depth 3

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

使用并行处理

/content-audit --scope full --url https://example.com --parallel 4
undefined
/content-audit --scope full --url https://example.com --parallel 4
undefined

Missing Dependencies

依赖缺失

bash
undefined
bash
undefined

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

Verify integrations

验证集成

/diagnose --check-dependencies
undefined
/diagnose --check-dependencies
undefined

Invalid Output

输出无效

bash
undefined
bash
undefined

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
undefined
cat report.json | python -m json.tool
undefined

Authentication Errors

认证错误

bash
undefined
bash
undefined

Verify API keys are set

验证API密钥已设置

env | grep API_KEY
env | grep API_KEY

Test connection

测试连接

/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
undefined
gcloud auth application-default login
undefined

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(低):微小改进,方便时处理

Best Practices

最佳实践

  1. Run technical audits monthly — catch issues early
  2. Update keyword research quarterly — search demand shifts
  3. Refresh top content every 6 months — maintain rankings
  4. Monitor competitors weekly — identify new opportunities
  5. Build links consistently — authority compounds over time
  6. Track Core Web Vitals daily — performance impacts rankings
  7. Validate schema markup after changes — avoid rich snippet loss
  8. Export reports for stakeholders — demonstrate ROI
  1. 每月运行技术审核 —— 尽早发现问题
  2. 每季度更新关键词研究 —— 搜索需求会变化
  3. 每6个月更新核心内容 —— 维持排名
  4. 每周监控竞品 —— 发现新机会
  5. 持续建设链接 —— 权威性随时间积累
  6. 每日跟踪Core Web Vitals —— 性能影响排名
  7. 修改后验证Schema标记 —— 避免富摘要丢失
  8. 导出报告给利益相关方 —— 展示投资回报率

Advanced Usage

高级用法

Batch Processing

批量处理

bash
undefined
bash
undefined

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
undefined
while read keyword; do /keyword-research "$keyword" --output keywords/$keyword.json done < keyword-list.txt
undefined

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()

Resources

资源


License: MIT
Maintained by: Splitflucover93
Skill Version: 1.0.0

License: MIT
维护者: Splitflucover93
技能版本: 1.0.0