datalocastle-r03-anthropics-skills-seo

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 skill suite provides 10 specialized SEO commands and 5 multi-step workflows derived from anthropics/skills. It enables AI coding agents to perform comprehensive SEO analysis, content audits, keyword research, and technical optimization with consistent structured output.

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

本技能套件提供10个专业SEO命令和5个多步骤工作流，源自anthropics/skills。它能让AI编码Agent执行全面的SEO分析、内容审核、关键词研究和技术优化，并输出一致的结构化结果。

What This Project Does

项目功能

The r03-anthropics-skills-seo suite delivers:

Keyword Research — clustering, opportunity scoring, SERP intent mapping
Content Audits — quality scores, 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
Local SEO — NAP consistency, Google Business Profile optimization
Link Building — prospect lists, outreach templates, authority building

All commands follow a consistent 5-step interaction pattern with visual progress tracking and prioritized action plans.

r03-anthropics-skills-seo套件可实现：

关键词研究 — 聚类、机会评分、SERP意图映射
内容审核 — 质量评分、重复内容检测、关键词 cannibalization（自竞争）报告
技术SEO — 抓取预算、Core Web Vitals、Schema标记、可索引性分析
竞品分析 — 反向链接差距、主题差距、特色摘要机会分析
内容策略 — AI生成的内容 brief、编辑日历、内容更新工作流
本地SEO — NAP一致性、Google Business Profile优化
链接建设 — 潜在链接源列表、 outreach模板、权威度提升

所有命令遵循统一的5步交互模式，带有可视化进度跟踪和优先级行动计划。

Installation

安装步骤

Clone the Skill

克隆技能

bash

undefined

bash

undefined

Clone to Claude Code skills directory

克隆到Claude Code技能目录

mkdir -p ~/.claude/skills cd ~/.claude/skills git clone https://github.com/Datalocastle/r03-anthropics-skills-seo.git

Or manually copy

或手动复制

cp -r /path/to/r03-anthropics-skills-seo ~/.claude/skills/

undefined

cp -r /path/to/r03-anthropics-skills-seo ~/.claude/skills/

undefined

Register in Claude Code

在Claude Code中注册

In a Claude Code session:

bash

/read ~/.claude/skills/r03-anthropics-skills-seo/SKILL.md

Or configure in your

~/.claude/config.yml

yaml

skills:
  - path: ~/.claude/skills/r03-anthropics-skills-seo
    enabled: true

在Claude Code会话中执行：

bash

/read ~/.claude/skills/r03-anthropics-skills-seo/SKILL.md

或在

~/.claude/config.yml

中配置：

yaml

skills:
  - path: ~/.claude/skills/r03-anthropics-skills-seo
    enabled: true

Core Commands

核心命令

1. Keyword Research

1. 关键词研究

Deep keyword clustering with intent mapping and opportunity scoring.

bash

/keyword-research <target>
/keyword-research "email marketing tools" --depth extensive
/keyword-research "seo" --scope commercial --output json

Parameters:

```
<target>
```
— seed keyword or topic
```
--depth
```
—
```
quick
```
|
```
standard
```
|
```
extensive
```
(default: standard)

--scope

—

informational

commercial

transactional

all

(default: all)

```
--output
```
—
```
md
```
|
```
json
```
|
```
csv
```
(default: md)

Output Structure:

╔═══════════════════════════════════════════════════════╗
║  Keyword Research  —  email marketing tools           ║
╠═══════════════════════════════════════════════════════╣
║  Gathering seeds …        [██████████] 100%  ✓ Done   ║
║  Expanding clusters …     [██████████] 100%  ✓ Done   ║
║  Analyzing SERP intent …  [████████░░]  80%  342/428  ║
╚═══════════════════════════════════════════════════════╝

┌──────────────────────────┬────────┬────┬────────┬──────────────┐
│ Keyword                  │ Volume │ KD │ Intent │ Opportunity  │
├──────────────────────────┼────────┼────┼────────┼──────────────┤
│ email marketing software │ 12 100 │ 78 │ 🔵 COM │ 🟢 High      │
│ best email tools         │  8 900 │ 65 │ 🔵 COM │ 🟢 High      │
│ email automation         │  6 700 │ 58 │ 🟡 MIX │ 🟡 Medium    │
│ mailchimp alternatives   │  4 200 │ 52 │ 🔵 COM │ 🟢 High      │
└──────────────────────────┴────────┴────┴────────┴──────────────┘

Action Plan:
🟢 Quick Wins (0-2 weeks)
  □ Target "mailchimp alternatives" — low KD, high commercial intent
  □ Create comparison table content for "best email tools"
  
🟡 Medium-Term (2-8 weeks)
  □ Build topic cluster around "email automation"
  □ Develop feature comparison pages

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

bash

/keyword-research <target>
/keyword-research "email marketing tools" --depth extensive
/keyword-research "seo" --scope commercial --output json

参数：

```
<target>
```
— 种子关键词或主题
```
--depth
```
—
```
quick
```
|
```
standard
```
|
```
extensive
```
（默认：standard）

--scope

—

informational

commercial

transactional

all

（默认：all）

```
--output
```
—
```
md
```
|
```
json
```
|
```
csv
```
（默认：md）

输出结构：

╔═══════════════════════════════════════════════════════╗
║  Keyword Research  —  email marketing tools           ║
╠═══════════════════════════════════════════════════════╣
║  Gathering seeds …        [██████████] 100%  ✓ Done   ║
║  Expanding clusters …     [██████████] 100%  ✓ Done   ║
║  Analyzing SERP intent …  [████████░░]  80%  342/428  ║
╚═══════════════════════════════════════════════════════╝

┌──────────────────────────┬────────┬────┬────────┬──────────────┐
│ Keyword                  │ Volume │ KD │ Intent │ Opportunity  │
├──────────────────────────┼────────┼────┼────────┼──────────────┤
│ email marketing software │ 12 100 │ 78 │ 🔵 COM │ 🟢 High      │
│ best email tools         │  8 900 │ 65 │ 🔵 COM │ 🟢 High      │
│ email automation         │  6 700 │ 58 │ 🟡 MIX │ 🟡 Medium    │
│ mailchimp alternatives   │  4 200 │ 52 │ 🔵 COM │ 🟢 High      │
└──────────────────────────┴────────┴────┴────────┴──────────────┘

Action Plan:
🟢 Quick Wins (0-2 weeks)
  □ Target "mailchimp alternatives" — low KD, high commercial intent
  □ Create comparison table content for "best email tools"
  
🟡 Medium-Term (2-8 weeks)
  □ Build topic cluster around "email automation"
  □ Develop feature comparison pages

2. Content Audit

2. 内容审核

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

bash

/content-audit --scope full --output md
/content-audit --url https://example.com --scope pages --filter /blog/*
/content-audit --scope full --min-words 300 --export audit-report.csv

Parameters:

```
--scope
```
—
```
full
```
|
```
pages
```
|
```
posts
```
|
```
category:<name>
```
```
--url
```
— target domain (optional if in project context)
```
--filter
```
— URL pattern to include (glob syntax)
```
--min-words
```
— minimum word count threshold (default: 100)
```
--export
```
— export path for CSV/JSON report

Output Structure:

╔═══════════════════════════════════════════════════════╗
║  Content Audit  —  example.com                        ║
╠═══════════════════════════════════════════════════════╣
║  Crawling pages …         [██████████] 100%  ✓ 1 204  ║
║  Analyzing quality …      [██████████] 100%  ✓ Done   ║
║  Checking duplication …   [██████████] 100%  ✓ Done   ║
╚═══════════════════════════════════════════════════════╝

Quality Score Distribution:
🟢 Excellent (80-100):  342 pages  (28%)
🟡 Good (60-79):        568 pages  (47%)
🟠 Fair (40-59):        234 pages  (19%)
🔴 Poor (0-39):          60 pages  ( 5%)

Top Issues:
🔴 Critical (60 pages)
  • Thin content (<300 words): 42 pages
  • Missing meta descriptions: 18 pages
  
🟠 Warning (234 pages)
  • Low word count (300-500): 156 pages
  • Keyword cannibalization: 78 page pairs

Action Plan:
🔴 Immediate (this week)
  □ Add meta descriptions to 18 critical pages
  □ Merge or 301 redirect 12 duplicate product pages
  
🟠 High Priority (2 weeks)
  □ Expand 42 thin content pages to 800+ words
  □ Resolve cannibalization for "pricing" queries (6 pages)

全站点内容质量分析，包含重复内容和关键词自竞争检测。

bash

/content-audit --scope full --output md
/content-audit --url https://example.com --scope pages --filter /blog/*
/content-audit --scope full --min-words 300 --export audit-report.csv

参数：

```
--scope
```
—
```
full
```
|
```
pages
```
|
```
posts
```
|
```
category:<name>
```
```
--url
```
— 目标域名（项目上下文已存在时可选）
```
--filter
```
— 要包含的URL模式（glob语法）
```
--min-words
```
— 最低字数阈值（默认：100）
```
--export
```
— CSV/JSON报告的导出路径

输出结构：

╔═══════════════════════════════════════════════════════╗
║  Content Audit  —  example.com                        ║
╠═══════════════════════════════════════════════════════╣
║  Crawling pages …         [██████████] 100%  ✓ 1 204  ║
║  Analyzing quality …      [██████████] 100%  ✓ Done   ║
║  Checking duplication …   [██████████] 100%  ✓ Done   ║
╚═══════════════════════════════════════════════════════╝

Quality Score Distribution:
🟢 Excellent (80-100):  342 pages  (28%)
🟡 Good (60-79):        568 pages  (47%)
🟠 Fair (40-59):        234 pages  (19%)
🔴 Poor (0-39):          60 pages  ( 5%)

Top Issues:
🔴 Critical (60 pages)
  • Thin content (<300 words): 42 pages
  • Missing meta descriptions: 18 pages
  
🟠 Warning (234 pages)
  • Low word count (300-500): 156 pages
  • Keyword cannibalization: 78 page pairs

Action Plan:
🔴 Immediate (this week)
  □ Add meta descriptions to 18 critical pages
  □ Merge or 301 redirect 12 duplicate product pages
  
🟠 High Priority (2 weeks)
  □ Expand 42 thin content pages to 800+ words
  □ Resolve cannibalization for "pricing" queries (6 pages)

3. Technical SEO Audit

3. 技术SEO审核

Crawl budget, Core Web Vitals, schema markup, and indexability analysis.

bash

/technical-seo <url>
/technical-seo https://example.com --depth full --include-vitals
/technical-seo --url https://example.com --crawl-limit 5000

Parameters:

```
<url>
```
— target domain
```
--depth
```
—
```
basic
```
|
```
standard
```
|
```
full
```
(default: standard)
```
--include-vitals
```
— run Core Web Vitals analysis
```
--crawl-limit
```
— max pages to crawl (default: 10000)

Output Structure:

╔═══════════════════════════════════════════════════════╗
║  Technical SEO Audit  —  example.com                  ║
╠═══════════════════════════════════════════════════════╣
║  Crawling site …          [██████████] 100%  ✓ 1 204  ║
║  Checking indexability …  [██████████] 100%  ✓ Done   ║
║  Validating schema …      [████████░░]  80%  962/1204 ║
╚═══════════════════════════════════════════════════════╝

┌─────────────────────────┬──────────┬──────────┬──────────┐
│ Metric                  │ Current  │ Target   │ Status   │
├─────────────────────────┼──────────┼──────────┼──────────┤
│ Crawlable pages         │    1 204 │    1 505 │  ⚠ 80 %  │
│ Pages w/ title tag      │    1 180 │    1 204 │  ✓ 98 %  │
│ Pages w/ meta desc      │      902 │    1 204 │  ✗ 75 %  │
│ Core Web Vitals         │     Good │     Good │  ✓ Pass  │
│ Mobile-friendly         │       97 │      100 │  ⚠ 97 %  │
│ Valid schema markup     │      645 │    1 204 │  ✗ 54 %  │
│ HTTPS coverage          │    1 204 │    1 204 │  ✓ 100 % │
└─────────────────────────┴──────────┴──────────┴──────────┘

Issues Found:
🔴 Critical (24 issues)
  • 301 redirect chains (12 pages) — avg 3.4 hops
  • Mixed content warnings (8 pages)
  • Orphaned pages (4 pages) — no internal links

🟠 Warning (156 issues)
  • Missing canonical tags (89 pages)
  • Duplicate title tags (45 pages)
  • Missing schema markup (22 pages)

抓取预算、Core Web Vitals、Schema标记和可索引性分析。

bash

/technical-seo <url>
/technical-seo https://example.com --depth full --include-vitals
/technical-seo --url https://example.com --crawl-limit 5000

参数：

```
<url>
```
— 目标域名
```
--depth
```
—
```
basic
```
|
```
standard
```
|
```
full
```
（默认：standard）
```
--include-vitals
```
— 执行Core Web Vitals分析
```
--crawl-limit
```
— 最大抓取页面数（默认：10000）

输出结构：

╔═══════════════════════════════════════════════════════╗
║  Technical SEO Audit  —  example.com                  ║
╠═══════════════════════════════════════════════════════╣
║  Crawling site …          [██████████] 100%  ✓ 1 204  ║
║  Checking indexability …  [██████████] 100%  ✓ Done   ║
║  Validating schema …      [████████░░]  80%  962/1204 ║
╚═══════════════════════════════════════════════════════╝

┌─────────────────────────┬──────────┬──────────┬──────────┐
│ Metric                  │ Current  │ Target   │ Status   │
├─────────────────────────┼──────────┼──────────┼──────────┤
│ Crawlable pages         │    1 204 │    1 505 │  ⚠ 80 %  │
│ Pages w/ title tag      │    1 180 │    1 204 │  ✓ 98 %  │
│ Pages w/ meta desc      │      902 │    1 204 │  ✗ 75 %  │
│ Core Web Vitals         │     Good │     Good │  ✓ Pass  │
│ Mobile-friendly         │       97 │      100 │  ⚠ 97 %  │
│ Valid schema markup     │      645 │    1 204 │  ✗ 54 %  │
│ HTTPS coverage          │    1 204 │    1 204 │  ✓ 100 % │
└─────────────────────────┴──────────┴──────────┴──────────┘

Issues Found:
🔴 Critical (24 issues)
  • 301 redirect chains (12 pages) — avg 3.4 hops
  • Mixed content warnings (8 pages)
  • Orphaned pages (4 pages) — no internal links

🟠 Warning (156 issues)
  • Missing canonical tags (89 pages)
  • Duplicate title tags (45 pages)
  • Missing schema markup (22 pages)

4. Competitor Gap Analysis

4. 竞品差距分析

Backlink gap, topic gap, and featured snippet opportunity analysis.

bash

/competitor-gap <target> <competitor1> <competitor2> ...
/competitor-gap example.com competitor1.com competitor2.com --gap-type all
/competitor-gap example.com competitor.com --gap-type backlinks --min-dr 40

Parameters:

```
<target>
```
— your domain
```
<competitor1>
```
... — competitor domains
```
--gap-type
```
—
```
backlinks
```
|
```
topics
```
|
```
snippets
```
|
```
all
```
(default: all)
```
--min-dr
```
— minimum Domain Rating filter for backlinks (default: 20)

反向链接差距、主题差距和特色摘要机会分析。

bash

/competitor-gap <target> <competitor1> <competitor2> ...
/competitor-gap example.com competitor1.com competitor2.com --gap-type all
/competitor-gap example.com competitor.com --gap-type backlinks --min-dr 40

参数：

```
<target>
```
— 你的域名
```
<competitor1>
```
... — 竞品域名
```
--gap-type
```
—
```
backlinks
```
|
```
topics
```
|
```
snippets
```
|
```
all
```
（默认：all）
```
--min-dr
```
— 反向链接的最低Domain Rating过滤值（默认：20）

5. SEO Content Brief Generator

5. SEO内容Brief生成器

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

bash

/content-brief <keyword>
/content-brief "best email marketing software" --format long
/content-brief "seo tools" --include-serp --competitor-count 10

Parameters:

```
<keyword>
```
— target keyword
```
--format
```
—
```
short
```
|
```
long
```
|
```
comprehensive
```
(default: long)
```
--include-serp
```
— include SERP analysis
```
--competitor-count
```
— number of top-ranking pages to analyze (default: 5)

Output Structure:

markdown

undefined

AI生成的内容Brief，包含大纲、NLP术语和字数目标。

bash

/content-brief <keyword>
/content-brief "best email marketing software" --format long
/content-brief "seo tools" --include-serp --competitor-count 10

参数：

```
<keyword>
```
— 目标关键词
```
--format
```
—
```
short
```
|
```
long
```
|
```
comprehensive
```
（默认：long）
```
--include-serp
```
— 包含SERP分析
```
--competitor-count
```
— 要分析的排名靠前页面数量（默认：5）

输出结构：

markdown

undefined

Content Brief: "best email marketing software"

Target Keyword Metrics

Primary Keyword: best email marketing software
Search Volume: 12,100/month
Keyword Difficulty: 78/100
Search Intent: Commercial + Comparison
Current Rank: Not ranking

Primary Keyword: best email marketing software
Search Volume: 12,100/month
Keyword Difficulty: 78/100
Search Intent: Commercial + Comparison
Current Rank: Not ranking

SERP Analysis (Top 10)

Avg Word Count: 3,450 words
Avg Images: 12
Common Content Type: Comparison list + detailed reviews
Featured Snippet: Yes (comparison table)
People Also Ask: 8 questions

Avg Word Count: 3,450 words
Avg Images: 12
Common Content Type: Comparison list + detailed reviews
Featured Snippet: Yes (comparison table)
People Also Ask: 8 questions

Recommended Outline

Introduction (150-200 words)
- Hook: email marketing ROI statistics
- Brief overview of selection criteria
Quick Comparison Table
- 10-12 tools, 5-7 key features
Detailed Reviews (2,400-2,800 words)
- Tool #1: [Name] (300-350 words each)
  - Key features
  - Pricing
  - Pros/cons
  - Best for [Repeat for 8-10 tools]
Buying Guide (400-500 words)
- How to choose
- Key features explained
- Pricing considerations

Introduction (150-200 words)
- Hook: email marketing ROI statistics
- Brief overview of selection criteria
Quick Comparison Table
- 10-12 tools, 5-7 key features
Detailed Reviews (2,400-2,800 words)
- Tool #1: [Name] (300-350 words each)
  - Key features
  - Pricing
  - Pros/cons
  - Best for [Repeat for 8-10 tools]
Buying Guide (400-500 words)
- How to choose
- Key features explained
- Pricing considerations

NLP Terms to Include

Must-have (use 5+ times):

email campaigns, automation, templates, subscribers, analytics

Should-have (use 2-4 times):

deliverability, segmentation, A/B testing, integrations, CRM

Must-have (use 5+ times):

email campaigns, automation, templates, subscribers, analytics

Should-have (use 2-4 times):

deliverability, segmentation, A/B testing, integrations, CRM

Technical Requirements

Target Word Count: 3,200-3,800 words
Images: 10-15 (screenshots, comparison graphics)
Internal Links: 4-6
External Links: 8-12 (to official tool sites)
Schema: Article + FAQPage

undefined

Target Word Count: 3,200-3,800 words
Images: 10-15 (screenshots, comparison graphics)
Internal Links: 4-6
External Links: 8-12 (to official tool sites)
Schema: Article + FAQPage

undefined

6. SERP Monitoring

6. SERP监控

Daily rank tracking with volatility alerts and CTR optimization.

bash

/serp-monitor --keywords keywords.csv --frequency daily
/serp-monitor --domain example.com --auto-discover

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

bash

/serp-monitor --keywords keywords.csv --frequency daily
/serp-monitor --domain example.com --auto-discover

7. Link Prospecting

7. 链接 prospecting（潜在源挖掘）

Quality backlink prospect list with DA/DR filters and outreach templates.

bash

/link-prospecting <topic> --min-da 30 --limit 50
/link-prospecting "marketing tools" --type guest-post --export prospects.csv

高质量反向链接潜在源列表，带有DA/DR过滤和 outreach模板。

bash

/link-prospecting <topic> --min-da 30 --limit 50
/link-prospecting "marketing tools" --type guest-post --export prospects.csv

8. Page Speed SEO Analysis

8. 页面速度SEO分析

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

bash

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

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

bash

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

9. Local SEO Audit

9. 本地SEO审核

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

bash

/local-seo <business-name> --location "New York, NY"
/local-seo "Joe's Pizza" --location "Brooklyn" --check-citations

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

bash

/local-seo <business-name> --location "New York, NY"
/local-seo "Joe's Pizza" --location "Brooklyn" --check-citations

10. Content Calendar Generator

10. 内容日历生成器

Data-driven editorial calendar from search demand and seasonality.

bash

/content-calendar --topic "email marketing" --months 3
/content-calendar --keywords keywords.csv --start 2026-06-01 --export calendar.csv

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

bash

/content-calendar --topic "email marketing" --months 3
/content-calendar --keywords keywords.csv --start 2026-06-01 --export calendar.csv

Multi-Step Workflows

多步骤工作流

Full SEO Sprint (12-step workflow)

完整SEO冲刺（12步工作流）

Comprehensive SEO audit → keyword mapping → content plan → technical fixes.

bash

/workflows:full-seo-sprint <domain> --scope full
/workflows:full-seo-sprint example.com --duration 4-weeks --export sprint-report/

Workflow Steps:

Technical SEO audit
Content quality audit
Competitor gap analysis
Keyword research & clustering
SERP intent mapping
Content cannibalization fix
Schema markup implementation
Page speed optimization
Internal linking strategy
Content brief generation
Editorial calendar creation
Rank tracking setup

全面SEO审核 → 关键词映射 → 内容规划 → 技术修复。

bash

/workflows:full-seo-sprint <domain> --scope full
/workflows:full-seo-sprint example.com --duration 4-weeks --export sprint-report/

工作流步骤：

技术SEO审核
内容质量审核
竞品差距分析
关键词研究与聚类
SERP意图映射
关键词自竞争修复
Schema标记实施
页面速度优化
内部链接策略
内容Brief生成
编辑日历创建
排名跟踪设置

Launch SEO Workflow

上线前SEO工作流

Pre-launch SEO checklist with canonical, hreflang, and sitemap validation.

bash

/workflows:launch-seo <domain> --checklist full
/workflows:launch-seo staging.example.com --export launch-checklist.md

包含canonical、hreflang和站点地图验证的上线前SEO检查清单。

bash

/workflows:launch-seo <domain> --checklist full
/workflows:launch-seo staging.example.com --export launch-checklist.md

Content Refresh Workflow

内容更新工作流

Identify and refresh underperforming pages to recover lost rankings.

bash

/workflows:content-refresh --domain example.com --rank-drop 5+
/workflows:content-refresh --url-list declining-pages.csv

识别并更新表现不佳的页面，恢复丢失的排名。

bash

/workflows:content-refresh --domain example.com --rank-drop 5+
/workflows:content-refresh --url-list declining-pages.csv

Authority Building Workflow

权威度建设工作流

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

bash

/workflows:authority-building <domain> --campaign-type guest-post
/workflows:authority-building example.com --target-dr 50+ --duration 12-weeks

端到端的数字PR和链接建设活动。

bash

/workflows:authority-building <domain> --campaign-type guest-post
/workflows:authority-building example.com --target-dr 50+ --duration 12-weeks

AI Content Pipeline

AI内容流水线

Keyword → brief → draft → optimize → publish automation.

bash

/workflows:ai-content-pipeline --keywords keywords.csv --auto-publish false
/workflows:ai-content-pipeline --topic "seo tools" --count 10

关键词 → Brief → 草稿 → 优化 → 发布自动化。

bash

/workflows:ai-content-pipeline --keywords keywords.csv --auto-publish false
/workflows:ai-content-pipeline --topic "seo tools" --count 10

Configuration

配置

Create a

.seo-config.yml

file in your project root:

yaml

undefined

在项目根目录创建

.seo-config.yml

文件：

yaml

undefined

SEO Suite Configuration

domain: example.com analytics: google_analytics_id: ${GA_MEASUREMENT_ID} google_search_console: ${GSC_PROPERTY_URL}

search_data: api_provider: semrush # semrush | ahrefs | moz api_key: ${SEO_API_KEY}

crawl_settings: max_pages: 10000 user_agent: "SEO-Skills-Bot/1.0" respect_robots: true crawl_delay_ms: 100

content_audit: min_word_count: 300 quality_thresholds: excellent: 80 good: 60 fair: 40

reporting: output_format: markdown # markdown | json | csv export_path: ./seo-reports/ include_screenshots: true

undefined

domain: example.com analytics: google_analytics_id: ${GA_MEASUREMENT_ID} google_search_console: ${GSC_PROPERTY_URL}

search_data: api_provider: semrush # semrush | ahrefs | moz api_key: ${SEO_API_KEY}

crawl_settings: max_pages: 10000 user_agent: "SEO-Skills-Bot/1.0" respect_robots: true crawl_delay_ms: 100

content_audit: min_word_count: 300 quality_thresholds: excellent: 80 good: 60 fair: 40

reporting: output_format: markdown # markdown | json | csv export_path: ./seo-reports/ include_screenshots: true

undefined

Environment Variables

环境变量

Set these in your

.env

file:

bash

undefined

在

.env

文件中设置以下变量：

bash

undefined

Required for keyword research

SEO_API_KEY=your_semrush_or_ahrefs_key

Optional: Google Search Console API

GSC_PROPERTY_URL=https://example.com/ GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json

Optional: Google Analytics

GA_MEASUREMENT_ID=G-XXXXXXXXXX

undefined

GA_MEASUREMENT_ID=G-XXXXXXXXXX

undefined

Common Patterns

常见使用模式

Pattern 1: Monthly SEO Health Check

模式1：月度SEO健康检查

bash

undefined

bash

undefined

Run comprehensive monthly audit

运行全面月度审核

/technical-seo https://example.com --depth full --include-vitals /content-audit --scope full --min-words 300 /serp-monitor --keywords top-keywords.csv --compare-last-month

Generate report

生成报告

/workflows:full-seo-sprint example.com --scope audit-only --export monthly-report/

undefined

/workflows:full-seo-sprint example.com --scope audit-only --export monthly-report/

undefined

Pattern 2: New Content Creation Workflow

模式2：新内容创建工作流

bash

undefined

bash

undefined

1. Research keywords

1. 研究关键词

/keyword-research "target topic" --depth extensive --output csv

2. Generate content brief

2. 生成内容Brief

/content-brief "chosen keyword" --format comprehensive --include-serp

3. Create content calendar

3. 创建内容日历

/content-calendar --keywords selected-keywords.csv --months 3

4. Generate first draft (using brief)

4. 生成初稿（使用Brief）

... write content ...

... 撰写内容 ...

5. Pre-publish SEO check

5. 发布前SEO检查

/technical-seo <draft-url> --depth basic

undefined

/technical-seo <draft-url> --depth basic

undefined

Pattern 3: Competitor Outranking Strategy

模式3：竞品超越策略

bash

undefined

bash

undefined

1. Identify competitor gaps

1. 识别竞品差距

/competitor-gap example.com competitor1.com competitor2.com --gap-type all

2. Find keyword opportunities

2. 寻找关键词机会

/keyword-research "competitor topic" --scope commercial

3. Build better content

3. 创建更优质内容

/content-brief "target keyword" --competitor-count 10

4. Get backlinks

4. 获取反向链接

/link-prospecting "topic" --min-da 40 --type guest-post

undefined

/link-prospecting "topic" --min-da 40 --type guest-post

undefined

Pattern 4: Recovering from Traffic Drop

模式4：流量下降恢复

bash

undefined

bash

undefined

1. Identify declining pages

1. 识别排名下降的页面

/serp-monitor --domain example.com --rank-drop 5+ --last-30-days

2. Audit affected pages

2. 审核受影响页面

/content-audit --url-list declining-pages.csv

3. Run refresh workflow

3. 运行更新工作流

/workflows:content-refresh --url-list declining-pages.csv

4. Check technical issues

4. 检查技术问题

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

undefined

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

undefined

Programmatic Usage

程序化使用

Using as a Library

作为库使用

If you need to integrate commands into your own scripts:

python

undefined

如果需要将命令集成到自己的脚本中：

python

undefined

Python example (requires Python bindings)

from seo_skills import KeywordResearch, ContentAudit

Keyword research

kr = KeywordResearch(api_key=os.getenv('SEO_API_KEY')) results = kr.analyze( seed_keyword="email marketing", depth="extensive", intent_filter="commercial" )

for keyword in results.opportunities: print(f"{keyword.term}: {keyword.volume} vol, {keyword.difficulty} KD")

kr = KeywordResearch(api_key=os.getenv('SEO_API_KEY')) results = kr.analyze( seed_keyword="email marketing", depth="extensive", intent_filter="commercial" )

for keyword in results.opportunities: print(f"{keyword.term}: {keyword.volume} vol, {keyword.difficulty} KD")

Content audit

audit = ContentAudit(domain="example.com") report = audit.run(scope="full", min_words=300)

print(f"Quality distribution: {report.quality_distribution}") print(f"Critical issues: {len(report.critical_issues)}")

undefined

audit = ContentAudit(domain="example.com") report = audit.run(scope="full", min_words=300)

print(f"Quality distribution: {report.quality_distribution}") print(f"Critical issues: {len(report.critical_issues)}")

undefined

CLI Batch Processing

CLI批量处理

bash

undefined

bash

undefined

Process multiple keywords from CSV

处理CSV中的多个关键词

cat keywords.csv | while read keyword; do /content-brief "$keyword" --format long --export "briefs/${keyword}.md" done

Audit multiple domains

审核多个域名

for domain in $(cat domains.txt); do /technical-seo "$domain" --export "audits/${domain}.json" done

undefined

for domain in $(cat domains.txt); do /technical-seo "$domain" --export "audits/${domain}.json" done

undefined

Troubleshooting

故障排除

Issue: "API rate limit exceeded"

问题："API rate limit exceeded"

Solution: Configure crawl delay or reduce batch size:

yaml

undefined

解决方案： 配置抓取延迟或减少批量大小：

yaml

undefined

.seo-config.yml

crawl_settings: crawl_delay_ms: 500 # Increase delay concurrent_requests: 2 # Reduce concurrency

undefined

crawl_settings: crawl_delay_ms: 500 # 增加延迟 concurrent_requests: 2 # 减少并发数

undefined

Issue: "No keyword data returned"

问题："No keyword data returned"

Check:

API key is valid:
```
echo $SEO_API_KEY
```
API provider configured correctly in
```
.seo-config.yml
```
Keyword has sufficient search volume (try broader terms)

检查项：

API密钥有效：
```
echo $SEO_API_KEY
```
```
.seo-config.yml
```
中API提供商配置正确
关键词有足够的搜索量（尝试更宽泛的术语）

Issue: "Crawl blocked by robots.txt"

问题："Crawl blocked by robots.txt"

Solution:

yaml

undefined

解决方案：

yaml

undefined

.seo-config.yml

crawl_settings: respect_robots: false # Only for your own sites!

Or add your user agent to robots.txt:

User-agent: SEO-Skills-Bot

Allow: /

undefined

crawl_settings: respect_robots: false # 仅适用于你自己的站点！

或在robots.txt中添加你的用户代理：

User-agent: SEO-Skills-Bot

Allow: /

undefined

Issue: "Schema validation failing"

问题："Schema validation failing"

Debug:

bash

undefined

调试：

bash

undefined

Run schema-only check

仅运行Schema检查

/technical-seo https://example.com --check-schema-only --verbose

Test specific page

测试特定页面

curl -s https://example.com/page | grep -o '<script type="application/ld+json">.*</script>'

undefined

curl -s https://example.com/page | grep -o '<script type="application/ld+json">.*</script>'

undefined

Issue: "Duplicate content false positives"

问题："Duplicate content false positives"

Tune similarity threshold:

yaml

undefined

调整相似度阈值：

yaml

undefined

.seo-config.yml

content_audit: similarity_threshold: 85 # Default: 75 (increase to reduce false positives) ignore_boilerplate: true # Ignore headers/footers/sidebars

undefined

content_audit: similarity_threshold: 85 # 默认：75（提高以减少误报） ignore_boilerplate: true # 忽略页眉/页脚/侧边栏

undefined

Advanced Features

高级功能

Custom Command Aliases

自定义命令别名

Create shortcuts in

~/.claude/aliases.yml

yaml

aliases:
  quick-seo: "technical-seo {0} --depth basic && content-audit --url {0} --scope pages"
  content-sprint: "workflows:ai-content-pipeline --topic {0} --count 5"
  rank-check: "serp-monitor --keywords {0} --frequency daily"

Usage:

bash

/quick-seo https://example.com
/content-sprint "email marketing"
/rank-check top-keywords.csv

在

~/.claude/aliases.yml

中创建快捷方式：

yaml

aliases:
  quick-seo: "technical-seo {0} --depth basic && content-audit --url {0} --scope pages"
  content-sprint: "workflows:ai-content-pipeline --topic {0} --count 5"
  rank-check: "serp-monitor --keywords {0} --frequency daily"

使用方式：

bash

/quick-seo https://example.com
/content-sprint "email marketing"
/rank-check top-keywords.csv

Integration with CI/CD

与CI/CD集成

GitHub Actions example:

yaml

undefined

GitHub Actions示例：

yaml

undefined

.github/workflows/seo-audit.yml

name: Weekly SEO Audit on: schedule: - cron: '0 9 * * 1' # Every Monday at 9 AM

jobs: seo-audit: runs-on: ubuntu-latest steps: - uses: actions/checkout@v3

  - name: Run SEO audit
    env:
      SEO_API_KEY: ${{ secrets.SEO_API_KEY }}
    run: |
      /technical-seo https://example.com --depth full --export audit.json
      /content-audit --scope full --export content-audit.csv
      
  - name: Upload reports
    uses: actions/upload-artifact@v3
    with:
      name: seo-reports
      path: |
        audit.json
        content-audit.csv

undefined

name: Weekly SEO Audit on: schedule: - cron: '0 9 * * 1' # 每周一上午9点

jobs: seo-audit: runs-on: ubuntu-latest steps: - uses: actions/checkout@v3

  - name: Run SEO audit
    env:
      SEO_API_KEY: ${{ secrets.SEO_API_KEY }}
    run: |
      /technical-seo https://example.com --depth full --export audit.json
      /content-audit --scope full --export content-audit.csv
      
  - name: Upload reports
    uses: actions/upload-artifact@v3
    with:
      name: seo-reports
      path: |
        audit.json
        content-audit.csv

undefined

Webhook Notifications

Webhook通知

Configure Slack/Discord alerts in

.seo-config.yml

yaml

notifications:
  webhook_url: ${SLACK_WEBHOOK_URL}
  alert_on:
    - rank_drop: 5  # Alert if any keyword drops 5+ positions
    - critical_issues: true
    - core_vitals_fail: true

在

.seo-config.yml

中配置Slack/Discord警报：

yaml

notifications:
  webhook_url: ${SLACK_WEBHOOK_URL}
  alert_on:
    - rank_drop: 5  # 当关键词排名下降5位以上时触发警报
    - critical_issues: true
    - core_vitals_fail: true

Next Steps

下一步行动

Install the skill following the Installation section
Run your first audit:
```
/technical-seo <your-domain>
```

Explore workflows:

/workflows:full-seo-sprint <your-domain> --scope full

Set up monitoring:

/serp-monitor --domain <your-domain> --auto-discover

For more examples and updates, visit the GitHub repository.

安装技能 遵循安装部分的步骤
运行首次审核：
```
/technical-seo <your-domain>
```

探索工作流：

/workflows:full-seo-sprint <your-domain> --scope full

设置监控：

/serp-monitor --domain <your-domain> --auto-discover

如需更多示例和更新，请访问GitHub仓库。