seo-content-marketing-claude-skill-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.
This suite provides AI coding agents with 10 specialized SEO and content marketing commands plus 5 multi-step workflows. Adapted from vincenthopf/My-Claude-Code, it delivers keyword research, content audits, SERP analysis, technical SEO diagnostics, and content strategy tools with structured output and progress tracking.
ara.so开发的技能——营销技能合集。
本套件为AI编码Agent提供10个专业的SEO和内容营销命令,以及5个多步骤工作流。改编自vincenthopf/My-Claude-Code,可提供关键词研究、内容审核、SERP分析、技术SEO诊断和内容策略工具,并支持结构化输出与进度跟踪。

What This Project Does

本项目功能

A command-line skill suite for AI agents performing SEO and content marketing tasks:
  • 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 — briefs, calendars, refresh workflows, AI pipelines
All commands output structured tables, progress bars, and prioritized action plans.
这是一款供AI Agent执行SEO和内容营销任务的命令行技能套件:
  • 关键词研究 — 聚类、机会评分、SERP意图映射
  • 内容审核 — 质量评分、重复内容检测、关键词 cannibalization(内部竞争)报告
  • 技术SEO — 抓取预算、Core Web Vitals、Schema标记、可索引性
  • 竞品分析 — 反向链接差距、主题差距、特色摘要机会
  • 内容策略 — 内容 brief( brief保留英文)、日历、更新工作流、AI流水线
所有命令均输出结构化表格、进度条和优先级行动计划。

Installation

安装

Clone and Register

克隆并注册

bash
undefined
bash
undefined

Create skills directory if it doesn't exist

若skills目录不存在则创建

mkdir -p ~/.claude/skills/
mkdir -p ~/.claude/skills/

Clone into skills directory

克隆到skills目录

git clone https://github.com/Splitflucover93/r12-vincenthopf-my-claude-code-seo.git
~/.claude/skills/seo-content-marketing/
git clone https://github.com/Splitflucover93/r12-vincenthopf-my-claude-code-seo.git
~/.claude/skills/seo-content-marketing/

In Claude Code session, load the skill

在Claude Code会话中加载技能

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

Verify Installation

验证安装

Check available commands:
bash
/help seo
You should see all 10 commands listed.
查看可用命令:
bash
/help seo
你应该能看到所有10个命令的列表。

Core Commands

核心命令

1. Keyword Research

1. 关键词研究

Perform deep keyword clustering with opportunity scoring.
bash
undefined
执行深度关键词聚类并进行机会评分。
bash
undefined

Basic keyword research

基础关键词研究

/keyword-research "marketing automation"
/keyword-research "marketing automation"

With options

带选项的研究

/keyword-research "content marketing" --depth full --export csv
/keyword-research "content marketing" --depth full --export csv

Multiple seed keywords

多个种子关键词

/keyword-research "seo,backlinks,serp" --cluster intent

**Output Structure:**
┌──────────────────────┬────────┬──────┬────────────┬──────────┐ │ Keyword │ Volume │ KD │ Intent │ Priority │ ├──────────────────────┼────────┼──────┼────────────┼──────────┤ │ marketing automation │ 22,200 │ 68 │ Commercial │ 🔴 High │ │ email automation │ 14,800 │ 52 │ Commercial │ 🟠 Med │ │ workflow automation │ 8,100 │ 45 │ Info │ 🟡 Low │ └──────────────────────┴────────┴──────┴────────────┴──────────┘
undefined
/keyword-research "seo,backlinks,serp" --cluster intent

**输出结构:**
┌──────────────────────┬────────┬──────┬────────────┬──────────┐ │ Keyword │ Volume │ KD │ Intent │ Priority │ ├──────────────────────┼────────┼──────┼────────────┼──────────┤ │ marketing automation │ 22,200 │ 68 │ Commercial │ 🔴 High │ │ email automation │ 14,800 │ 52 │ Commercial │ 🟠 Med │ │ workflow automation │ 8,100 │ 45 │ Info │ 🟡 Low │ └──────────────────────┴────────┴──────┴────────────┴──────────┘
undefined

2. Content Audit

2. 内容审核

Full-site content quality analysis with duplication and cannibalization checks.
bash
undefined
全站点内容质量分析,包含重复内容和关键词内部竞争检查。
bash
undefined

Full site audit

全站点审核

/content-audit --scope full --output md
/content-audit --scope full --output md

Specific path

指定路径

/content-audit --path /blog --format json
/content-audit --path /blog --format json

Export results

导出结果

/content-audit --scope full --export results.csv

**Options:**
- `--scope` : `full` | `path` | `urls`
- `--output` : `md` | `json` | `html`
- `--export` : file path for CSV export

**Example Output:**
Content Quality Breakdown: Excellent (90-100): 24 pages (12%) Good (70-89): 89 pages (44%) Fair (50-69): 67 pages (33%) Poor (0-49): 22 pages (11%)
Issues Found: 🔴 Thin content (<300 words): 18 pages 🔴 Duplicate titles: 7 pages 🟠 Keyword cannibalization: 12 page clusters 🟡 Missing meta descriptions: 34 pages
undefined
/content-audit --scope full --export results.csv

**选项:**
- `--scope` : `full` | `path` | `urls`
- `--output` : `md` | `json` | `html`
- `--export` : CSV导出文件路径

**示例输出:**
Content Quality Breakdown: Excellent (90-100): 24 pages (12%) Good (70-89): 89 pages (44%) Fair (50-69): 67 pages (33%) Poor (0-49): 22 pages (11%)
Issues Found: 🔴 Thin content (<300 words): 18 pages 🔴 Duplicate titles: 7 pages 🟠 Keyword cannibalization: 12 page clusters 🟡 Missing meta descriptions: 34 pages
undefined

3. Technical SEO Audit

3. 技术SEO审核

Comprehensive technical SEO diagnostics.
bash
undefined
全面的技术SEO诊断。
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 depth limit

设置深度限制

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

**Check Categories:**
- `crawl` — robots.txt, sitemap, crawl budget
- `vitals` — Core Web Vitals (LCP, FID, CLS)
- `schema` — structured data validation
- `mobile` — mobile-friendliness
- `index` — indexability issues
/technical-seo https://example.com --depth 500

**检查类别:**
- `crawl` — robots.txt、站点地图、抓取预算
- `vitals` — Core Web Vitals(LCP、FID、CLS)
- `schema` — 结构化数据验证
- `mobile` — 移动端友好性
- `index` — 可索引性问题

4. Content Brief Generator

4. 内容Brief生成器

AI-generated SEO content briefs with NLP terms and structure.
bash
undefined
基于AI生成的SEO内容Brief,包含NLP术语和结构框架。
bash
undefined

Generate brief

生成Brief

/content-brief "email marketing best practices"
/content-brief "email marketing best practices"

With competitor analysis

包含竞品分析

/content-brief "seo checklist" --competitors 5
/content-brief "seo checklist" --competitors 5

Specify word count target

指定目标字数

/content-brief "link building guide" --words 2500

**Output Includes:**
- Primary and secondary keywords
- Search intent analysis
- Recommended headings structure
- NLP/LSI terms to include
- Word count targets
- Competitor content gaps
/content-brief "link building guide" --words 2500

**输出包含:**
- 主关键词和次关键词
- 搜索意图分析
- 推荐标题结构
- 需包含的NLP/LSI术语
- 目标字数
- 竞品内容差距

5. Competitor Gap Analysis

5. 竞品差距分析

Identify backlink, topic, and featured snippet opportunities.
bash
undefined
识别反向链接、主题和特色摘要机会。
bash
undefined

Full gap analysis

全差距分析

/competitor-gap https://yoursite.com --competitors "competitor1.com,competitor2.com"
/competitor-gap https://yoursite.com --competitors "competitor1.com,competitor2.com"

Specific gap types

指定差距类型

/competitor-gap https://yoursite.com --type backlinks --competitors "competitor.com"
/competitor-gap https://yoursite.com --type backlinks --competitors "competitor.com"

Export opportunities

导出机会列表

/competitor-gap https://yoursite.com --competitors "comp.com" --export gaps.json

**Gap Types:**
- `backlinks` — linking domains they have, you don't
- `topics` — content topics they rank for
- `snippets` — featured snippet opportunities
- `keywords` — ranking keyword gaps
/competitor-gap https://yoursite.com --competitors "comp.com" --export gaps.json

**差距类型:**
- `backlinks` — 竞品拥有但你没有的外链域名
- `topics` — 竞品排名的内容主题
- `snippets` — 特色摘要机会
- `keywords` — 排名关键词差距

6. SERP Monitoring

6. SERP监控

Daily rank tracking with volatility alerts.
bash
undefined
每日排名跟踪及波动警报。
bash
undefined

Monitor keywords

监控关键词

/serp-monitor --keywords "keyword1,keyword2,keyword3"
/serp-monitor --keywords "keyword1,keyword2,keyword3"

Load from file

从文件加载关键词

/serp-monitor --file keywords.txt
/serp-monitor --file keywords.txt

Set alert threshold

设置警报阈值

/serp-monitor --keywords "brand term" --alert-drop 3

**Tracked Metrics:**
- Current position
- Position change (day/week/month)
- SERP volatility score
- CTR optimization opportunities
- Featured snippet status
/serp-monitor --keywords "brand term" --alert-drop 3

**跟踪指标:**
- 当前排名
- 排名变化(日/周/月)
- SERP波动评分
- CTR优化机会
- 特色摘要状态

7. Link Prospecting

7. 外链 prospecting(挖掘)

Generate quality backlink prospect lists with filtering.
bash
undefined
生成高质量外链挖掘列表并支持筛选。
bash
undefined

Find prospects

寻找潜在外链资源

/link-prospecting "marketing blogs" --min-da 30
/link-prospecting "marketing blogs" --min-da 30

Industry-specific

特定行业

/link-prospecting --industry saas --type "guest-post,resource-page"
/link-prospecting --industry saas --type "guest-post,resource-page"

Export with outreach templates

导出包含 outreach( outreach保留英文)模板

/link-prospecting "tech publications" --export prospects.csv --templates

**Filters:**
- `--min-da` : minimum Domain Authority
- `--min-dr` : minimum Domain Rating
- `--type` : prospect type (guest-post, resource-page, broken-link, etc.)
- `--industry` : industry filter
/link-prospecting "tech publications" --export prospects.csv --templates

**筛选条件:**
- `--min-da` : 最低域名权威值(Domain Authority)
- `--min-dr` : 最低域名评级(Domain Rating)
- `--type` : 资源类型(guest-post、resource-page、broken-link等)
- `--industry` : 行业筛选

8. Page Speed SEO Audit

8. 页面速度SEO审核

Performance diagnostics mapped to ranking impact.
bash
undefined
与排名影响关联的性能诊断。
bash
undefined

Audit page speed

审核页面速度

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

Mobile-specific

移动端专属

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

Batch audit

批量审核

/page-speed-seo --file urls.txt --export speed-report.json

**Analyzes:**
- LCP (Largest Contentful Paint)
- FID (First Input Delay)
- CLS (Cumulative Layout Shift)
- Render-blocking resources
- SEO ranking impact score
/page-speed-seo --file urls.txt --export speed-report.json

**分析内容:**
- LCP(最大内容绘制)
- FID(首次输入延迟)
- CLS(累积布局偏移)
- 阻塞渲染资源
- SEO排名影响评分

9. Local SEO Audit

9. 本地SEO审核

NAP consistency, Google Business Profile, and local citation audit.
bash
undefined
NAP一致性、Google商家资料及本地引用审核。
bash
undefined

Local SEO audit

本地SEO审核

/local-seo "Business Name, City, State"
/local-seo "Business Name, City, State"

With citation check

包含引用检查

/local-seo "Acme Corp, Austin, TX" --citations 50
/local-seo "Acme Corp, Austin, TX" --citations 50

Export report

导出报告

/local-seo "Company Name" --export local-audit.pdf

**Checks:**
- NAP (Name, Address, Phone) consistency
- Google Business Profile optimization
- Local citation presence and accuracy
- Review signals
- Local schema markup
/local-seo "Company Name" --export local-audit.pdf

**检查项:**
- NAP(名称、地址、电话)一致性
- Google商家资料优化
- 本地引用存在性及准确性
- 评论信号
- 本地Schema标记

10. Content Calendar

10. 内容日历

Data-driven editorial calendar from search demand and seasonality.
bash
undefined
基于搜索需求和季节性的数据驱动型编辑日历。
bash
undefined

Generate calendar

生成日历

/content-calendar --topics "seo,content marketing" --months 3
/content-calendar --topics "seo,content marketing" --months 3

With search trends

包含搜索趋势

/content-calendar --topics "email marketing" --months 6 --trends
/content-calendar --topics "email marketing" --months 6 --trends

Export to calendar format

导出为日历格式

/content-calendar --topics "social media" --export calendar.ics
undefined
/content-calendar --topics "social media" --export calendar.ics
undefined

Workflows (Multi-Step)

工作流(多步骤)

Full SEO Sprint

完整SEO冲刺

Complete 12-step SEO audit and optimization workflow.
bash
/workflows:full-seo-sprint https://example.com --scope full
Steps:
  1. Technical audit
  2. Keyword research
  3. Competitor gap analysis
  4. Content audit
  5. Keyword mapping
  6. Content gaps identification
  7. Quick wins list
  8. Content refresh plan
  9. New content plan
  10. Technical fixes prioritization
  11. Link building strategy
  12. Measurement framework
包含12步骤的完整SEO审核与优化工作流。
bash
/workflows:full-seo-sprint https://example.com --scope full
步骤:
  1. 技术审核
  2. 关键词研究
  3. 竞品差距分析
  4. 内容审核
  5. 关键词映射
  6. 内容差距识别
  7. 快速获胜列表
  8. 内容更新计划
  9. 新内容规划
  10. 技术修复优先级排序
  11. 外链建设策略
  12. 衡量框架

Launch SEO

上线前SEO

Pre-launch SEO checklist with validation.
bash
/workflows:launch-seo https://staging.example.com
Validates:
  • Canonical tags
  • Hreflang (if international)
  • XML sitemap
  • Robots.txt
  • Schema markup
  • Page speed
  • Mobile responsiveness
  • Index prevention removal
包含验证的上线前SEO检查清单。
bash
/workflows:launch-seo https://staging.example.com
验证内容:
  • 规范标签(Canonical tags)
  • Hreflang(若为国际站点)
  • XML站点地图
  • Robots.txt
  • Schema标记
  • 页面速度
  • 移动端响应性
  • 索引限制移除

Content Refresh

内容更新

Identify and refresh underperforming pages.
bash
/workflows:content-refresh --min-age 180 --max-position 20
Process:
  1. Identify declining pages
  2. Analyze content gaps vs. top-rankers
  3. Generate refresh briefs
  4. Prioritize by traffic potential
  5. Create refresh schedule
识别并更新表现不佳的页面。
bash
/workflows:content-refresh --min-age 180 --max-position 20
流程:
  1. 识别流量下滑页面
  2. 分析与顶级排名页面的内容差距
  3. 生成更新Brief
  4. 按流量潜力排序优先级
  5. 创建更新时间表

Authority Building

权威建设

End-to-end digital PR and link-building campaign.
bash
/workflows:authority-building --industry saas --target-links 50
Stages:
  1. Competitor backlink analysis
  2. Prospect identification
  3. Content asset planning
  4. Outreach template creation
  5. Campaign tracking setup
端到端的数字PR和外链建设活动。
bash
/workflows:authority-building --industry saas --target-links 50
阶段:
  1. 竞品反向链接分析
  2. 潜在资源识别
  3. 内容资产规划
  4. Outreach模板创建
  5. 活动跟踪设置

AI Content Pipeline

AI内容流水线

Automated content creation workflow.
bash
/workflows:ai-content-pipeline --keywords "keyword1,keyword2" --auto-publish false
Pipeline:
  1. Keyword research
  2. Brief generation
  3. Draft creation
  4. SEO optimization
  5. Quality check
  6. Publishing (if
    --auto-publish true
    )
自动化内容创建工作流。
bash
/workflows:ai-content-pipeline --keywords "keyword1,keyword2" --auto-publish false
流水线:
  1. 关键词研究
  2. Brief生成
  3. 草稿创作
  4. SEO优化
  5. 质量检查
  6. 发布(若
    --auto-publish true

Configuration

配置

Environment Variables

环境变量

Create
.env
file in skill directory:
bash
undefined
在技能目录创建
.env
文件:
bash
undefined

API Keys (optional, for enhanced features)

API密钥(可选,用于增强功能)

SEO_API_KEY=your_api_key_here SERP_API_KEY=your_serp_api_key
SEO_API_KEY=your_api_key_here SERP_API_KEY=your_serp_api_key

Default Settings

默认设置

DEFAULT_COUNTRY=US DEFAULT_LANGUAGE=en DEFAULT_DEVICE=desktop
DEFAULT_COUNTRY=US DEFAULT_LANGUAGE=en DEFAULT_DEVICE=desktop

Output Preferences

输出偏好

OUTPUT_FORMAT=md EXPORT_PATH=./reports/
OUTPUT_FORMAT=md EXPORT_PATH=./reports/

Alert Thresholds

警报阈值

RANK_DROP_ALERT=3 VOLATILITY_THRESHOLD=0.5
undefined
RANK_DROP_ALERT=3 VOLATILITY_THRESHOLD=0.5
undefined

Skill Configuration

技能配置

Edit
~/.claude/skills/seo-content-marketing/config.yaml
:
yaml
undefined
编辑
~/.claude/skills/seo-content-marketing/config.yaml
yaml
undefined

Command defaults

命令默认值

defaults: keyword_research: depth: full cluster_method: intent export_format: csv
content_audit: scope: full min_word_count: 300 quality_threshold: 70
technical_seo: checks: [crawl, vitals, schema, mobile, index] depth: 1000
page_speed: device: both metrics: [lcp, fid, cls]
defaults: keyword_research: depth: full cluster_method: intent export_format: csv
content_audit: scope: full min_word_count: 300 quality_threshold: 70
technical_seo: checks: [crawl, vitals, schema, mobile, index] depth: 1000
page_speed: device: both metrics: [lcp, fid, cls]

API endpoints (if using external services)

API端点(若使用外部服务)

apis: serp_api: ${SERP_API_KEY} seo_tool: ${SEO_API_KEY}
apis: serp_api: ${SERP_API_KEY} seo_tool: ${SEO_API_KEY}

Output settings

输出设置

output: format: md show_progress: true export_path: ./reports/
undefined
output: format: md show_progress: true export_path: ./reports/
undefined

Real-World Examples

实际案例

Example 1: Complete Site Audit

案例1:完整站点审核

bash
undefined
bash
undefined

Step 1: Technical foundation

步骤1:技术基础审核

/technical-seo https://example.com --export tech-audit.json
/technical-seo https://example.com --export tech-audit.json

Step 2: Content analysis

步骤2:内容分析

/content-audit --scope full --export content-audit.csv
/content-audit --scope full --export content-audit.csv

Step 3: Keyword opportunities

步骤3:关键词机会

/keyword-research "main topic" --depth full --export keywords.csv
/keyword-research "main topic" --depth full --export keywords.csv

Step 4: Competitor gaps

步骤4:竞品差距

/competitor-gap https://example.com --competitors "comp1.com,comp2.com"
/competitor-gap https://example.com --competitors "comp1.com,comp2.com"

Step 5: Action plan generation

步骤5:生成行动计划

(AI will synthesize all reports into prioritized action plan)

(AI将综合所有报告生成优先级行动计划)

undefined
undefined

Example 2: Content Strategy for New Site

案例2:新站点内容策略

bash
undefined
bash
undefined

Research keywords

研究关键词

/keyword-research "industry topic" --cluster intent --export keywords.csv
/keyword-research "industry topic" --cluster intent --export keywords.csv

Analyze competitors

分析竞品

/competitor-gap --competitors "leader1.com,leader2.com" --type topics
/competitor-gap --competitors "leader1.com,leader2.com" --type topics

Generate content calendar

生成内容日历

/content-calendar --topics "topic1,topic2,topic3" --months 6 --export calendar.ics
/content-calendar --topics "topic1,topic2,topic3" --months 6 --export calendar.ics

Create first 5 briefs

创建前5个Brief

/content-brief "keyword 1" /content-brief "keyword 2"
/content-brief "keyword 1" /content-brief "keyword 2"

... etc

... 以此类推

undefined
undefined

Example 3: Recovery from Traffic Drop

案例3:流量下滑恢复

bash
undefined
bash
undefined

Identify affected pages

识别受影响页面

/serp-monitor --alert-drop 5 --period 30days
/serp-monitor --alert-drop 5 --period 30days

Audit those pages

审核这些页面

/content-audit --urls "url1,url2,url3"
/content-audit --urls "url1,url2,url3"

Run refresh workflow

运行更新工作流

/workflows:content-refresh --urls "url1,url2,url3"
/workflows:content-refresh --urls "url1,url2,url3"

Check technical issues

检查技术问题

/technical-seo --urls "url1,url2,url3" --checks vitals,index
undefined
/technical-seo --urls "url1,url2,url3" --checks vitals,index
undefined

Common Patterns

常见模式

Pattern 1: Monthly SEO Health Check

模式1:月度SEO健康检查

bash
#!/bin/bash
bash
#!/bin/bash

monthly-seo-check.sh

monthly-seo-check.sh

SITE="https://example.com" DATE=$(date +%Y-%m) EXPORT_DIR="./reports/$DATE"
mkdir -p "$EXPORT_DIR"
/technical-seo "$SITE" --export "$EXPORT_DIR/technical.json" /content-audit --scope full --export "$EXPORT_DIR/content.csv" /serp-monitor --file keywords.txt --export "$EXPORT_DIR/rankings.json" /page-speed-seo "$SITE" --export "$EXPORT_DIR/speed.json"
echo "Monthly SEO check complete. Reports in $EXPORT_DIR"
undefined
SITE="https://example.com" DATE=$(date +%Y-%m) EXPORT_DIR="./reports/$DATE"
mkdir -p "$EXPORT_DIR"
/technical-seo "$SITE" --export "$EXPORT_DIR/technical.json" /content-audit --scope full --export "$EXPORT_DIR/content.csv" /serp-monitor --file keywords.txt --export "$EXPORT_DIR/rankings.json" /page-speed-seo "$SITE" --export "$EXPORT_DIR/speed.json"
echo "Monthly SEO check complete. Reports in $EXPORT_DIR"
undefined

Pattern 2: Content Production Workflow

模式2:内容生产工作流

bash
undefined
bash
undefined

1. Research phase

1. 研究阶段

/keyword-research "$TOPIC" --export keywords.csv
/keyword-research "$TOPIC" --export keywords.csv

2. Brief creation (from top 10 keywords in CSV)

2. 创建Brief(从CSV中前10个关键词)

while IFS=, read -r keyword volume difficulty; do /content-brief "$keyword" --words 1500 --export "briefs/${keyword// /-}.md" done < <(tail -n +2 keywords.csv | head -10)
while IFS=, read -r keyword volume difficulty; do /content-brief "$keyword" --words 1500 --export "briefs/${keyword// /-}.md" done < <(tail -n +2 keywords.csv | head -10)

3. Calendar creation

3. 创建日历

/content-calendar --file keywords.csv --months 3 --export schedule.ics
undefined
/content-calendar --file keywords.csv --months 3 --export schedule.ics
undefined

Pattern 3: Link Building Campaign

模式3:外链建设活动

bash
undefined
bash
undefined

1. Find prospects

1. 寻找潜在资源

/link-prospecting "$INDUSTRY blogs" --min-da 30 --type guest-post --export prospects.csv
/link-prospecting "$INDUSTRY blogs" --min-da 30 --type guest-post --export prospects.csv

2. Analyze competitor backlinks

2. 分析竞品反向链接

/competitor-gap --type backlinks --competitors "$COMPETITORS" --export gaps.json
/competitor-gap --type backlinks --competitors "$COMPETITORS" --export gaps.json

3. Create outreach templates

3. 创建Outreach模板

/link-prospecting --templates --export outreach-templates/
/link-prospecting --templates --export outreach-templates/

4. Track campaign

4. 跟踪活动

(Monitor new backlinks over time)

(随时间监控新增反向链接)

undefined
undefined

Troubleshooting

故障排除

Command Not Found

命令未找到

bash
undefined
bash
undefined

Reload the skill

重新加载技能

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

Verify installation path

验证安装路径

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

Check for syntax errors in config

检查配置文件语法错误

cat ~/.claude/skills/seo-content-marketing/config.yaml
undefined
cat ~/.claude/skills/seo-content-marketing/config.yaml
undefined

Slow Performance on Large Sites

大型站点性能缓慢

bash
undefined
bash
undefined

Limit crawl depth

限制抓取深度

/technical-seo https://largesite.com --depth 500
/technical-seo https://largesite.com --depth 500

Audit specific paths only

仅审核指定路径

/content-audit --path /blog --depth 2
/content-audit --path /blog --depth 2

Use sampling for keyword research

关键词研究使用抽样

/keyword-research "topic" --sample 1000
undefined
/keyword-research "topic" --sample 1000
undefined

API Rate Limits

API速率限制

If using external SEO APIs:
bash
undefined
若使用外部SEO API:
bash
undefined

Check rate limit status

检查速率限制状态

echo $SEO_API_RATE_REMAINING
echo $SEO_API_RATE_REMAINING

Use batch mode with delays

使用带延迟的批量模式

/keyword-research --file keywords.txt --batch 10 --delay 2s
/keyword-research --file keywords.txt --batch 10 --delay 2s

Cache results

缓存结果

/keyword-research "topic" --cache 24h
undefined
/keyword-research "topic" --cache 24h
undefined

Export Failures

导出失败

bash
undefined
bash
undefined

Check write permissions

检查写入权限

ls -la ./reports/
ls -la ./reports/

Create export directory

创建导出目录

mkdir -p ./reports/
mkdir -p ./reports/

Specify full path

指定完整路径

/content-audit --export /full/path/to/reports/audit.csv
/content-audit --export /full/path/to/reports/audit.csv

Use alternative format

使用替代格式

/content-audit --output json > audit.json
undefined
/content-audit --output json > audit.json
undefined

Incomplete Data

数据不完整

bash
undefined
bash
undefined

Increase timeout for slow sites

为慢速站点增加超时时间

/technical-seo https://slowsite.com --timeout 60s
/technical-seo https://slowsite.com --timeout 60s

Retry failed requests

重试失败请求

/content-audit --scope full --retry 3
/content-audit --scope full --retry 3

Use cached SERP data

使用缓存的SERP数据

/serp-monitor --cache 12h --keywords "term"
undefined
/serp-monitor --cache 12h --keywords "term"
undefined

Integration Examples

集成示例

CI/CD Pipeline Integration

CI/CD流水线集成

yaml
undefined
yaml
undefined

.github/workflows/seo-check.yml

.github/workflows/seo-check.yml

name: SEO Audit
on: schedule: - cron: '0 0 * * 1' # Weekly on Monday workflow_dispatch:
jobs: seo-audit: runs-on: ubuntu-latest steps: - uses: actions/checkout@v3
  - name: Run Technical SEO Audit
    run: |
      /technical-seo ${{ secrets.SITE_URL }} \
        --export ./audit-results/technical.json
  
  - name: Check for Critical Issues
    run: |
      # Parse JSON and fail if critical issues found
      jq '.critical_issues | length' ./audit-results/technical.json | \
        awk '{if ($1 > 0) exit 1}'
  
  - name: Upload Report
    uses: actions/upload-artifact@v3
    with:
      name: seo-audit-report
      path: ./audit-results/
undefined
name: SEO Audit
on: schedule: - cron: '0 0 * * 1' # 每周一执行 workflow_dispatch:
jobs: seo-audit: runs-on: ubuntu-latest steps: - uses: actions/checkout@v3
  - name: Run Technical SEO Audit
    run: |
      /technical-seo ${{ secrets.SITE_URL }} \
        --export ./audit-results/technical.json
  
  - name: Check for Critical Issues
    run: |
      # 解析JSON并在发现严重问题时终止
      jq '.critical_issues | length' ./audit-results/technical.json | \
        awk '{if ($1 > 0) exit 1}'
  
  - name: Upload Report
    uses: actions/upload-artifact@v3
    with:
      name: seo-audit-report
      path: ./audit-results/
undefined

Slack Alert Integration

Slack警报集成

bash
#!/bin/bash
bash
#!/bin/bash

seo-alert.sh - Run daily and alert on rank drops

seo-alert.sh - 每日运行并在排名下滑时发送警报

SLACK_WEBHOOK="${SLACK_WEBHOOK_URL}"
REPORT=$(/serp-monitor --alert-drop 3 --format json)
if echo "$REPORT" | jq -e '.alerts | length > 0' > /dev/null; then ALERT_COUNT=$(echo "$REPORT" | jq '.alerts | length')
curl -X POST "$SLACK_WEBHOOK"
-H 'Content-Type: application/json'
-d "{"text": "🚨 SEO Alert: $ALERT_COUNT keyword(s) dropped 3+ positions"}" fi

---

**Source:** https://github.com/Splitflucover93/r12-vincenthopf-my-claude-code-seo

**License:** MIT
SLACK_WEBHOOK="${SLACK_WEBHOOK_URL}"
REPORT=$(/serp-monitor --alert-drop 3 --format json)
if echo "$REPORT" | jq -e '.alerts | length > 0' > /dev/null; then ALERT_COUNT=$(echo "$REPORT" | jq '.alerts | length')
curl -X POST "$SLACK_WEBHOOK"
-H 'Content-Type: application/json'
-d "{"text": "🚨 SEO警报:$ALERT_COUNT个关键词排名下降3位以上"}" fi

---

**来源:** https://github.com/Splitflucover93/r12-vincenthopf-my-claude-code-seo

**许可证:** MIT