用途
Keyword Wedge 面向“产品做得好但缺乏 SEO 经验”的技术创始人,核心目标是:把应用真实的功能与信息表达,连接到真实的搜索需求上,找出低竞争的关键词立足点(称为“wedge”)。先在这些低竞争词上建立排名,随后在多次运行中逐步扩展到相邻的更高竞争词。
该技能定位为“SEO 策略师 + 增长分析师”,强调分析与教育并重:不仅告诉用户做什么,还以开发者能理解的方式解释为什么重要。
主要能力
- 扫描代码库,提取 UI 文案、meta 标签、营销页面、README、标题、CTA、功能描述、结构化数据等信息,识别应用的功能列表、价值主张、当前信息主题与内容清单。
- 评估渲染与 SEO 可见性:识别框架(SPA/SSR/静态/混合)、meta 标签、robots.txt、sitemap、Open Graph、canonical URL,以及客户端与服务端渲染的边界,列出 Google 能抓取与不能抓取的内容。
- 接入并交叉比对三类数据源:
- Google Search Console(API 或已有 MCP):查询词、展示次数、点击、CTR、平均排名、落地页。
- PostHog 分析(API 或 PostHog MCP 技能):按路径的页面浏览量、引荐来源、获客渠道、漏斗完成率、功能使用频率。
- Google Keyword Planner(通过 Claude-in-Chrome MCP 浏览器自动化):关键词搜索量与竞争度。
- 对关键词组合进行分类整理,划分为三类:
- 正在起效的关键词:当前已有排名并带来流量,评估是否扩展至相邻词或加大杠杆。
- 表现不佳的关键词:有展示无点击,或有点击无转化,诊断原因(信息不匹配、落地页错误、内容薄弱、渲染问题等)。
- 新的候选楔子:尚未覆盖但应当覆盖的关键词。
- 意图匹配(在 PostHog 数据允许时):串联“搜索词 → 落地页 → 用户行为”,找出信息表达与搜索意图不匹配之处。
- 评估 PostHog 事件埋点覆盖情况,报告已有事件、缺口,以及为后续更丰富分析建议补充的埋点。
- 生成为 Markdown 与 HTML 两种格式的报告。
- 维护状态文件以支持多次运行:strategy.json、history.json、expansion-plan.json,并可对比当前排名与上一轮目标,展示扩展进展。
使用方式
该技能以任务(Phase)流程推进,使用 TaskCreate、TaskUpdate、TaskList 工具管理进度,并支持会话恢复:技能启动时先调用 TaskList,若存在进行中的 Keyword Wedge Analysis 任务,则根据子任务状态从相应阶段继续;全部完成后展示最终总结。
主要阶段:
- 评估当前状态:检查 .keyword-wedge/state/ 下是否已有策略与历史数据,判断是“首次运行”还是“回归运行”;询问用户模式:完整分析(全部数据源)/ 快速更新(仅 Search Console + PostHog,跳过 Keyword Planner)/ 冷启动(新应用、暂无搜索数据)。
- 探索应用(委派给代理):并行创建并运行两个探索代理——“信息与功能”与“渲染与 SEO 可见性”。
- 确认对应用的理解(必需):呈现应用描述、核心功能、价值主张、渲染策略与 SEO 可见性评估,用 AskUserQuestion 请用户确认或纠正;未确认前不进入数据收集,以免错误假设污染后续分析。
- 认证检查与通过 API 收集数据(委派给代理):检查各服务认证,若有服务不可访问则报告失败项与需要配置的内容,并以可用来源继续;并行运行 Search Console 代理与 PostHog 代理。
- 通过浏览器自动化收集 Keyword Planner 数据:借助 Claude-in-Chrome MCP 访问 Google Keyword Planner,基于已确认的应用理解与已有 Search Console 数据进行关键词机会研究;冷启动模式下先从应用功能与价值主张生成候选关键词再研究;若 Claude-in-Chrome 不可用,则跳过该阶段并在报告中注明缺口,仅使用 Search Console 与 PostHog 数据。
- 评估 PostHog 埋点覆盖,对照完整意图匹配所需的事件,报告现状与缺口。
- 关键词组合分类整理,跨三类关键词分析全部已收集数据,并进行意图匹配;回归运行时会对比当前排名与此前目标。
- 与用户复核(必需):呈现按机会大小(搜索量 × 低竞争信号)排序的楔子策略,并针对回归运行加入扩展进展;用 AskUserQuestion 提供选项:批准策略 / 调整优先级 / 聚焦特定类别 / 以不同关键词重跑。
- 生成报告(委派给代理):获批后生成 Markdown 报告(.keyword-wedge/reports/YYYY-MM-DD.md)与 HTML 报告(.keyword-wedge/reports/YYYY-MM-DD.html)。
- 更新状态并完成:更新 .keyword-wedge/state/ 下的 strategy.json、history.json、expansion-plan.json,标记任务完成,并展示最终总结(报告路径、模式、机会摘要、埋点情况、下次运行建议)。
此外,该技能包含参考材料:references/agent-prompts.md、references/data-source-guide.md、references/keyword-categories.md、references/instrumentation-checklist.md、references/report-structure.md、references/state-schema.md,以及 examples/wedge-report-example.md。
适用场景
- 技术创始人希望以低竞争关键词为切入点启动 SEO,并逐步扩展到更高竞争词。
- 已接入 Google Search Console 与 PostHog,希望把搜索表现与用户行为、转化数据打通分析。
- 需要诊断“有展示无点击”或“有点击无转化”的关键词问题。
- 需要进行多轮迭代的 SEO 策略:同一应用反复运行,跟踪楔子扩展进展并规划下一批目标。
- 新应用尚无搜索数据时,可通过冷启动模式从应用功能与价值主张出发寻找关键词方向。
限制
- 依赖外部数据源与认证:Search Console、PostHog 需可访问;Keyword Planner 需 Claude-in-Chrome MCP 浏览器自动化,若不可用则跳过该阶段并注明数据缺口。
- 部分判断依赖 PostHog 埋点质量;事件覆盖不足时,意图匹配能力受限,报告会说明缺口与建议补充的事件。
- Keyword Planner 的竞争度是付费竞争指标的代理,仅能在低端近似自然搜索难度,报告中会注明这一局限。
- 在冷启动等缺少实测数据的情况下,技能要求明确区分“有数据支撑的结论”与“推断”。
- 需要用户在两个环节介入确认:确认对应用的理解、审核策略,否则流程不继续。
- 关于收费、价格、支持平台、具体效果等信息,资料中暂未提供。