# 30x Seo Serp

> >

- **Type:** Skill
- **Install:** `agentstack add skill-norahe0304-art-30x-seo-cn-30x-seo-serp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [norahe0304-art](https://agentstack.voostack.com/s/norahe0304-art)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [norahe0304-art](https://github.com/norahe0304-art)
- **Source:** https://github.com/norahe0304-art/30x-seo-cn/tree/main/skills/30x-seo-serp

## Install

```sh
agentstack add skill-norahe0304-art-30x-seo-cn-30x-seo-serp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# SEO SERP 追踪

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

## API 配置

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

```bash
# 读取认证令牌
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 检查
```bash
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}]'
```

### 域名排名概述
```bash
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"}]'
```

### 排名关键词（网站排名）
```bash
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
```bash
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 竞争对手
```bash
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"}]'
```

### 关键词概述
```bash
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](https://github.com/norahe0304-art)
- **Source:** [norahe0304-art/30x-seo-cn](https://github.com/norahe0304-art/30x-seo-cn)
- **License:** MIT

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

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-norahe0304-art-30x-seo-cn-30x-seo-serp
- Seller: https://agentstack.voostack.com/s/norahe0304-art
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.