30x-seo-serp

SEO SERP 跟踪

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

API 配置

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

# Read auth token
AUTH=$(cat ~/.config/dataforseo/auth)

快速参考

命令	功能
/seo serp rank <domain>	获取域名的所有关键词排名
/seo serp check <keyword>	实时检查关键词的 SERP
/seo serp history <keyword>	查看 SERP 历史变化
/seo serp features <keyword>	分析当前存在的 SERP 特征
/seo serp competitors <keyword>	查看该关键词的排名网站
/seo serp overview <domain>	查看域名排名概览

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": "TARGET_KEYWORD", "location_name": "United States", "language_code": "en", "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": "United States", "language_code": "en"}]'

排名关键词（网站排名）

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": "United States", "language_code": "en", "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": "TARGET_KEYWORD", "location_name": "United States", "language_code": "en"}]'

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": ["kw1", "kw2", "kw3"], "location_name": "United States", "language_code": "en"}]'

关键词概览

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": ["kw1", "kw2"], "location_name": "United States", "language_code": "en"}]'

分析模式

1. 域名排名概览

获取域名的完整排名概况。

Input: domain (e.g., "example.com")
Output:
- Total ranking keywords
- Position distribution (1-3, 4-10, 11-20, 21-100)
- Estimated organic traffic
- Top ranking keywords
- SERP feature presence

排名位置分布图：

Position 1-3:   ############ 45 keywords
Position 4-10:  #################### 89 keywords
Position 11-20: ########## 42 keywords
Position 21-50: ######## 35 keywords
Position 51+:   #### 18 keywords

2. 实时 SERP 检查

获取任意关键词当前的 SERP。

Input: keyword, location (optional)
Output:
- Top 10/20/100 results
- SERP features present
- Ads above/below organic
- Related searches
- People Also Ask

SERP 特征检测：

特征	SEO 影响
AI Overview	降低自然搜索点击率
精选摘要	高曝光机会
其他用户还问了	内容扩展信号
本地商家信息	需要进行本地 SEO
图片组	图片优化机会
视频轮播	视频内容机会
知识面板	品牌权威度信号

3. SERP 历史分析

跟踪 SERP 随时间的变化。

Input: keyword
Output:
- SERP snapshots over time
- Position changes per domain
- Feature appearance/disappearance
- Volatility assessment

适用场景：

• 跟踪算法更新的影响
• 识别排名趋势
• 检测竞争对手的动态
• 规划内容更新

4. SERP 竞争对手分析

找出哪些网站在争夺相关关键词。

Input: keyword(s)
Output:
- All ranking domains
- Average position per domain
- Traffic share estimates
- Content type analysis

5. 关键词排名检查

检查你的域名在特定关键词下的排名。

Input: domain, keywords[]
Output:
- Current position per keyword
- URL ranking for each
- SERP features captured
- Position change from last check

排名指标

排名区间

级别	排名位置	预估点击率	优先级
顶级	1-3	15-30%	保持
强势	4-10	2-8%	优化
临界	11-20	1-2%	推进
机会	21-50	<1%	内容差距
长尾	51+	极低	低优先级

流量估算

DataForSEO 根据以下因素提供预估流量：

• 搜索量
• 排名位置
• 点击率模型
• 当前存在的 SERP 特征

**注意：**这些是估算值，并非实际流量数据。

输出格式

排名报告

# SERP Rankings: [domain]
Generated: [Date]

## Overview
- Total Keywords: X
- Estimated Monthly Traffic: X
- Average Position: X
- Keywords in Top 10: X

## Position Distribution

| Position | Keywords | % of Total |
|----------|----------|------------|
| 1-3 | X | X% |
| 4-10 | X | X% |
| 11-20 | X | X% |
| 21-50 | X | X% |
| 51+ | X | X% |

## Top Keywords

| Keyword | Position | Volume | URL |
|---------|----------|--------|-----|
| [kw1] | 3 | 5,400 | /page1 |
| [kw2] | 7 | 3,200 | /page2 |

## SERP Features Captured

| Feature | Count | Keywords |
|---------|-------|----------|
| Featured Snippet | 5 | kw1, kw2, ... |
| People Also Ask | 12 | ... |

## Opportunities

### Striking Distance (Position 11-20)
Keywords close to page 1 - prioritize optimization:
1. [keyword] - Position 12, Volume 2,400
2. [keyword] - Position 15, Volume 1,800

SERP 分析报告

# SERP Analysis: "[keyword]"
Location: [location]
Generated: [Date]

## SERP Composition

### Above the Fold
- Ads: 4
- AI Overview: Yes
- Featured Snippet: Yes (domain.com)

### Organic Results
1. domain1.com/page - Title
2. domain2.com/page - Title
...

### SERP Features Present
- [x] AI Overview
- [x] Featured Snippet
- [x] People Also Ask (4 questions)
- [ ] Local Pack
- [x] Image Pack
- [ ] Video Carousel

## Recommendations
1. Content type to create: [based on top results]
2. Target word count: [based on analysis]
3. SERP feature to target: [based on gaps]

对比：DataForSEO 与 GSC

功能	DataForSEO（此技能）	GSC
排名数据	有（估算）	有（实际）
点击数据	无	有
展示数据	无	有
点击率数据	无	有
任意域名	有	仅限已验证域名
历史数据深度	数月	16 个月
实时 SERP	有	无
SERP 特征	详细	有限

使用 DataForSEO 的场景：

• 分析竞争对手
• 实时检查 SERP
• 分析 SERP 特征
• 无法访问 GSC

使用 GSC 的场景：

• 需要实际点击量和展示量数据
• 优化点击率
• 管理自己已验证的网站资源

与其他技能集成

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

最佳实践

跟踪设置

1. 核心关键词 - 20-50 个最重要的词
2. 品牌关键词 - 品牌名称的各种形式
3. 竞争对手关键词 - 竞争对手排名的关键词
4. 机会关键词 - 接近首页的关键词

监控频率

关键词类型	检查频率
核心（前 20 名）	每周
次要（21-50 名）	每两周
长尾（51 名以上）	每月
竞争对手跟踪	每周

操作触发条件

信号	操作
排名下降 >5	调查内容/链接
新竞争对手进入前 5 名	分析其内容
SERP 功能丢失	针对该功能重新优化
排名第 11-15 位	推进至第 1 页

[PROTOCOL]：更改时更新此标题，然后检查 CLAUDE.md