seo-keyword-ranking

关键词 & 排名追踪模块

核心功能

追踪品牌和竞品在 Google 与 Bing 上的关键词排名，发现排名波动，及时报警。

关键词分组管理

关键词按 4 个类别管理，每个类别的监测逻辑和报警阈值不同：

类别 A：品牌词

自己的公司名、产品名及变体。这些词你理应排第一，掉了就是出问题了。

示例： "Genspark"、"Genspark AI"、"Genspark agent" 报警阈值： 排名掉出前 3 位 监测频率： 每周 数据源： SEMrush Position Tracking API

类别 B：核心业务词

描述你的产品类别和核心功能的词。竞争最激烈的主战场。

示例： "best AI agent"、"AI productivity tool"、"AI email assistant" 报警阈值： 排名下降 5 位以上 监测频率： 每周 数据源： SEMrush Position Tracking API + Google Search Console（真实曝光/点击数据交叉验证）

类别 C：长尾问题词

用户实际搜索的对话式长问题，对 AEO 特别重要。

示例： "what AI tool can automatically reply to customer emails"、"how to use AI agent for small business" 报警阈值： 排名掉出首页（第 10 位以外） 监测频率： 每周 数据源： SEMrush + Google Search Console 来源补充： 可从 aeo-content-strategy skill 的长尾问题挖掘结果导入

类别 D：竞品对比词

包含竞品名称的对比搜索，用户正在做购买决策时常搜的。

示例： "Genspark vs Manus"、"Genspark vs ChatGPT for business"、"Manus alternative" 报警阈值： 排名下降 5 位以上 监测频率： 每周 数据源： SEMrush Position Tracking API

执行流程

1. 关键词列表初始化

首次运行时，如果用户没有现成的关键词列表：

自动发现流程：

1. 调用 SEMrush Domain Organic Research API（/analytics/v1/domain/organic），输入品牌域名，获取当前已有排名的所有关键词
2. 同样调用竞品域名，获取竞品的关键词
3. 调用 SEMrush Keyword Gap API（/analytics/v1/domain/keywords/gap），找出"竞品有排名但品牌没有"的词
4. 从 Google Search Console API 拉取过去 90 天的搜索查询数据，补充 SEMrush 没发现的长尾词
5. 将所有关键词自动归类到 A/B/C/D 四组

归类规则：

• 包含品牌名 → 类别 A
• 词长 ≤ 5 词且为名词短语 → 类别 B
• 词长 > 5 词或问句形式 → 类别 C
• 包含竞品名或 "vs" / "alternative" / "compare" → 类别 D

归类后展示给用户确认和调整，用户可以随时添加、删除或重新分类关键词。

2. 排名数据拉取

Google 排名（主要）：

• SEMrush Position Tracking API：设置项目，追踪所有关键词在 Google 上的每日排名
• Google Search Console API（/searchanalytics/query）：获取真实曝光、点击、平均排名、CTR

Bing 排名：

• SEMrush Position Tracking API 支持 Bing 追踪：在项目设置中添加 Bing 作为搜索引擎
• 特别标注 Bing 排名对 AEO 的意义——ChatGPT Search 使用 Bing 索引，Bing 排名直接影响 AI 搜索可见性

3. 竞品排名对比

对每个关键词，同时拉取：

• 品牌排名位置
• 竞品 1 排名位置
• 竞品 2 排名位置（如有）

生成对比视图：

关键词: "best AI agent"
         Google    Bing
我们:     #7       #12
竞品A:    #3       #5
竞品B:    #15      #8
趋势:     ↓2       ↑3（vs 上周）