| name | 30x-seo-serp |
| description | 使用 DataForSEO 追踪 SERP 排名、监控位置变化、分析 SERP 特性、 识别排名机会。作为 Google Search Console 排名数据的替代选择。 当用户说"排名"、"SERP追踪"、"位置监控"、"排名追踪"、 "关键词位置"或"SERP分析"时使用。
|
| allowed-tools | ["Bash","Read"] |
SEO SERP 追踪
使用 DataForSEO API 通过直接 curl 调用追踪排名、监控 SERP 变化、分析搜索结果特性。
API 配置
凭据存储在 ~/.config/dataforseo/auth(Base64 编码)。
AUTH=$(cat ~/.config/dataforseo/auth)
快速参考
| 命令 | 功能 |
|---|
/seo serp rank <域名> | 获取域名排名的所有关键词 |
/seo serp check <关键词> | 关键词实时 SERP 检查 |
/seo serp history <关键词> | 历史 SERP 变化 |
/seo serp features <关键词> | 分析存在的 SERP 特性 |
/seo serp competitors <关键词> | 谁在排名这个关键词 |
/seo serp overview <域名> | 域名排名概述 |
API 端点
实时 SERP 检查
curl -s -X POST "https://api.dataforseo.com/v3/serp/google/organic/live/advanced" \
-H "Authorization: Basic $(cat ~/.config/dataforseo/auth)" \
-H "Content-Type: application/json" \
-d '[{"keyword": "目标关键词", "location_name": "China", "language_code": "zh", "depth": 100}]'
域名排名概述
curl -s -X POST "https://api.dataforseo.com/v3/dataforseo_labs/google/domain_rank_overview/live" \
-H "Authorization: Basic $(cat ~/.config/dataforseo/auth)" \
-H "Content-Type: application/json" \
-d '[{"target": "example.com", "location_name": "China", "language_code": "zh"}]'
排名关键词(网站排名)
curl -s -X POST "https://api.dataforseo.com/v3/dataforseo_labs/google/ranked_keywords/live" \
-H "Authorization: Basic $(cat ~/.config/dataforseo/auth)" \
-H "Content-Type: application/json" \
-d '[{"target": "example.com", "location_name": "China", "language_code": "zh", "limit": 100}]'
历史 SERP
curl -s -X POST "https://api.dataforseo.com/v3/dataforseo_labs/google/historical_serps/live" \
-H "Authorization: Basic $(cat ~/.config/dataforseo/auth)" \
-H "Content-Type: application/json" \
-d '[{"keyword": "目标关键词", "location_name": "China", "language_code": "zh"}]'
SERP 竞争对手
curl -s -X POST "https://api.dataforseo.com/v3/dataforseo_labs/google/serp_competitors/live" \
-H "Authorization: Basic $(cat ~/.config/dataforseo/auth)" \
-H "Content-Type: application/json" \
-d '[{"keywords": ["关键词1", "关键词2", "关键词3"], "location_name": "China", "language_code": "zh"}]'
关键词概述
curl -s -X POST "https://api.dataforseo.com/v3/dataforseo_labs/google/keyword_overview/live" \
-H "Authorization: Basic $(cat ~/.config/dataforseo/auth)" \
-H "Content-Type: application/json" \
-d '[{"keywords": ["关键词1", "关键词2"], "location_name": "China", "language_code": "zh"}]'
分析模式
1. 域名排名概述
获取域名的完整排名概况。
输入:域名(如 "example.com")
输出:
- 排名关键词总数
- 位置分布(1-3, 4-10, 11-20, 21-100)
- 预估自然流量
- 排名最高的关键词
- SERP 特性出现情况
位置分布图:
位置 1-3: ############ 45 个关键词
位置 4-10: #################### 89 个关键词
位置 11-20: ########## 42 个关键词
位置 21-50: ######## 35 个关键词
位置 51+: #### 18 个关键词
2. 实时 SERP 检查
获取任意关键词的当前 SERP。
输入:关键词,位置(可选)
输出:
- 前 10/20/100 结果
- 存在的 SERP 特性
- 自然结果上下方的广告
- 相关搜索
- 相关问题
SERP 特性检测:
| 特性 | SEO 影响 |
|---|
| AI 概览 | 降低自然 CTR |
| 精选摘要 | 高可见性机会 |
| 相关问题 | 内容扩展信号 |
| 本地结果 | 需要本地 SEO |
| 图片包 | 图片优化机会 |
| 视频轮播 | 视频内容机会 |
| 知识面板 | 品牌权威信号 |
3. 历史 SERP 分析
追踪 SERP 随时间的变化。
输入:关键词
输出:
- 随时间的 SERP 快照
- 每个域名的位置变化
- 特性出现/消失
- 波动性评估
用例:
- 追踪算法更新影响
- 识别排名趋势
- 检测竞品动向
- 规划内容更新
4. SERP 竞争对手分析
找出谁在竞争关键词。
输入:关键词
输出:
- 所有排名域名
- 每个域名的平均位置
- 流量份额估算
- 内容类型分析
5. 关键词位置检查
检查你的域名的特定关键词位置。
输入:域名,关键词[]
输出:
- 每个关键词的当前位置
- 每个排名的 URL
- 捕获的 SERP 特性
- 与上次检查的位置变化
排名指标
位置层级
| 层级 | 位置 | 预估 CTR | 优先级 |
|---|
| 优质 | 1-3 | 15-30% | 防守 |
| 强势 | 4-10 | 2-8% | 优化 |
| 攻击距离 | 11-20 | 1-2% | 推进 |
| 机会 | 21-50 | <1% | 内容差距 |
| 长尾 | 51+ | 极低 | 低优先级 |
流量估算
DataForSEO 基于以下因素提供流量估算:
- 搜索量
- 位置
- CTR 模型
- 存在的 SERP 特性
注意: 这些是估算,不是实际流量数据。
输出格式
排名报告
# SERP 排名:[域名]
生成时间:[日期]
## 概述
- 关键词总数:X
- 预估月流量:X
- 平均位置:X
- 前 10 关键词数:X
## 位置分布
| 位置 | 关键词数 | 占比 |
|------|----------|------|
| 1-3 | X | X% |
| 4-10 | X | X% |
| 11-20 | X | X% |
| 21-50 | X | X% |
| 51+ | X | X% |
## 热门关键词
| 关键词 | 位置 | 搜索量 | URL |
|--------|------|--------|-----|
| [关键词1] | 3 | 5,400 | /page1 |
| [关键词2] | 7 | 3,200 | /page2 |
## 捕获的 SERP 特性
| 特性 | 数量 | 关键词 |
|------|------|--------|
| 精选摘要 | 5 | 关键词1, 关键词2, ... |
| 相关问题 | 12 | ... |
## 机会
### 攻击距离(位置 11-20)
接近第 1 页的关键词 - 优先优化:
1. [关键词] - 位置 12,搜索量 2,400
2. [关键词] - 位置 15,搜索量 1,800
SERP 分析报告
# SERP 分析:"[关键词]"
位置:[位置]
生成时间:[日期]
## SERP 组成
### 首屏以上
- 广告:4
- AI 概览:是
- 精选摘要:是 (domain.com)
### 自然结果
1. domain1.com/page - 标题
2. domain2.com/page - 标题
...
### 存在的 SERP 特性
- [x] AI 概览
- [x] 精选摘要
- [x] 相关问题(4 个问题)
- [ ] 本地结果
- [x] 图片包
- [ ] 视频轮播
## 建议
1. 要创建的内容类型:[基于排名前列结果]
2. 目标字数:[基于分析]
3. 要瞄准的 SERP 特性:[基于差距]
对比:DataForSEO vs GSC
| 功能 | DataForSEO(此技能) | GSC |
|---|
| 排名数据 | 是(估算) | 是(实际) |
| 点击数据 | 否 | 是 |
| 展示数据 | 否 | 是 |
| CTR 数据 | 否 | 是 |
| 任意域名 | 是 | 仅已验证 |
| 历史深度 | 数月 | 16 个月 |
| 实时 SERP | 是 | 否 |
| SERP 特性 | 详细 | 有限 |
使用 DataForSEO 当:
- 分析竞争对手
- 实时 SERP 检查
- SERP 特性分析
- 无 GSC 访问权限
使用 GSC 当:
- 需要实际点击/展示数据
- CTR 优化
- 你自己的已验证资产
与其他技能集成
- 使用
seo-keywords 找要追踪的关键词
- 使用
seo-content 优化表现不佳的页面
- 使用
seo-backlinks 理解排名因素
最佳实践
追踪设置
- 核心关键词 - 20-50 个最重要的词
- 品牌关键词 - 品牌名变体
- 竞品关键词 - 竞争对手排名的词
- 机会关键词 - 攻击距离词
监控频率
| 关键词类型 | 检查频率 |
|---|
| 核心(前 20) | 每周 |
| 次要(21-50) | 两周一次 |
| 长尾(51+) | 每月 |
| 竞品追踪 | 每周 |
行动触发
| 信号 | 行动 |
|---|
| 位置下降 >5 | 调查内容/链接 |
| 新竞品进入前 5 | 分析其内容 |
| 丢失 SERP 特性 | 重新优化特性 |
| 位置 11-15 | 推进到第 1 页 |
[PROTOCOL]: 变更时更新此头部,然后检查 CLAUDE.md