需要做 SEO 审计、关键词研究、内容优化和竞品分析时…

当你要对站点进行 SEO 与内容营销全流程分析、生成内容简报/日历并执行竞品与外链策略时使用。

适用场景

解决思路

1. 安装技能：执行 `mkdir -p ~/.claude/skills`，`cd ~/.claude/skills`，`git clone https://github.com/Datalocastle/r03-anthropics-skills-seo.git`；或执行 `cp -r /path/to/r03-anthropics-skills-seo ~/.claude/skills/`。
2. 在 Claude Code 中注册技能：在会话中执行 `/read ~/.claude/skills/r03-anthropics-skills-seo/SKILL.md`，或在 `~/.claude/config.yml` 中写入 `skills: - path: ~/.claude/skills/r03-anthropics-skills-seo enabled: true`。
3. 运行关键词研究：执行 `/keyword-research <target>`，可加 `--depth quick|standard|extensive`（默认 standard）、`--scope informational|commercial|transactional|all`（默认 all）、`--output md|json|csv`（默认 md）；例 `/keyword-research 'email marketing tools' --depth extensive`、`/keyword-research 'seo' --scope commercial --output json`；输出关键词聚类、KD、意图、机会评分和行动计划。
4. 运行内容审计：执行 `/content-audit --scope full --output md`，可加 `--url https://example.com --scope pages --filter /blog/*`、`--min-words 300 --export audit-report.csv`；参数 `--scope full|pages|posts|category:<name>`、`--url`、`--filter` glob、`--min-words` 默认 100、`--export`；输出质量分分布、重复/蚕食问题与行动计划。
5. 运行技术 SEO 审计：执行 `/technical-seo <url>`，可加 `--depth full --include-vitals`、`--url https://example.com --crawl-limit 5000`；参数 `--depth basic|standard|full` 默认 standard、`--include-vitals`、`--crawl-limit` 默认 10000；输出抓取预算、Core Web Vitals、schema、可索引性、重定向链、canonical、标题/描述缺失等问题。
6. 运行竞品差距分析：执行 `/competitor-gap <target> <competitor1> <competitor2> ...`，可加 `--gap-type all` 或 `--gap-type backlinks --min-dr 40`；参数 `--gap-type backlinks|topics|snippets|all` 默认 all、`--min-dr` 默认 20；分析外链差距、主题差距、精选摘要机会。
7. 生成 SEO 内容简报：执行 `/content-brief <keyword>`，可加 `--format long`、`--include-serp --competitor-count 10`；参数 `--format short|long|comprehensive` 默认 long、`--include-serp`、`--competitor-count` 默认 5；输出关键词指标、SERP 分析、推荐大纲、NLP 词、技术要求和字数目标。
8. 运行 SERP 监控：执行 `/serp-monitor --keywords keywords.csv --frequency daily`，或 `/serp-monitor --domain example.com --auto-discover`；进行每日排名跟踪、波动告警和 CTR 优化。
9. 进行链接 prospecting：执行 `/link-prospecting <topic> --min-da 30 --limit 50`，或 `/link-prospecting 'marketing tools' --type guest-post --export prospects.csv`；生成带 DA/DR 过滤的外链机会列表和 outreach 模板。
10. 运行页面速度 SEO 分析：执行 `/page-speed-seo <url>`，或 `/page-speed-seo https://example.com/page --device mobile`；诊断 render-blocking、LCP、CLS、FID 并映射到排名影响。
11. 运行本地 SEO 审计：执行 `/local-seo <business-name> --location 'New York, NY'`，或 `/local-seo 'Joe's Pizza' --location 'Brooklyn' --check-citations`；检查 NAP 一致性、Google Business Profile 优化和本地 citation。
12. 生成内容日历：执行 `/content-calendar --topic 'email marketing' --months 3`，或 `/content-calendar --keywords keywords.csv --start 2026-06-01 --export calendar.csv`；基于搜索需求和季节性创建编辑日历。
13. 运行完整 SEO Sprint 工作流：执行 `/workflows:full-seo-sprint <domain> --scope full`，或 `/workflows:full-seo-sprint example.com --duration 4-weeks --export sprint-report/`；该工作流依次做：1 技术 SEO 审计，2 内容质量审计，3 竞品差距分析，4 关键词研究与聚类，5 SERP 意图映射，6 内容蚕食修复，7 schema markup 实施，8 页面速度优化，9 内链策略，10 内容简报生成，11 编辑日历创建，12 排名跟踪设置。
14. 运行上线 SEO 工作流：执行 `/workflows:launch-seo <domain> --checklist full`，或 `/workflows:launch-seo staging.example.com --export launch-checklist.md`；做上线前 SEO 清单，验证 canonical、hreflang 和 sitemap。
15. 运行内容刷新工作流：执行 `/workflows:content-refresh --domain example.com --rank-drop 5+`，或 `/workflows:content-refresh --url-list declining-pages.csv`；找出表现不佳页面并刷新以恢复排名。
16. 运行权威建设工作流：执行 `/workflows:authority-building <domain> --campaign-type guest-post`，或 `/workflows:authority-building example.com --target-dr 50+ --duration 12-weeks`；执行端到端数字 PR 和外链建设活动。
17. 运行 AI 内容管道：执行 `/workflows:ai-content-pipeline --keywords keywords.csv --auto-publish false`，或 `/workflows:ai-content-pipeline --topic 'seo tools' --count 10`；自动化关键词→简报→草稿→优化→发布流程。
18. 创建 `.seo-config.yml`：在项目根目录配置 `domain`、`analytics`（`google_analytics_id`、`google_search_console`）、`search_data`（`api_provider: semrush|ahrefs|moz`、`api_key`）、`crawl_settings`（`max_pages`、`user_agent`、`respect_robots`、`crawl_delay_ms`）、`content_audit`（`min_word_count`、`quality_thresholds`）、`reporting`（`output_format`、`export_path`、`include_screenshots`）。
19. 在 `.env` 中设置环境变量：必需 `SEO_API_KEY=your_semrush_or_ahrefs_key`；可选 `GSC_PROPERTY_URL=https://example.com/`、`GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json`、`GA_MEASUREMENT_ID=G-XXXXXXXXXX`。
20. 执行月度 SEO 健康检查模式：运行 `/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`，再用 `/workflows:full-seo-sprint example.com --scope audit-only --export monthly-report/` 生成报告。
21. 执行新内容创建工作流：1 `/keyword-research 'target topic' --depth extensive --output csv`；2 `/content-brief 'chosen keyword' --format comprehensive --include-serp`；3 `/content-calendar --keywords selected-keywords.csv --months 3`；4 按简报写内容；5 发布前运行 `/technical-seo <draft-url> --depth basic`。
22. 执行竞品超越策略：1 `/competitor-gap example.com competitor1.com competitor2.com --gap-type all`；2 `/keyword-research 'competitor topic' --scope commercial`；3 `/content-brief 'target keyword' --competitor-count 10`；4 `/link-prospecting 'topic' --min-da 40 --type guest-post`。
23. 执行流量下降恢复流程：1 `/serp-monitor --domain example.com --rank-drop 5+ --last-30-days`；2 `/content-audit --url-list declining-pages.csv`；3 `/workflows:content-refresh --url-list declining-pages.csv`；4 `/technical-seo https://example.com --depth full`。
24. 作为 Python 库使用：`from seo_skills import KeywordResearch, ContentAudit`；用 `KeywordResearch(api_key=os.getenv('SEO_API_KEY'))` 调 `kr.analyze(seed_keyword='email marketing', depth='extensive', intent_filter='commercial')`，遍历 `results.opportunities` 打印关键词、volume、difficulty；用 `ContentAudit(domain='example.com')` 调 `report = audit.run(scope='full', min_words=300)`，打印质量分布和 critical issues。
25. CLI 批处理：执行 `cat keywords.csv | while read keyword; do /content-brief '$keyword' --format long --export 'briefs/${keyword}.md'; done`；执行 `for domain in $(cat domains.txt); do /technical-seo '$domain' --export 'audits/${domain}.json'; done`。
26. 处理 API rate limit exceeded：在 `.seo-config.yml` 的 `crawl_settings` 中增大 `crawl_delay_ms: 500`，减少 `concurrent_requests: 2`。
27. 处理 No keyword data returned：执行 `echo $SEO_API_KEY` 检查 key；检查 `.seo-config.yml` 中 API provider 配置；尝试更宽泛关键词。
28. 处理 Crawl blocked by robots.txt：仅自有站点可在 `.seo-config.yml` 设 `crawl_settings.respect_robots: false`，或在 robots.txt 添加 `User-agent: SEO-Skills-Bot` 和 `Allow: /`。
29. 处理 Schema validation failing：运行 `/technical-seo https://example.com --check-schema-only --verbose`；用 `curl -s https://example.com/page | grep -o '<script type="application/ld+json">.*</script>'` 检查 JSON-LD。
30. 处理 Duplicate content false positives：在 `.seo-config.yml` 的 `content_audit` 中增大 `similarity_threshold: 85`（默认 75），设置 `ignore_boilerplate: true`。
31. 创建自定义命令别名：在 `~/.claude/aliases.yml` 写入 `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'`；使用 `/quick-seo https://example.com`、`/content-sprint 'email marketing'`、`/rank-check top-keywords.csv`。
32. 集成 CI/CD：创建 `.github/workflows/seo-audit.yml`，用 `on.schedule.cron: '0 9 * * 1'` 每周一 9 点运行；步骤包括 `actions/checkout@v3`、设置 `SEO_API_KEY: ${{ secrets.SEO_API_KEY }}`、运行 `/technical-seo https://example.com --depth full --export audit.json` 和 `/content-audit --scope full --export content-audit.csv`、用 `actions/upload-artifact@v3` 上传 `audit.json` 与 `content-audit.csv`。
33. 配置 Webhook 通知：在 `.seo-config.yml` 写 `notifications.webhook_url: ${SLACK_WEBHOOK_URL}`，并设置 `alert_on: - rank_drop: 5 - critical_issues: true - core_vitals_fail: true`。
34. 按下一步执行：先安装技能，再运行 `/technical-seo <your-domain>`，然后探索 `/workflows:full-seo-sprint <your-domain> --scope full`，最后设置 `/serp-monitor --domain <your-domain> --auto-discover`。

适用边界 · 注意事项

• 没有 Claude Code 技能环境或未配置 `SEO_API_KEY`（Semrush/Ahrefs/Moz 等付费数据源）时，关键词研究、SERP、外链、排名等数据命令无法获得有效结果。
• 不要对非自有站点设置 `respect_robots: false` 或绕过 robots.txt 抓取。
• 不适用于非 SEO/内容营销任务；若没有第三方 SEO 数据额度和 API key，也不适合依赖实时精确排名数据。