30x SEO Serp

SEO SERP 追踪

使用 DataForSEO API 通过直接 curl 调用追踪排名、监控 SERP 变化、分析搜索结果特性。

API 配置

凭据存储在 ~/.config/dataforseo/auth（Base64 编码）。

# 读取认证令牌
AUTH=$(cat ~/.config/dataforseo/auth)

快速参考

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 特性检测：

3. 历史 SERP 分析

追踪 SERP 随时间的变化。

输入：关键词
输出：
- 随时间的 SERP 快照
- 每个域名的位置变化
- 特性出现/消失
- 波动性评估

用例：

• 追踪算法更新影响
• 识别排名趋势
• 检测竞品动向
• 规划内容更新

4. SERP 竞争对手分析

找出谁在竞争关键词。

输入：关键词
输出：
- 所有排名域名
- 每个域名的平均位置
- 流量份额估算
- 内容类型分析

5. 关键词位置检查

检查你的域名的特定关键词位置。

输入：域名，关键词[]
输出：
- 每个关键词的当前位置
- 每个排名的 URL
- 捕获的 SERP 特性
- 与上次检查的位置变化

排名指标

位置层级

流量估算

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 当：

• 分析竞争对手
• 实时 SERP 检查
• SERP 特性分析
• 无 GSC 访问权限

使用 GSC 当：

• 需要实际点击/展示数据
• CTR 优化
• 你自己的已验证资产

与其他技能集成

• 使用 seo-keywords 找要追踪的关键词
• 使用 seo-content 优化表现不佳的页面
• 使用 seo-backlinks 理解排名因素

最佳实践

追踪设置

1. 核心关键词 - 20-50 个最重要的词
2. 品牌关键词 - 品牌名变体
3. 竞品关键词 - 竞争对手排名的词
4. 机会关键词 - 攻击距离词

监控频率

行动触发

[PROTOCOL]: 变更时更新此头部，然后检查 CLAUDE.md