seo-content-marketing-skill-suite-claude

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

SEO & Content Marketing Skill Suite for Claude

适用于Claude的SEO与内容营销技能套件

Skill by ara.so — Marketing Skills collection.

This skill suite provides specialized SEO and content marketing capabilities derived from the GetBindu/awesome-claude-code-and-skills project. It includes 10 specialized commands and 5 multi-step workflows for keyword research, content audits, SERP analysis, technical SEO, and content strategy—all with structured output and progress tracking.

由ara.so开发的技能——营销技能合集。

本技能套件提供源自GetBindu/awesome-claude-code-and-skills项目的专业SEO和内容营销能力。它包含10个专业命令和5个多步骤工作流，用于关键词研究、内容审计、SERP分析、技术SEO和内容策略——所有功能均支持结构化输出和进度跟踪。

What This Project Does

本项目功能

The SEO & Content Marketing Skill Suite transforms Claude into an SEO specialist capable of:

Keyword Research — clustering, opportunity scoring, and SERP intent mapping
Content Audits — quality scoring, duplication detection, and cannibalization reports
Technical SEO — crawl budget, Core Web Vitals, schema markup, and indexability
Competitor Analysis — backlink gaps, topic gaps, and featured snippet opportunities
Content Strategy — AI-generated briefs, editorial calendars, and content pipelines

Each command follows a consistent 5-step interaction pattern with visual progress tracking, findings tables, prioritized action plans, and suggested next steps.

SEO与内容营销技能套件可将Claude转变为SEO专家，能够完成以下工作：

关键词研究 — 聚类、机会评分和SERP意图映射
内容审计 — 质量评分、重复内容检测和关键词 cannibalization（内部竞争）报告
技术SEO — 抓取预算、Core Web Vitals、Schema标记和可索引性分析
竞争对手分析 — 反向链接差距、主题差距和特色摘要机会识别
内容策略 — AI生成的简报、编辑日历和内容流水线

每个命令遵循一致的5步交互模式，包含可视化进度跟踪、结果表格、优先级行动计划和建议后续步骤。

Installation

安装

Quick Install

快速安装

bash

undefined

bash

undefined

Clone the repository

克隆仓库

git clone https://github.com/OctagonWoodpecker/r07-getbindu-awesome-claude-code-and-skills-seo.git

Copy to Claude skills directory

复制到Claude技能目录

cp -r r07-getbindu-awesome-claude-code-and-skills-seo ~/.claude/skills/seo-content-marketing/

Or use as a standalone skill

或作为独立技能使用

cd r07-getbindu-awesome-claude-code-and-skills-seo

undefined

cd r07-getbindu-awesome-claude-code-and-skills-seo

undefined

Register in Claude Code

在Claude Code中注册

In a Claude Code session:

bash

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

Or reference directly:

bash

/read ./SKILL.md

在Claude Code会话中：

bash

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

或直接引用：

bash

/read ./SKILL.md

Core Commands

核心命令

Keyword Research

关键词研究

Deep keyword clustering with opportunity scoring and SERP intent mapping.

bash

/keyword-research <target_domain_or_topic>

深度关键词聚类，包含机会评分和SERP意图映射。

bash

/keyword-research <target_domain_or_topic>

Examples

示例

/keyword-research example.com /keyword-research "saas marketing automation" /keyword-research --seed "project management" --competitors 5


**Options:**
- `--seed <keyword>` — starting seed keyword
- `--competitors <N>` — number of competitor sites to analyze (default: 3)
- `--cluster-by <intent|topic|difficulty>` — clustering method
- `--output <json|md|csv>` — output format

**Returns:**
- Keyword clusters with search volume and difficulty
- SERP intent classification (informational, navigational, transactional, commercial)
- Opportunity scores (volume × relevance / difficulty)
- Quick-win keywords (low competition, decent volume)

/keyword-research example.com /keyword-research "saas marketing automation" /keyword-research --seed "project management" --competitors 5


**选项：**
- `--seed <keyword>` — 起始种子关键词
- `--competitors <N>` — 要分析的竞争对手网站数量（默认：3）
- `--cluster-by <intent|topic|difficulty>` — 聚类方式
- `--output <json|md|csv>` — 输出格式

**返回结果：**
- 包含搜索量和难度的关键词聚类
- SERP意图分类（信息型、导航型、交易型、商业型）
- 机会评分（搜索量 × 相关性 / 难度）
- 快速获胜关键词（低竞争、可观搜索量）

Content Audit

内容审计

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

bash

/content-audit <domain> [--scope <full|subset>]

全站点内容质量评估，包含重复内容和关键词内部竞争检测。

bash

/content-audit <domain> [--scope <full|subset>]

Examples

示例

/content-audit example.com --scope full /content-audit example.com --scope subset --sample 100 /content-audit example.com --output md --min-quality 60


**Options:**
- `--scope <full|subset>` — audit entire site or sample
- `--sample <N>` — number of pages to sample
- `--min-quality <0-100>` — quality threshold for reporting
- `--check-duplicates` — detect duplicate/thin content
- `--check-cannibalization` — find keyword cannibalization

**Returns:**
- Content quality scores (0-100) per page
- Thin content alerts (<300 words, low unique content)
- Duplicate content groups
- Keyword cannibalization clusters
- Priority action list

/content-audit example.com --scope full /content-audit example.com --scope subset --sample 100 /content-audit example.com --output md --min-quality 60


**选项：**
- `--scope <full|subset>` — 审计整个站点或抽样
- `--sample <N>` — 抽样页面数量
- `--min-quality <0-100>` — 报告的质量阈值
- `--check-duplicates` — 检测重复/低质内容
- `--check-cannibalization` — 查找关键词内部竞争

**返回结果：**
- 每页内容质量评分（0-100）
- 低质内容警报（<300字、低原创内容）
- 重复内容组
- 关键词内部竞争聚类
- 优先级行动列表

Technical SEO Audit

技术SEO审计

Comprehensive technical SEO analysis including Core Web Vitals and indexability.

bash

/technical-seo <domain> [--focus <all|speed|crawl|schema>]

全面的技术SEO分析，包含Core Web Vitals和可索引性检查。

bash

/technical-seo <domain> [--focus <all|speed|crawl|schema>]

Examples

示例

/technical-seo example.com /technical-seo example.com --focus speed /technical-seo example.com --focus crawl --depth 3


**Options:**
- `--focus <all|speed|crawl|schema>` — audit focus area
- `--depth <N>` — crawl depth (default: 3)
- `--mobile` — prioritize mobile issues
- `--check-schema` — validate structured data

**Returns:**
- Core Web Vitals scores (LCP, FID, CLS)
- Crawl budget analysis
- Indexability issues (robots.txt, noindex, sitemap)
- Schema markup validation
- Mobile usability report
- Render-blocking resources

/technical-seo example.com /technical-seo example.com --focus speed /technical-seo example.com --focus crawl --depth 3


**选项：**
- `--focus <all|speed|crawl|schema>` — 审计重点领域
- `--depth <N>` — 抓取深度（默认：3）
- `--mobile` — 优先处理移动设备问题
- `--check-schema` — 验证结构化数据

**返回结果：**
- Core Web Vitals评分（LCP、FID、CLS）
- 抓取预算分析
- 可索引性问题（robots.txt、noindex、站点地图）
- Schema标记验证
- 移动设备可用性报告
- 阻塞渲染资源

Competitor Gap Analysis

竞争对手差距分析

Identify backlink, topic, and featured snippet opportunities from competitors.

bash

/competitor-gap <your_domain> <competitor1> [<competitor2> ...]

从竞争对手中识别反向链接、主题和特色摘要机会。

bash

/competitor-gap <your_domain> <competitor1> [<competitor2> ...]

Examples

示例

/competitor-gap example.com competitor1.com competitor2.com /competitor-gap example.com competitor1.com --focus backlinks /competitor-gap example.com competitor1.com --min-dr 40


**Options:**
- `--focus <backlinks|topics|snippets>` — analysis focus
- `--min-dr <N>` — minimum domain rating for backlink sources
- `--min-volume <N>` — minimum search volume for keywords
- `--output <json|md|csv>` — output format

**Returns:**
- Backlink gap (links competitors have that you don't)
- Topic gap (keywords competitors rank for that you don't)
- Featured snippet opportunities
- Content format gaps (video, images, tools)
- Domain authority comparison

/competitor-gap example.com competitor1.com competitor2.com /competitor-gap example.com competitor1.com --focus backlinks /competitor-gap example.com competitor1.com --min-dr 40


**选项：**
- `--focus <backlinks|topics|snippets>` — 分析重点
- `--min-dr <N>` — 反向链接来源的最低域名评级
- `--min-volume <N>` — 关键词的最低搜索量
- `--output <json|md|csv>` — 输出格式

**返回结果：**
- 反向链接差距（竞争对手拥有但您没有的链接）
- 主题差距（竞争对手排名但您未排名的关键词）
- 特色摘要机会
- 内容格式差距（视频、图片、工具）
- 域名权威性对比

SEO Content Brief Generator

SEO内容简报生成器

AI-generated content brief with outline, NLP terms, and optimization targets.

bash

/content-brief <keyword> [--type <blog|landing|guide>]

AI生成的内容简报，包含大纲、NLP术语和优化目标。

bash

/content-brief <keyword> [--type <blog|landing|guide>]

Examples

示例

/content-brief "email marketing best practices" /content-brief "project management software" --type landing /content-brief "how to optimize images for seo" --type guide --depth comprehensive


**Options:**
- `--type <blog|landing|guide|product>` — content type
- `--depth <standard|comprehensive>` — detail level
- `--target-words <N>` — target word count
- `--include-questions` — add People Also Ask questions

**Returns:**
- Target keyword + secondary keywords
- Search intent analysis
- Recommended word count
- H1, H2, H3 outline
- NLP terms to include (TF-IDF, entities)
- Internal linking suggestions
- SERP analysis (top 10 competitors)
- People Also Ask questions

/content-brief "email marketing best practices" /content-brief "project management software" --type landing /content-brief "how to optimize images for seo" --type guide --depth comprehensive


**选项：**
- `--type <blog|landing|guide|product>` — 内容类型
- `--depth <standard|comprehensive>` — 详细程度
- `--target-words <N>` — 目标字数
- `--include-questions` — 添加“人们还问”问题

**返回结果：**
- 目标关键词 + 次要关键词
- 搜索意图分析
- 建议字数
- H1、H2、H3大纲
- 需包含的NLP术语（TF-IDF、实体）
- 内部链接建议
- SERP分析（前10名竞争对手）
- “人们还问”问题

SERP Monitor

SERP监控

Daily rank tracking with volatility alerts and CTR optimization tips.

bash

/serp-monitor <domain> --keywords <file_or_list>

每日排名跟踪，包含波动警报和点击率优化建议。

bash

/serp-monitor <domain> --keywords <file_or_list>

Examples

示例

/serp-monitor example.com --keywords keywords.txt /serp-monitor example.com --keywords "keyword1,keyword2,keyword3" /serp-monitor example.com --keywords keywords.txt --alert-drop 3


**Options:**
- `--keywords <file|list>` — keywords to track
- `--alert-drop <N>` — alert if drop > N positions
- `--frequency <daily|weekly>` — tracking frequency
- `--competitors <list>` — track competitor positions

**Returns:**
- Current rankings vs. previous period
- Position changes (🔺🔻)
- SERP feature presence (featured snippet, PAA, image pack)
- Estimated traffic impact
- CTR optimization opportunities
- Volatility score

/serp-monitor example.com --keywords keywords.txt /serp-monitor example.com --keywords "keyword1,keyword2,keyword3" /serp-monitor example.com --keywords keywords.txt --alert-drop 3


**选项：**
- `--keywords <file|list>` — 要跟踪的关键词
- `--alert-drop <N>` — 排名下降超过N位时发出警报
- `--frequency <daily|weekly>` — 跟踪频率
- `--competitors <list>` — 跟踪竞争对手排名

**返回结果：**
- 当前排名与上期对比
- 排名变化（🔺🔻）
- SERP功能存在情况（特色摘要、PAA、图片包）
- 预估流量影响
- 点击率优化机会
- 波动评分

Link Prospecting

链接勘探

Quality backlink prospect identification with outreach templates.

bash

/link-prospecting <domain> <topic> [--min-da <N>]

高质量反向链接潜在目标识别，包含外联模板。

bash

/link-prospecting <domain> <topic> [--min-da <N>]

Examples

示例

/link-prospecting example.com "project management" /link-prospecting example.com "saas tools" --min-da 40 --count 50 /link-prospecting example.com "marketing automation" --strategy guest-post


**Options:**
- `--min-da <N>` — minimum domain authority (default: 30)
- `--min-dr <N>` — minimum domain rating (Ahrefs)
- `--count <N>` — number of prospects to find
- `--strategy <guest-post|resource-page|broken-link>` — outreach strategy
- `--output csv` — export prospect list

**Returns:**
- Prospect list with DA/DR scores
- Contact information (when available)
- Relevance score
- Link placement opportunities
- Outreach email templates
- Competitor backlink sources

/link-prospecting example.com "project management" /link-prospecting example.com "saas tools" --min-da 40 --count 50 /link-prospecting example.com "marketing automation" --strategy guest-post


**选项：**
- `--min-da <N>` — 最低域名权威性（默认：30）
- `--min-dr <N>` — 最低域名评级（Ahrefs）
- `--count <N>` — 要查找的潜在目标数量
- `--strategy <guest-post|resource-page|broken-link>` — 外联策略
- `--output csv` — 导出潜在目标列表

**返回结果：**
- 包含DA/DR评分的潜在目标列表
- 联系信息（如有）
- 相关性评分
- 链接放置机会
- 外联邮件模板
- 竞争对手反向链接来源

Page Speed for SEO

SEO页面速度分析

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

bash

/page-speed-seo <url> [--device <mobile|desktop>]

阻塞渲染、LCP、CLS和FID诊断，映射到排名影响。

bash

/page-speed-seo <url> [--device <mobile|desktop>]

Examples

示例

/page-speed-seo https://example.com /page-speed-seo https://example.com/blog/post --device mobile /page-speed-seo https://example.com --priority ranking-impact


**Options:**
- `--device <mobile|desktop>` — device type (default: mobile)
- `--priority <ranking-impact|user-experience>` — focus area
- `--output detailed` — include technical recommendations

**Returns:**
- Core Web Vitals scores (LCP, FID, CLS)
- Ranking impact assessment
- Render-blocking resources
- Image optimization opportunities
- JavaScript/CSS optimization
- Server response time
- Prioritized fix list with estimated impact

/page-speed-seo https://example.com /page-speed-seo https://example.com/blog/post --device mobile /page-speed-seo https://example.com --priority ranking-impact


**选项：**
- `--device <mobile|desktop>` — 设备类型（默认：移动设备）
- `--priority <ranking-impact|user-experience>` — 重点领域
- `--output detailed` — 包含技术建议

**返回结果：**
- Core Web Vitals评分（LCP、FID、CLS）
- 排名影响评估
- 阻塞渲染资源
- 图片优化机会
- JavaScript/CSS优化建议
- 服务器响应时间
- 带预估影响的优先级修复列表

Local SEO Audit

本地SEO审计

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

bash

/local-seo <business_name> <location>

NAP一致性、Google Business Profile优化和本地引用审计。

bash

/local-seo <business_name> <location>

Examples

示例

/local-seo "Acme Coffee Shop" "Seattle, WA" /local-seo "Smith Law Firm" "Austin, TX" --check-citations /local-seo "Best Plumbing" "Denver, CO" --check-gbp


**Options:**
- `--check-citations` — audit citation consistency
- `--check-gbp` — Google Business Profile optimization
- `--check-reviews` — review management analysis
- `--competitors <N>` — compare with N local competitors

**Returns:**
- NAP (Name, Address, Phone) consistency score
- Google Business Profile optimization checklist
- Citation audit (correct, incorrect, missing)
- Local pack ranking analysis
- Review strategy recommendations
- Local schema markup validation

/local-seo "Acme Coffee Shop" "Seattle, WA" /local-seo "Smith Law Firm" "Austin, TX" --check-citations /local-seo "Best Plumbing" "Denver, CO" --check-gbp


**选项：**
- `--check-citations` — 审计引用一致性
- `--check-gbp` — Google Business Profile优化
- `--check-reviews` — 评论管理分析
- `--competitors <N>` — 与N个本地竞争对手对比

**返回结果：**
- NAP（名称、地址、电话）一致性评分
- Google Business Profile优化清单
- 引用审计（正确、错误、缺失）
- 本地包排名分析
- 评论策略建议
- 本地Schema标记验证

Content Calendar Generator

内容日历生成器

Data-driven editorial calendar built from search demand and seasonality.

bash

/content-calendar <domain> --months <N> [--topics <list>]

基于搜索需求和季节性的数据驱动型编辑日历。

bash

/content-calendar <domain> --months <N> [--topics <list>]

Examples

示例

/content-calendar example.com --months 3 /content-calendar example.com --months 6 --topics "email marketing,automation,analytics" /content-calendar example.com --months 12 --include-seasonality --output csv


**Options:**
- `--months <N>` — calendar duration
- `--topics <list>` — topic seeds (comma-separated)
- `--include-seasonality` — factor in search trends
- `--frequency <weekly|biweekly|monthly>` — publishing frequency
- `--output <md|csv|json>` — output format

**Returns:**
- Month-by-month content topics
- Target keywords per piece
- Search volume and seasonality data
- Content type recommendations (blog, guide, video)
- Internal linking opportunities
- Publishing schedule


**选项：**
- `--months <N>` — 日历时长
- `--topics <list>` — 主题种子（逗号分隔）
- `--include-seasonality` — 考虑搜索趋势
- `--frequency <weekly|biweekly|monthly>` — 发布频率
- `--output <md|csv|json>` — 输出格式

**返回结果：**
- 逐月内容主题
- 每篇内容的目标关键词
- 搜索量和季节性数据
- 内容类型建议（博客、指南、视频）
- 内部链接机会
- 发布时间表

Multi-Step Workflows

多步骤工作流

Workflows orchestrate multiple commands into end-to-end processes.

工作流将多个命令编排为端到端流程。

Full SEO Sprint

完整SEO冲刺

12-step comprehensive SEO audit and strategy development.

bash

/workflows:full-seo-sprint <domain> [--scope <quick|full>]

12步全面SEO审计和策略制定。

bash

/workflows:full-seo-sprint <domain> [--scope <quick|full>]

Examples

示例

/workflows:full-seo-sprint example.com /workflows:full-seo-sprint example.com --scope full --output report.md


**Steps:**
1. Technical SEO audit
2. Content audit
3. Keyword research
4. Competitor gap analysis
5. Backlink profile analysis
6. SERP analysis
7. Content cannibalization check
8. Site speed audit
9. Mobile usability check
10. Schema markup validation
11. Action plan generation
12. Priority roadmap

/workflows:full-seo-sprint example.com /workflows:full-seo-sprint example.com --scope full --output report.md


**步骤：**
1. 技术SEO审计
2. 内容审计
3. 关键词研究
4. 竞争对手差距分析
5. 反向链接档案分析
6. SERP分析
7. 内容内部竞争检查
8. 站点速度审计
9. 移动设备可用性检查
10. Schema标记验证
11. 行动计划生成
12. 优先级路线图

Launch SEO Checklist

上线前SEO检查清单

Pre-launch SEO validation workflow.

bash

/workflows:launch-seo <domain>

上线前SEO验证工作流。

bash

/workflows:launch-seo <domain>

Examples

示例

/workflows:launch-seo staging.example.com /workflows:launch-seo example.com --pre-launch


**Checks:**
- Canonical tags configured
- Hreflang implementation (if international)
- XML sitemap generated and submitted
- Robots.txt configured correctly
- 301 redirects mapped
- No orphan pages
- All pages indexable
- Schema markup implemented
- Core Web Vitals passing
- Mobile-friendly

/workflows:launch-seo staging.example.com /workflows:launch-seo example.com --pre-launch


**检查项：**
- 规范标签配置完成
- Hreflang实现（如有国际化需求）
- XML站点地图已生成并提交
- Robots.txt配置正确
- 301重定向已映射
- 无孤立页面
- 所有页面可索引
- Schema标记已实现
- Core Web Vitals达标
- 适配移动设备

Content Refresh Workflow

内容刷新工作流

Identify and optimize underperforming pages.

bash

/workflows:content-refresh <domain> [--min-age <days>]

识别并优化表现不佳的页面。

bash

/workflows:content-refresh <domain> [--min-age <days>]

Examples

示例

/workflows:content-refresh example.com /workflows:content-refresh example.com --min-age 180 --min-drop 5


**Process:**
1. Identify pages with ranking drops
2. Analyze SERP intent changes
3. Generate content refresh briefs
4. Update optimization targets
5. Provide before/after checklist

/workflows:content-refresh example.com /workflows:content-refresh example.com --min-age 180 --min-drop 5


**流程：**
1. 识别排名下降的页面
2. 分析SERP意图变化
3. 生成内容刷新简报
4. 更新优化目标
5. 提供前后检查清单

Authority Building Campaign

权威性建设活动

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

bash

/workflows:authority-building <domain> <topic> --duration <months>

端到端数字公关和链接建设工作流。

bash

/workflows:authority-building <domain> <topic> --duration <months>

Examples

示例

/workflows:authority-building example.com "saas analytics" --duration 6 /workflows:authority-building example.com "project management" --duration 3 --strategy guest-post


**Includes:**
- Topic and asset ideation
- Linkable asset recommendations
- Outreach prospect list
- Email templates
- Tracking spreadsheet template
- Reporting framework

/workflows:authority-building example.com "saas analytics" --duration 6 /workflows:authority-building example.com "project management" --duration 3 --strategy guest-post


**包含内容：**
- 主题和资产构思
- 可链接资产建议
- 外联潜在目标列表
- 邮件模板
- 跟踪电子表格模板
- 报告框架

AI Content Pipeline

AI内容流水线

Automated keyword → brief → draft → optimize → publish pipeline.

bash

/workflows:ai-content-pipeline <domain> --keywords <file>

自动化的关键词→简报→草稿→优化→发布流水线。

bash

/workflows:ai-content-pipeline <domain> --keywords <file>

Examples

示例

/workflows:ai-content-pipeline example.com --keywords content-queue.txt /workflows:ai-content-pipeline example.com --keywords keywords.csv --frequency weekly


**Pipeline:**
1. Keyword prioritization
2. Content brief generation
3. Outline creation
4. Draft generation (outline only, human writes)
5. On-page SEO optimization checklist
6. Internal linking suggestions
7. Publishing checklist

/workflows:ai-content-pipeline example.com --keywords content-queue.txt /workflows:ai-content-pipeline example.com --keywords keywords.csv --frequency weekly


**流水线：**
1. 关键词优先级排序
2. 内容简报生成
3. 大纲创建
4. 草稿生成（仅大纲，人工撰写）
5. 页面内SEO优化清单
6. 内部链接建议
7. 发布检查清单

Configuration

配置

Environment Variables

环境变量

Commands may require API keys for third-party SEO tools:

bash

undefined

命令可能需要第三方SEO工具的API密钥：

bash

undefined

Ahrefs API (for backlink data)

Ahrefs API（用于反向链接数据）

export AHREFS_API_KEY="your_ahrefs_api_key"

SEMrush API (for keyword data)

SEMrush API（用于关键词数据）

export SEMRUSH_API_KEY="your_semrush_api_key"

Google Search Console API

export GSC_CLIENT_ID="your_gsc_client_id" export GSC_CLIENT_SECRET="your_gsc_client_secret"

Screaming Frog API (for crawling)

Screaming Frog API（用于抓取）

export SCREAMINGFROG_LICENSE="your_license_key"

PageSpeed Insights API

export PAGESPEED_API_KEY="your_pagespeed_api_key"

undefined

export PAGESPEED_API_KEY="your_pagespeed_api_key"

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: competitor_count: 3 crawl_depth: 3 min_domain_authority: 30 output_format: "md"

API endpoints (optional, for custom integrations)

API端点（可选，用于自定义集成）

api: ahrefs_rate_limit: 100 # requests per day semrush_rate_limit: 1000

api: ahrefs_rate_limit: 100 # 每日请求数 semrush_rate_limit: 1000

Output preferences

输出偏好

output: use_color: true show_progress: true verbose: false

Thresholds

阈值

thresholds: thin_content_words: 300 quality_score_min: 60 core_web_vitals: lcp_good: 2.5 # seconds fid_good: 100 # milliseconds cls_good: 0.1

undefined

thresholds: thin_content_words: 300 quality_score_min: 60 core_web_vitals: lcp_good: 2.5 # 秒 fid_good: 100 # 毫秒 cls_good: 0.1

undefined

Common Usage Patterns

常见使用模式

Pattern 1: New Site SEO Setup

模式1：新站点SEO设置

bash

undefined

bash

undefined

Step 1: Run pre-launch checklist

步骤1：运行上线前检查清单

/workflows:launch-seo staging.newsite.com

Step 2: Keyword research for core topics

步骤2：核心主题关键词研究

/keyword-research "main product category"

Step 3: Create content calendar

步骤3：创建内容日历

/content-calendar newsite.com --months 6 --topics "topic1,topic2,topic3"

Step 4: Generate content briefs for priority keywords

步骤4：为优先级关键词生成内容简报

/content-brief "priority keyword 1" --type landing /content-brief "priority keyword 2" --type blog

undefined

/content-brief "priority keyword 1" --type landing /content-brief "priority keyword 2" --type blog

undefined

Pattern 2: Competitor Overtaking Strategy

模式2：竞争对手超越策略

bash

undefined

bash

undefined

Step 1: Identify gaps

步骤1：识别差距

/competitor-gap yoursite.com competitor.com --focus topics

Step 2: Find backlink opportunities

步骤2：寻找反向链接机会

/competitor-gap yoursite.com competitor.com --focus backlinks

Step 3: Generate content briefs for gap keywords

步骤3：为差距关键词生成内容简报

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

Step 4: Build authority

步骤4：建设权威性

/workflows:authority-building yoursite.com "topic" --duration 6

undefined

/workflows:authority-building yoursite.com "topic" --duration 6

undefined

Pattern 3: Traffic Recovery

模式3：流量恢复

bash

undefined

bash

undefined

Step 1: Audit existing content

步骤1：审计现有内容

/content-audit yoursite.com --scope full

Step 2: Identify ranking drops

步骤2：识别排名下降

/serp-monitor yoursite.com --keywords keywords.txt --alert-drop 5

Step 3: Run content refresh workflow

步骤3：运行内容刷新工作流

/workflows:content-refresh yoursite.com --min-drop 5

Step 4: Check technical issues

步骤4：检查技术问题

/technical-seo yoursite.com --focus all

undefined

/technical-seo yoursite.com --focus all

undefined

Pattern 4: Monthly SEO Maintenance

模式4：月度SEO维护

bash

undefined

bash

undefined

Week 1: Performance monitoring

第1周：性能监控

/serp-monitor yoursite.com --keywords keywords.txt /page-speed-seo yoursite.com

Week 2: Content updates

第2周：内容更新

/workflows:content-refresh yoursite.com /content-calendar yoursite.com --months 1

Week 3: Link building

第3周：链接建设

/link-prospecting yoursite.com "topic" --count 20

Week 4: Reporting

第4周：报告

/workflows:full-seo-sprint yoursite.com --scope quick

undefined

/workflows:full-seo-sprint yoursite.com --scope quick

undefined

Real Code Examples

真实代码示例

Example 1: Keyword Research Output (Markdown)

示例1：关键词研究输出（Markdown）

markdown

undefined

markdown

undefined

Keyword Research Results

Target: example.com Seed: "project management software" Date: 2026-05-12

📊 Summary

Total keywords found: 347
Clusters identified: 12
Quick-win opportunities: 23
High-value targets: 8

Total keywords found: 347
Clusters identified: 12
Quick-win opportunities: 23
High-value targets: 8

🎯 High-Value Keyword Clusters

Cluster 1: Software Features

Keyword	Volume	Difficulty	Intent	Opportunity Score
project management software features	2,400	45	Commercial	84
best project management tools	5,900	62	Commercial	76
project tracking software	1,900	38	Commercial	88

Keyword	Volume	Difficulty	Intent	Opportunity Score
project management software features	2,400	45	Commercial	84
best project management tools	5,900	62	Commercial	76
project tracking software	1,900	38	Commercial	88

Cluster 2: Use Cases

Keyword	Volume	Difficulty	Intent	Opportunity Score
project management for remote teams	1,200	35	Informational	91
agile project management software	3,100	52	Commercial	79

Keyword	Volume	Difficulty	Intent	Opportunity Score
project management for remote teams	1,200	35	Informational	91
agile project management software	3,100	52	Commercial	79

⚡ Quick Wins (Low Competition, Decent Volume)

project management software for small teams — Vol: 880, Diff: 28, Opp: 94
free project management tools — Vol: 1,600, Diff: 31, Opp: 92
project management app comparison — Vol: 720, Diff: 25, Opp: 96

project management software for small teams — Vol: 880, Diff: 28, Opp: 94
free project management tools — Vol: 1,600, Diff: 31, Opp: 92
project management app comparison — Vol: 720, Diff: 25, Opp: 96

📈 Next Steps

Create content briefs for top 5 quick-win keywords
Audit existing content for optimization opportunities
Build topic cluster architecture around main clusters

undefined

Create content briefs for top 5 quick-win keywords
Audit existing content for optimization opportunities
Build topic cluster architecture around main clusters

undefined

Example 2: Technical SEO Audit Output (JSON)

示例2：技术SEO审计输出（JSON）

json

{
  "audit_date": "2026-05-12T10:30:00Z",
  "domain": "example.com",
  "pages_crawled": 1204,
  "issues_found": 47,
  "core_web_vitals": {
    "lcp": {
      "score": 2.1,
      "status": "good",
      "threshold": 2.5
    },
    "fid": {
      "score": 85,
      "status": "good",
      "threshold": 100
    },
    "cls": {
      "score": 0.08,
      "status": "good",
      "threshold": 0.1
    },
    "overall": "pass"
  },
  "issues": [
    {
      "type": "missing_meta_description",
      "severity": "medium",
      "count": 302,
      "affected_urls": ["https://example.com/page1", "..."],
      "impact": "CTR optimization opportunity",
      "fix": "Add unique meta descriptions to all pages"
    },
    {
      "type": "duplicate_title_tags",
      "severity": "high",
      "count": 18,
      "affected_urls": ["https://example.com/page2", "..."],
      "impact": "Keyword cannibalization risk",
      "fix": "Make title tags unique for each page"
    },
    {
      "type": "broken_internal_links",
      "severity": "high",
      "count": 23,
      "affected_urls": ["https://example.com/broken-link", "..."],
      "impact": "Crawl budget waste, poor UX",
      "fix": "Update or remove broken links"
    }
  ],
  "schema_markup": {
    "present": true,
    "types": ["Organization", "WebPage", "Article"],
    "errors": 3,
    "warnings": 7
  },
  "indexability": {
    "crawlable_pages": 1204,
    "blocked_by_robots": 12,
    "noindex_pages": 34,
    "sitemap_urls": 1180,
    "sitemap_errors": 24
  },
  "recommendations": [
    {
      "priority": "high",
      "action": "Fix broken internal links",
      "impact": "Improve crawl efficiency and UX",
      "effort": "2 hours"
    },
    {
      "priority": "high",
      "action": "Deduplicate title tags",
      "impact": "Reduce cannibalization",
      "effort": "4 hours"
    },
    {
      "priority": "medium",
      "action": "Add missing meta descriptions",
      "impact": "Improve CTR by 5-15%",
      "effort": "8 hours"
    }
  ]
}

json

{
  "audit_date": "2026-05-12T10:30:00Z",
  "domain": "example.com",
  "pages_crawled": 1204,
  "issues_found": 47,
  "core_web_vitals": {
    "lcp": {
      "score": 2.1,
      "status": "good",
      "threshold": 2.5
    },
    "fid": {
      "score": 85,
      "status": "good",
      "threshold": 100
    },
    "cls": {
      "score": 0.08,
      "status": "good",
      "threshold": 0.1
    },
    "overall": "pass"
  },
  "issues": [
    {
      "type": "missing_meta_description",
      "severity": "medium",
      "count": 302,
      "affected_urls": ["https://example.com/page1", "..."],
      "impact": "CTR optimization opportunity",
      "fix": "Add unique meta descriptions to all pages"
    },
    {
      "type": "duplicate_title_tags",
      "severity": "high",
      "count": 18,
      "affected_urls": ["https://example.com/page2", "..."],
      "impact": "Keyword cannibalization risk",
      "fix": "Make title tags unique for each page"
    },
    {
      "type": "broken_internal_links",
      "severity": "high",
      "count": 23,
      "affected_urls": ["https://example.com/broken-link", "..."],
      "impact": "Crawl budget waste, poor UX",
      "fix": "Update or remove broken links"
    }
  ],
  "schema_markup": {
    "present": true,
    "types": ["Organization", "WebPage", "Article"],
    "errors": 3,
    "warnings": 7
  },
  "indexability": {
    "crawlable_pages": 1204,
    "blocked_by_robots": 12,
    "noindex_pages": 34,
    "sitemap_urls": 1180,
    "sitemap_errors": 24
  },
  "recommendations": [
    {
      "priority": "high",
      "action": "Fix broken internal links",
      "impact": "Improve crawl efficiency and UX",
      "effort": "2 hours"
    },
    {
      "priority": "high",
      "action": "Deduplicate title tags",
      "impact": "Reduce cannibalization",
      "effort": "4 hours"
    },
    {
      "priority": "medium",
      "action": "Add missing meta descriptions",
      "impact": "Improve CTR by 5-15%",
      "effort": "8 hours"
    }
  ]
}

Example 3: Content Brief Generation

示例3：内容简报生成

markdown

undefined

markdown

undefined

SEO Content Brief: "email marketing best practices"

Generated: 2026-05-12 Primary Keyword: email marketing best practices Content Type: Blog Post / Guide

🎯 Target Metrics

Search Volume: 3,600/month
Keyword Difficulty: 48/100
Search Intent: Informational
Recommended Word Count: 2,200-2,800 words
Target Position: Top 5 (SERP feature opportunity)

Search Volume: 3,600/month
Keyword Difficulty: 48/100
Search Intent: Informational
Recommended Word Count: 2,200-2,800 words
Target Position: Top 5 (SERP feature opportunity)

🔍 Search Intent Analysis

Users searching for this keyword want:

Actionable tips to improve email campaigns
Industry benchmarks and statistics
Examples of effective email strategies
Tools and templates

Dominant Content Types in Top 10:

Listicle guides (60%)
Comprehensive how-to articles (30%)
Video content (10%)

Users searching for this keyword want:

Actionable tips to improve email campaigns
Industry benchmarks and statistics
Examples of effective email strategies
Tools and templates

Dominant Content Types in Top 10:

Listicle guides (60%)
Comprehensive how-to articles (30%)
Video content (10%)

📝 Recommended Outline

H1: Email Marketing Best Practices: 15 Proven Strategies for 2026

H2: Why Email Marketing Still Matters

Statistics on ROI
Comparison with other channels

Statistics on ROI
Comparison with other channels

H2: List Building Best Practices

H3: Use double opt-in
H3: Offer lead magnets
H3: Segment from the start

H3: Use double opt-in
H3: Offer lead magnets
H3: Segment from the start

H2: Email Design Best Practices

H3: Mobile-first design
H3: Single column layouts
H3: Clear CTA buttons

H3: Mobile-first design
H3: Single column layouts
H3: Clear CTA buttons

H2: Content Best Practices

H3: Personalization techniques
H3: Subject line optimization
H3: Preview text optimization
H3: Email copy structure

H3: Personalization techniques
H3: Subject line optimization
H3: Preview text optimization
H3: Email copy structure

H2: Sending Best Practices

H3: Optimal send times
H3: Frequency guidelines
H3: A/B testing

H3: Optimal send times
H3: Frequency guidelines
H3: A/B testing

H2: Compliance & Deliverability

H3: GDPR and CAN-SPAM compliance
H3: SPF, DKIM, DMARC setup
H3: List hygiene

H3: GDPR and CAN-SPAM compliance
H3: SPF, DKIM, DMARC setup
H3: List hygiene

H2: Measurement & Optimization

H3: Key metrics to track
H3: Continuous improvement process

H3: Key metrics to track
H3: Continuous improvement process

🔤 NLP Terms to Include (TF-IDF Analysis)

Must Include:

email marketing strategy
open rate
click-through rate
conversion rate
email list
subscribers
email campaign
automation
segmentation
personalization
A/B testing
deliverability
subject line
call to action
mobile optimization

Should Include:

email service provider (ESP)
drip campaign
newsletter
welcome email
cart abandonment
re-engagement
unsubscribe rate
spam filter

Must Include:

email marketing strategy
open rate
click-through rate
conversion rate
email list
subscribers
email campaign
automation
segmentation
personalization
A/B testing
deliverability
subject line
call to action
mobile optimization

Should Include:

email service provider (ESP)
drip campaign
newsletter
welcome email
cart abandonment
re-engagement
unsubscribe rate
spam filter

🔗 Internal Linking Opportunities

Link to: "How to Build an Email List" (if exists)
Link to: "Email Marketing Tools Comparison" (if exists)
Link to: "Email Automation Guide" (if exists)
Link to: "GDPR Compliance Checklist" (if exists)

Link to: "How to Build an Email List" (if exists)
Link to: "Email Marketing Tools Comparison" (if exists)
Link to: "Email Automation Guide" (if exists)
Link to: "GDPR Compliance Checklist" (if exists)

🏆 SERP Competitor Analysis

Top 3 Competitors:

1. hubspot.com/marketing/email-marketing-best-practices

Word count: 3,200
Strengths: Comprehensive, many examples, video
Weaknesses: Outdated stats (2023)
Backlinks: 342

2. mailchimp.com/marketing-glossary/email-best-practices

Word count: 2,100
Strengths: Clean design, actionable tips
Weaknesses: Lacks depth on deliverability
Backlinks: 189

3. campaignmonitor.com/blog/email-marketing/best-practices

Word count: 2,800
Strengths: Great visuals, case studies
Weaknesses: Too tool-focused
Backlinks: 156

1. hubspot.com/marketing/email-marketing-best-practices

Word count: 3,200
Strengths: Comprehensive, many examples, video
Weaknesses: Outdated stats (2023)
Backlinks: 342

2. mailchimp.com/marketing-glossary/email-best-practices

Word count: 2,100
Strengths: Clean design, actionable tips
Weaknesses: Lacks depth on deliverability
Backlinks: 189

3. campaignmonitor.com/blog/email-marketing/best-practices

Word count: 2,800
Strengths: Great visuals, case studies
Weaknesses: Too tool-focused
Backlinks: 156

❓ People Also Ask Questions

Include answers to these related questions:

"What is the best day to send marketing emails?"
"How often should you send marketing emails?"
"What is a good open rate for email marketing?"
"How do you personalize email marketing?"

Include answers to these related questions:

"What is the best day to send marketing emails?"
"How often should you send marketing emails?"
"What is a good open rate for email marketing?"
"How do you personalize email marketing?"

📊 Content Elements to Include

✅ On-Page SEO Checklist

🎯 Success Metrics

Target within 90 days:

Rank in top 10 for primary keyword
200+ organic sessions/month
5+ backlinks
Featured in "People Also Ask" section

undefined

Target within 90 days:

Rank in top 10 for primary keyword
200+ organic sessions/month
5+ backlinks
Featured in "People Also Ask" section

undefined

Troubleshooting

故障排除

Command Not Found

命令未找到

Issue:

/keyword-research

command not recognized

Solution:

bash

undefined

问题：

/keyword-research

命令未被识别

解决方案：

bash

undefined

Ensure skill is properly loaded

确保技能已正确加载

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

Or load directly

或直接加载

/read ./SKILL.md

undefined

/read ./SKILL.md

undefined

Missing API Keys

缺少API密钥

Issue: "API key required for backlink data"

Solution:

bash

undefined

问题： "API key required for backlink data"

解决方案：

bash

undefined

Set required environment variables

设置所需环境变量

export AHREFS_API_KEY="your_key" export SEMRUSH_API_KEY="your_key"

Or add to config file

或添加到配置文件

echo "ahrefs_api_key: your_key" >> ~/.claude/skills/seo-content-marketing/config.yaml

undefined

echo "ahrefs_api_key: your_key" >> ~/.claude/skills/seo-content-marketing/config.yaml

undefined

Slow Crawling

抓取速度慢

Issue: Content audit taking too long

Solution:

bash

undefined

问题： 内容审计耗时过长

解决方案：

bash

undefined

Reduce crawl depth

减少抓取深度

/content-audit example.com --scope subset --sample 100

Or use focused audit

或使用聚焦审计

/content-audit example.com --scope full --depth 2

undefined

/content-audit example.com --scope full --depth 2

undefined

Rate Limit Errors

速率限制错误

Issue: "Rate limit exceeded for SEMrush API"

Solution:

bash

undefined

问题： "Rate limit exceeded for SEMrush API"

解决方案：

bash

undefined

Check rate limits in config

检查配置中的速率限制

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

Reduce frequency or batch requests

减少请求频率或批量处理

/keyword-research example.com --delay 1 # 1 second between requests

undefined

/keyword-research example.com --delay 1 # 请求间隔1秒

undefined

Empty Results

结果为空

Issue: No keywords found for domain

Solution:

bash

undefined

问题： 未找到域名相关的关键词

解决方案：

bash

undefined

Use seed keyword instead of domain

使用种子关键词而非域名

/keyword-research --seed "specific topic"

Check if domain has organic traffic

检查域名是否有自然流量

/serp-monitor example.com --keywords "brand name"

undefined

/serp-monitor example.com --keywords "brand name"

undefined

Advanced Usage

高级用法

Batch Processing

批量处理

Process multiple domains or keywords:

bash

undefined

处理多个域名或关键词：

bash

undefined

Create batch file

创建批处理文件

cat > domains.txt << EOF example1.com example2.com example3.com EOF

Run batch audit (pseudo-code, implement via script)

运行批量审计（伪代码，通过脚本实现）

while read domain; do /technical-seo "$domain" --output "reports/${domain}.md" done < domains.txt

undefined

while read domain; do /technical-seo "$domain" --output "reports/${domain}.md" done < domains.txt

undefined

Custom Reporting

自定义报告

Export and combine results:

bash

undefined

导出并合并结果：

bash

undefined

Export keyword research as CSV

导出关键词研究为CSV

/keyword-research example.com --output csv > keywords.csv

Export technical audit as JSON

导出技术审计为JSON

/technical-seo example.com --output json > audit.json

Combine in custom report

合并到自定义报告

cat keywords.csv audit.json | your-custom-processor

undefined

cat keywords.csv audit.json | your-custom-processor

undefined

Automation

自动化

Schedule regular audits:

bash

undefined

定期安排审计：

bash

undefined

Add to cron (daily SERP monitoring)

添加到cron（每日SERP监控）

0 9 * * * /usr/local/bin/claude /serp-monitor example.com --keywords keywords.txt --email-report

Weekly content refresh check

每周内容刷新检查

0 9 * * 1 /usr/local/bin/claude /workflows:content-refresh example.com --output weekly-report.md

undefined

0 9 * * 1 /usr/local/bin/claude /workflows:content-refresh example.com --output weekly-report.md

undefined

Best Practices

最佳实践

Start with Full SEO Sprint for new projects to establish baseline
Use Workflows for complex, multi-step processes instead of individual commands
Set up Environment Variables for API keys before running data-dependent commands
Export Results in structured formats (JSON, CSV) for further analysis
Monitor Regularly using
```
/serp-monitor
```
to catch ranking drops early
Prioritize by Impact — focus on issues flagged as "high severity" first
Document Changes — keep a log of SEO actions and their results
Combine Tools — use technical SEO audit + content audit together for comprehensive view

新项目从完整SEO冲刺开始，建立基准
使用工作流处理复杂的多步骤流程，而非单独命令
运行依赖数据的命令前设置环境变量用于API密钥
以结构化格式（JSON、CSV）导出结果以便进一步分析
定期使用
/serp-monitor
监控，及时发现排名下降
按影响优先级处理——优先关注标记为“高严重程度”的问题
记录变更——保留SEO操作及其结果的日志
结合工具——同时使用技术SEO审计和内容审计获得全面视图