Use when you need to research a target keyword before creating a page — discovers SERP competitors, analyzes their content strategy, builds a keyword pool, and outputs a structured Brief that feeds directly into /shipany-page-builder.
| 范围 | 说明 |
|---|---|
| 输入 | 目标关键词(必需)、用户关键词+搜索量(可选)、竞品 URL(可选) |
| 输出 | Markdown Brief 报告、/tmp/competitor-analysis.json |
| 修改 | 不修改任何项目代码、页面文件、配置文件 |
| 不做 | 不创建页面(交给 /shipany-page-builder)、不翻译(交给 /auto-i18n) |
/shipany-page-builder 或 /i18n-content-audit/keyword-research/competitor-analysis/auto-i18n你必须完成每个 CHECKPOINT 才能进入下一步。不可跳过任何 CHECKPOINT。
BLOCKING: 先从用户请求中提取结构化输入。
需要确认:
keyword: 目标关键词(如 "AI Image Generator")locale: 目标语言(默认 en)user_keywords: 用户提供的关键词+搜索量(如有)competitor_urls: 用户指定的竞品 URL(如有,否则自动发现)确认格式: "INPUT: keyword='{keyword}', locale={locale}, user_keywords={N}个, competitor_urls={N}个"
BLOCKING: 必须找到至少 10 个有效竞品 URL。
WebSearch 搜索目标关键词
{keyword} 获取 SERP 结果best {keyword}, {keyword} online free筛选竞品 URL
补充搜索(如不足 10 个)
{keyword} alternatives, {keyword} tools确认格式: "CHECKPOINT 1 COMPLETE: 发现 {N} 个竞品 URL"
列出全部 URL。
BLOCKING: 必须获取至少 7/10 个竞品的完整数据。
python3 .claude/skills/content-brief/scripts/analyze_competitors.py \
--keyword "{keyword}" \
--urls "{url1},{url2},...,{url10}" \
--locale {locale} \
--output /tmp/competitor-analysis.json
读取分析报告
读取 /tmp/competitor-analysis.json,提取:
h2_keyword_patterns):高频词、短语、修饰词第 2 层:WebFetch 补充(对脚本抓取失败或数据不足的页面)
word_count < 100 或 h2_count = 0 或 error → 数据不足WebFetch: {url}
提取: 页面标题、所有 H2 标题、大致字数、是否有 FAQ/demo/gallery
第 3 层:Playwright 浏览器兜底(对脚本 + WebFetch 都失败的页面)
1. mcp__playwright__playwright_navigate → {url}
2. mcp__playwright__playwright_get_visible_html (cleanHtml=true, maxLength=50000)
3. 从 HTML 中提取: title, H2 列表, 大致字数, FAQ/demo/gallery 特征
mcp__playwright__playwright_close错误恢复
输出竞品洞察报告
对每个竞品:
#N domain.com (字数: XXXX)
H1: "..."
H2 结构: [列出所有 H2]
关键词策略: primary X次, 密度 X%
特色: [demo/gallery/comparison/FAQ等]
聚合输出(含 H2 关键词模式):
共性总结:
- X/10 有在线 demo/generator
- X/10 有 showcase/gallery
- 平均字数: XXXX
- 平均 FAQ: X 个
竞品 H2 关键词模式:
- 高频词: image(8), generator(7), free(5), ...
- 高频短语: "image generator"(6), "art generator"(3), ...
- 常用修饰词: free, best, online, top, ...
差异化机会:
- [基于竞品弱点识别的机会]
确认格式: "CHECKPOINT 2 COMPLETE: 分析 {N}/10 竞品,平均字数 {X},H2 高频词 {top3}"
BLOCKING: 必须产出完整的关键词池和分布策略。
AI 关键词拓展 基于目标关键词 + CHECKPOINT 2 的竞品 H2 关键词模式,生成:
关键:参考竞品 H2 中的高频词和修饰词来指导拓展方向!
合并用户提供的关键词(如有)
参考竞品关键词用法
h2_keyword_patterns.top_words 和 top_bigrams 中提取规划关键词分布 参考 _shared/references/seo-standards.md 中的分布规则:
H1: [primary keyword + value proposition]
H2-1: [primary 或 long-tail] ← primary ≤50%
H2-2: [semantic variant] ← variants 50%+
H2-3: [related term]
H2-4: [long-tail]
...
密度目标: 参照 seo-standards.md 中 {locale} 的 Target Density
确认格式: "CHECKPOINT 3 COMPLETE: 关键词池 {N}个 (primary 1, long-tail {N}, semantic {N}, related {N}), 用户提供 {N}个"
BLOCKING: Brief 必须通过质量门控。
推荐页面结构 基于 CHECKPOINT 2 的竞品分析和推荐结构:
设定目标参数 参考 _shared/references/seo-standards.md:
识别差异化机会
输出结构化 Brief 按照 references/02-brief-template.md 格式输出。
输出前自检:
确认格式: "CHECKPOINT 4 COMPLETE: Brief 已生成,推荐 {N} 个 section,目标 {X} words,质量门控 {N}/{N} 通过"
SEO 标准: 参考 _shared/references/seo-standards.md
可用 Block: 参考 references/01-block-registry.md
Brief 模板: 参考 references/02-brief-template.md
竞品分析脚本: scripts/analyze_competitors.py(零依赖,用 python3 执行)
/content-brief (本 Skill — 调研 + 规划)
↓ Brief 作为输入
/shipany-page-builder (创建页面)
↓ 国际化
/auto-i18n (翻译)
↓ 审计
/i18n-content-audit (质量检查)
在 CHECKPOINT 3 中,对于高竞争关键词,建议主动调用:
/keyword-research — 更深入的关键词拓展和 topic cluster 分析/serp-analysis — SERP 特征分析(featured snippet、PAA、SERP 布局)判断标准: 如果 CHECKPOINT 2 发现竞品平均字数 > 2000 或竞品数 > 8 个产品页,说明竞争激烈,建议主动使用上述 Skill。
Last Updated: 2026-02-07