营销增长
需要做 SEO 主题集群/内容架构时,用 SERP…
当用户提到 topic cluster、content cluster、semantic clustering、pillar page、hub and spoke、content architecture、keyword grouping 或 cluster plan 时,基于 Google SERP 实际重叠而非文本相似度来规划内容集群。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 49/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 85/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 60/100 ×0.15
适用场景
需要做 SEO 主题集群/内容架构时,用通用
解决思路
- 使用 /seo cluster plan <seed-keyword> 执行完整规划工作流:扩词、聚类、架构、可视化。
- 使用 /seo cluster plan --from strategy 从已有 /seo plan 输出导入。
- 使用 /seo cluster execute 执行计划:若安装 claude-blog 则创建内容,否则输出 brief。
- 使用 /seo cluster map 重新生成交互式集群可视化。
- Step 1:用 WebSearch 将种子关键词扩展为 30-50 个变体。
- 提取相关搜索:搜索种子词,提取 related searches 和 people also search for。
- 提取 PAA:从 SERP 结果中提取所有 People Also Ask 问题。
- 追加长尾修饰词:best、how to、vs、for beginners、tools、examples、guide、template、mistakes、checklist。
- 问题挖掘:生成 who/what/when/where/why/how 变体。
- 意图修饰词:添加商业词:pricing、review、alternative、comparison、free、top。
- 去重:小写化、去掉冠词、删除完全重复;目标 30-50 个唯一变体;若不足 30,用最高频 PAA 问题作为种子再做一轮扩展。
- Step 2 SERP 重叠聚类:加载 references/serp-overlap-methodology.md 获取完整算法。
- 按初始意图猜测分组关键词,减少两两比较。
- 对组内每个候选关键词对,用 WebSearch 搜索两个关键词。
- 统计 top 10 自然结果中的共享 URL,忽略广告、精选摘要、PAA。
- 按阈值处理:共享 7-10 个结果 -> 同一篇文章,合并为单个目标页;4-6 -> 同一集群,归入同一 spoke 集群;2-3 -> 互链,放入相邻集群并增加交叉链接;0-1 -> 分开,分配到不同集群或排除。
- 优化比较量:40 个关键词全量两两=780 次;先按意图分组,例如 4 组约 10 个 = 4 x 45 = 180 次;只交叉检查组边界关键词;跳过同 head term 的长尾变体对,默认同集群。
- DataForSEO 集成:若可用 DataForSEO MCP,用 serp_organic_live_advanced 替代 WebSearch 获取 SERP;每批前运行 "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run dataforseo_costs.py check serp_organic_live_advanced --count N;若 status 为 needs_approval,展示成本估算并询问用户;若 status 为 blocked,回退到 WebSearch。
- Step 3 意图分类:将每个关键词分到四类之一;Informational 如 how、what、why、guide、tutorial、learn -> 纳入;Commercial 如 best、top、review、comparison、vs、alternative -> 纳入;Transactional 如 buy、price、discount、coupon、order、sign up -> 纳入;Navigational 如品牌名、具体产品名、login -> 不纳入,排除。
- 标记边界情况供人工复核;混合意图按主导意图分类。
- Step 4 Hub-and-Spoke 架构:加载 references/hub-spoke-architecture.md 获取完整规范。
- 选择 pillar 关键词:搜索量最高、意图最广、与其他关键词 SERP 重叠最多。
- 将 spokes 分组为集群:每个集群是一个子主题,每个 pillar 2-5 个集群。
- 为每个集群分配文章:每个集群 2-4 篇 spoke 文章。
- 按意图选择模板:Informational broad -> ultimate-guide;Informational how -> how-to;Informational list -> listicle;Informational concept -> explainer;Commercial compare -> comparison;Commercial evaluate -> review;Commercial rank -> best-of;Transactional -> landing-page。
- 设置字数目标:pillar 页 2500-4000 词;spoke 文章 1200-1800 词。
- 关键词蚕食检查:任意两篇文章不得共享同一个 primary keyword;若 SERP 重叠 7+,将这些关键词合并为一篇文章同时 targeting。
- Step 5 内链矩阵:设计双向链接结构:spoke -> pillar 强制,每篇 spoke;pillar -> spoke 强制,每篇 spoke;同一集群 spoke <-> spoke 每篇 2-3 条;跨集群 spoke -> spoke 每篇 0-1 条。
- 内链规则:每篇文章至少 3 条入站内链;无孤儿页面,每篇从 pillar 2 次点击可达;锚文本使用目标关键词或近似变体,不要 click here;链接放在正文内容中,不只是导航/侧边栏。
- 将链接矩阵生成为 JSON adjacency list,形如 {"links":[{"from":"pillar","to":"cluster-0-post-0","type":"mandatory","anchor":"keyword"},{"from":"cluster-0-post-0","to":"pillar","type":"mandatory","anchor":"keyword"}]}。
- Step 6 交互式集群地图:使用 templates/cluster-map.html 生成 cluster-map.html。
- 读取模板文件。
- 根据集群计划构建 CLUSTER_DATA JSON 对象:pillar: { title, keyword, volume, template, wordCount, url },clusters: [{ name, color, posts: [{ title, keyword, volume, template, wordCount, url, status }] }],links: [{ from, to, type }],meta: { totalPosts, totalClusters, totalLinks, estimatedWords }。
- 用实际 JSON 替换模板中的 CLUSTER_DATA 占位符。
- 将完成后的 HTML 文件写入输出目录。
- 告知用户:Open cluster-map.html in a browser to explore the interactive cluster map。
- Strategy Import:当使用 --from strategy 时,在当前目录查找最近的 /seo plan 输出,搜索匹配 *SEO*Plan*、*strategy*、*content-strategy* 的文件。
- 解析 markdown 表格,提取 keywords、page types、content pillars、URL structures。
- 验证提取数据:检查重复、缺失关键词、不完整条目。
- 用 SERP 数据增强:对提取的关键词运行 SERP 重叠分析。
- 用导入的关键词作为起始集合构建集群计划,跳过 Step 1。
- 若找不到策略文件,提示用户:No existing SEO plan found in the current directory. Run /seo plan first, or provide a seed keyword for fresh clustering。
- Execution Workflow:当 /seo cluster execute 时,检查 claude-blog:测试 ~/.claude/skills/blog/SKILL.md 是否存在。
- 若 claude-blog 已安装:加载 references/execution-workflow.md 获取完整算法。
- 从当前目录读取 cluster-plan.json。
- 检查恢复状态:扫描输出目录中已写好的文章。
- 按优先级执行:pillar 优先,然后 spokes 按搜索量从高到低。
- 对每篇文章调用 blog-write skill,并传入集群上下文:Cluster role,pillar 或 spoke;Position in cluster,cluster index、post index;Target keyword and secondary keywords;Template type and word count target;Internal links to include,含 anchors;Links to receive from future posts,placeholder markers。
- 每篇文章写完后,扫描之前文章中的 backward link placeholders,并注入新文章的 URL。
- 所有文章写完后,生成 cluster scorecard。
- 若 claude-blog 未安装:为集群计划中每篇文章生成详细内容 brief。
- 每个 brief 包含:Title and meta description;Primary keyword and secondary keywords;Template type and suggested structure,H2/H3 outline;Word count target;Internal links to include,含 anchor text;Key points to cover;Competing pages to differentiate from。
- 将 brief 写入 cluster-briefs/ 目录,作为单独 markdown 文件。
- 告知用户:Install claude-blog(https://github.com/AgriciDaniel/claude-blog)to auto-create content. Briefs saved to cluster-briefs/。
- Cluster Scorecard:执行后质量报告;在 /seo cluster execute 后自动运行,或按需分析输出目录。
- 指标与目标:Coverage 100% = Posts written / posts planned;Link Density 3+ per post = 统计每篇内链数;Orphan Pages 0 = 入站链接 < 1 的文章;Cannibalization 0 conflicts = 检查重复 primary keywords;Image Count 1+ per post = 至少有 1 张图的文章;Pillar Links 100% = 所有 spokes 链接 pillar 且反之亦然;Cross-Links 80%+ = 建议的 spoke-to-spoke 链接已实现;Content Gaps 0 = 计划文章被跳过或不完整。
- Map Regeneration:当 /seo cluster map 时,读取当前目录的 cluster-plan.json。
- 扫描输出目录并更新文章状态:planned vs written。
- 用更新后的状态重新生成 cluster-map.html。
- 报告:已写文章 vs 计划文章、链接完成百分比。
- Output Files:所有输出写入当前工作目录:cluster-plan.json,机器可读完整集群计划;cluster-plan.md,人类可读集群计划摘要;cluster-map.html,交互式 SVG 可视化;cluster-briefs/,无 claude-blog 时的内容 brief;cluster-scorecard.md,执行后质量报告。
- Cross-Skill Integration:seo-plan = 导入源,策略导入读取 seo-plan 输出;seo-content = 质量检查,对生成内容做 E-E-A-T 验证;seo-schema = Schema 标记,为集群页面添加 Article、BreadcrumbList、ItemList;seo-dataforseo = 数据源,DataForSEO MCP 可用时提供 SERP 数据;seo-google = 报告,生成集群计划和 scorecard 的 PDF 报告。
- 在集群规划或执行完成后,询问:Generate a PDF report? Use /seo google report。
- Error Handling:若 No seed keyword provided,缺少参数 -> 提示用户提供 seed keyword 或 URL。
- 若 Insufficient keyword variants,扩展得到 < 15 个关键词 -> 用 PAA 问题再做一轮扩展。
- 若 SERP data unavailable,WebSearch 和 DataForSEO 都失败 -> 30 秒后重试;若持续失败,使用仅意图聚类并给出警告。
- 若 No strategy file found,--from strategy 但无计划存在 -> 提示用户先运行 /seo plan。
- 若 cluster-plan.json not found,未规划就执行 -> 提示用户先运行 /seo cluster plan。
- 若 claude-blog not installed,未安装 blog skill 却执行 -> 改为生成内容 brief;建议安装。
- 若 DataForSEO budget exceeded,成本检查返回 blocked -> 回退到 WebSearch;告知用户。
- 若 Duplicate primary keywords,检测到蚕食 -> 合并受影响文章或重新分配关键词。
- 若 Orphan page detected,文章缺少入站链接 -> 从最近的集群兄弟文章添加链接。
- 若 Resume state corrupted,计划与输出不匹配 -> 从输出目录扫描重建状态。
- Security:所有 URL 通过 "${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run render_page.py <url> --mode auto 获取,通过 url_safety 提供 SPA-aware SSRF 防护。
- 不存储或传输凭据。
- 输出文件不包含 PII 或 API key。
- 每次 API 调用前运行 DataForSEO 成本检查。
- FLOW Framework Integration:对 prompt-guided 关键词研究和 gap analysis,使用 /seo flow find [url|topic];FLOW 的 5 find-stage prompts 用结构化发现提示补充 SERP-overlap 聚类方法。
适用边界 · 注意事项
- 只有文本相似度需求、无法或不想获取 Google SERP 数据时不适合;该方法依赖实际 SERP 重叠,而非文本相似。
- 关键词主要是导航类,如品牌名、具体产品名、login 时不应纳入聚类,原文明确排除 Navigational。
- 没有种子关键词或 URL,且也没有可导入的 /seo plan 策略文件时,无法直接开始规划。