30x Seo Serp

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 | 5 | 调查内容/链接 | | 新竞品进入前 5 | 分析其内容 | | 丢失 SERP 特性 | 重新优化特性 | | 位置 11-15 | 推进到第 1 页 |

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

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: norahe0304-art
• Source: norahe0304-art/30x-seo-cn
• License: MIT

Install and usage instructions live in the source repository linked above.