geo-blog-topic-generator

name	geo-blog-topic-generator
description	将引流关键词转化为 GEO 优化的博客文章潜在主题。通过关键词清洗过滤和全网用户需求理解，产出潜在主题列表供下游文章生成参考。内置电商引流可行性判断和黑名单过滤，非电商相关关键词返回可被下游识别的拒绝信号。适用于电商 SEO 内容规划、博客选题、关键词到主题转化场景。当用户提供关键词并要求生成博客主题、文章选题、GEO 内容规划时使用此技能。

GEO Blog Topic Generator

将引流关键词转化为潜在博客文章主题列表。专为电商网站 SEO 设计，内置关键词清洗过滤和电商引流可行性判断。

核心定位：本步骤做的是词清洗过滤 + 描述用户需求 + 产出潜在主题。PAA 问题仅作为附加信息供人参考。文章标题和正文由下游 geo-content-generator 生成。

上游入参格式

本技能接收上游任务产出的关键词，入参格式如下：

{
  "keyword": "用户搜索的原始关键词",
  "source": "关键词来源标识，如 keyword_research / competitor_analysis / user_query",
  "target_country": "目标市场国家代码，如 US / DE / FR",
  "target_language": "目标语言，如 en / de / fr",
  "niche": "可选，电商站品类/行业标识，如 car_audio / electronics"
}

必填字段：keyword 可选字段：source、target_country、target_language、niche

如果上游仅传入纯字符串（无 JSON 结构），则视为 keyword 字段，其余字段省略。

工作流程

Step 0: 关键词清洗（黑名单过滤 + 电商可行性判断）

收到关键词后，依次执行以下两步过滤：

Step 0a: 黑名单过滤

以下模式的关键词直接标记为 blacklisted，跳过后续所有步骤：

黑名单类型	匹配模式	原因	示例
本地服务	near me, nearby, around me, dans ma ville, cerca de mí, vicino a me	纯本地服务意图，无电商引流价值	"plumber near me"
纯交易意图	for sale, buy now, cheap, discount, coupon, promo code, en venta, à vendre	搜索结果只有产品页，无博客内容空间	"iphone 15 for sale"
导航型搜索	login, sign in, official site, official website, app download	用户只想找某个网站/应用	"facebook login"
品牌+客服	customer service, contact, phone number, support, return policy	售后客服意图，非内容引流	"nike customer service"
单位换算	to inch, to cm, to kg, to lbs, converter, calculation	工具型查询，无文章内容空间	"17cm to inch"
日期/倒计时	when is, how many days until, what date, qué día, quando é	一次性信息查询	"when is christmas"
成人内容	nude, xxx, porn, sex	不适合电商博客	-

判定结果：

• 命中黑名单 → ecommerce_suitable = false, ecommerce_reason = "Blacklisted: {类型}", topics = []
• 未命中 → 继续 Step 0b

Step 0b: 电商引流可行性判断

判断维度：

维度	适合电商引流	不适合电商引流
是否指向具体商品/产品	是	否（如电影、新闻、人物、纯概念）
是否有购买意图	有（含 review / best / price / vs 等信号）	无（纯信息型如剧情解析、历史背景）
是否存在电商生态内容	Amazon / 独立站 / 比价平台有该产品页面	仅 IMDb / Wikipedia / 新闻站有内容
是否有可关联的产品品类	可归入明确品类（如车载转换器、耳机）	无可销售品类（如抽象话题、学术概念）

判定结果：

• ecommerce_suitable = true → 继续执行后续步骤
• ecommerce_suitable = false → 跳过主题生成，直接输出拒绝结果

不适合电商引流的典型关键词类型：

• 电影/电视剧/音乐作品（如 "le 8ème jour film"）
• 新闻事件/热点话题
• 人物/名人名言
• 学术研究/论文主题
• 抽象概念/哲学话题
• 政策法规/法律条文

Step 1: 关键词理解与全网用户需求收集

对通过筛选的关键词，通过 WebSearch 在全网范围内了解该关键词和用户真实需求：

1. 产品/概念定位：搜索 "{关键词}" 确认指向的具体产品/服务/概念，是否存在歧义，目标受众是谁
2. 全网用户需求收集：在全网范围内搜索，收集用户对该关键词的真实需求和关注点。搜索范围不限于特定渠道，包括但不限于：
   • 社交媒体讨论（Reddit、Twitter/X、Facebook 群组等）
   • 电商评论（Amazon、AliExpress、独立站等）
   • 论坛和社区讨论
   • 博客和评测文章
   • 问答平台（Quora、知乎等）
   • 视频平台评论（YouTube、TikTok 等）
   • 新闻和行业资讯
3. 搜索意图分析：综合搜索结果判断：
   • 用户搜索这个关键词的目的是什么？（了解产品？对比选择？解决问题？）
   • 用户在决策链路中的哪个阶段？（认知 → 考虑 → 决策）
   • 有哪些潜在需求是当前关键词没有明确表达但相关的？

核心原则：不限制搜索渠道和问题模板，全网搜索了解用户真实需求。重点是准确理解关键词含义，充分收集用户潜在需求。

Step 2: 潜在主题产出

基于 Step 1 收集的用户需求，产出潜在主题列表：

1. 用户意图描述：用一段自然语言描述用户搜索该关键词时的真实意图和潜在需求，不要简单做分类标签。例如："用户想了解这款产品的实际使用体验，关注质量是否可靠、是否有常见缺陷、其他买家评价如何"，而非简单标注 "informational"。

2. 主题转化：将用户需求转化为文章主题方向，每个主题包含：

   • 主题描述（中文，描述文章核心内容方向）
   • 推荐排序值（整数，1 为最推荐，由你主观判断哪个主题最值得写、最可能获得点击）

3. PAA 问题收集（可选，附加信息）：

   • 如果搜索到了 Google PAA 框中的真实用户提问，收集到一个列表中
   • 如果没有搜到，返回空数组 []
   • PAA 问题不和主题绑定 1:1 关系，仅作为给人和下游文章生成参考的附加信息

4. 去重规则：

   • 如果两个主题指向同一篇文章即可覆盖的内容，合并为一个主题
   • 确保每个主题的内容边界清晰、不重叠

Step 3: 输出 JSON

按指定格式输出最终结果。

输出格式

电商适用场景（ecommerce_suitable = true）

{
  "ecommerce_suitable": true,
  "ecommerce_reason": "该关键词指向具体商品，存在购买意图和电商生态内容",
  "keyword": "原始关键词",
  "user_intent": "用自然语言描述用户搜索该关键词的真实意图和潜在需求，例如：用户想了解这款产品的实际使用体验，关注质量是否可靠、是否有常见缺陷、其他买家评价如何，同时也在对比同类产品犹豫是否值得购买",
  "suggested_topics": [
    {
      "topic": "中文主题描述，说明文章要写什么内容",
      "sort_value": 1
    },
    {
      "topic": "第二个潜在主题",
      "sort_value": 2
    }
  ],
  "paa_questions": [
    "搜索到的真实 PAA 问题 1",
    "搜索到的真实 PAA 问题 2"
  ]
}

字段设计说明（供下游消费参考）：

• keyword：原始关键词，下游文章生成直接使用的核心词
• user_intent：自然语言描述的用户意图，下游可直接引用到文章开头或作为写作方向的指导，无需自行推断
• suggested_topics：潜在主题列表 + 推荐排序值，下游按 sort_value 从小到大决定文章写作优先级
• paa_questions：扁平数组，不和主题绑定，下游可灵活选取作为文章 FAQ 或 H2/H3 小节

电商不适用场景（ecommerce_suitable = false）

{
  "ecommerce_suitable": false,
  "ecommerce_reason": "Blacklisted: 本地服务 / 该关键词指向电影作品，无可销售商品 / 纯交易意图无博客内容空间",
  "topics": []
}

下游识别规则：

• 下游任务检查 ecommerce_suitable 字段
• true → 正常处理 suggested_topics 和 paa_questions，作为文章生成的参考
• false → 跳过该关键词，记录 ecommerce_reason 作为日志，不进入后续文章生成流程
• suggested_topics 为空数组时视为无可用主题

字段说明：

• ecommerce_suitable：布尔值，是否适合电商网站引流，下游核心判断字段
• ecommerce_reason：字符串，判定原因（含黑名单类型），供人工复核和日志记录
• keyword：用户输入的原始关键词，下游文章生成的核心词
• user_intent：字符串，自然语言描述的用户真实意图和潜在需求，下游可直接引用为写作指导
• suggested_topics：数组，潜在文章主题列表，每个元素包含 topic（中文描述）和 sort_value（推荐排序，1 为最推荐），下游按 sort_value 决定写作优先级
• paa_questions：数组，搜索到的真实 PAA 问题列表；未搜到时为空数组 []。扁平结构，不和主题绑定，下游可灵活选取作为文章 FAQ 或 H2/H3 小节

注意：文章标题和正文由下游 geo-content-generator 在生成文章时创建，本步骤不生成标题。

使用方式

上游传入关键词后，执行以下步骤：

1. 解析入参（JSON 或纯字符串）
2. Step 0a：黑名单过滤（本地服务、纯交易、导航型、客服、换算、日期、成人内容）
3. Step 0b：电商引流可行性判断（含 WebSearch 验证电商生态）
4. 如不通过任一过滤，输出 ecommerce_suitable: false 结果并终止
5. 如通过，执行 Step 1：WebSearch 全面理解关键词，收集用户需求
6. 执行 Step 2：将用户需求转化为潜在主题列表，去重并赋推荐排序值
7. 执行 Step 3：输出 JSON，包含 keyword、user_intent、suggested_topics、paa_questions