30x-seo-keywords

SEO 关键词分析

通过直接调用 curl，使用 DataForSEO API 进行全面的关键词研究与分析。

API 配置

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

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

快速参考

命令	功能
/seo keywords research <seed>	根据种子关键词生成关键词建议
/seo keywords volume <keyword1, keyword2, ...>	获取关键词的搜索量
/seo keywords difficulty <keyword1, keyword2, ...>	分析关键词难度分数
/seo keywords site <domain>	查找网站排名对应的关键词
/seo keywords gap <your-domain> <competitor>	查找关键词机会
/seo keywords intent <keyword1, keyword2, ...>	分析搜索意图
/seo keywords trending	查找热门搜索查询
/seo keywords history <keyword>	获取历史搜索量数据

API 端点

关键词建议

curl -s -X POST "https://api.dataforseo.com/v3/dataforseo_labs/google/keyword_ideas/live" \
  -H "Authorization: Basic $(cat ~/.config/dataforseo/auth)" \
  -H "Content-Type: application/json" \
  -d '[{"keywords": ["SEED_KEYWORD"], "location_name": "United States", "language_code": "en", "limit": 50}]'

关键词推荐（自动补全）

curl -s -X POST "https://api.dataforseo.com/v3/dataforseo_labs/google/keyword_suggestions/live" \
  -H "Authorization: Basic $(cat ~/.config/dataforseo/auth)" \
  -H "Content-Type: application/json" \
  -d '[{"keyword": "SEED_KEYWORD", "location_name": "United States", "language_code": "en", "limit": 50}]'

相关关键词

curl -s -X POST "https://api.dataforseo.com/v3/dataforseo_labs/google/related_keywords/live" \
  -H "Authorization: Basic $(cat ~/.config/dataforseo/auth)" \
  -H "Content-Type: application/json" \
  -d '[{"keyword": "SEED_KEYWORD", "location_name": "United States", "language_code": "en", "limit": 50}]'

批量关键词难度

curl -s -X POST "https://api.dataforseo.com/v3/dataforseo_labs/bulk_keyword_difficulty/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"}]'

搜索量（Google Ads 数据）

curl -s -X POST "https://api.dataforseo.com/v3/keywords_data/google_ads/search_volume/live" \
  -H "Authorization: Basic $(cat ~/.config/dataforseo/auth)" \
  -H "Content-Type: application/json" \
  -d '[{"keywords": ["kw1", "kw2"], "location_code": 2840, "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}]'

搜索意图

curl -s -X POST "https://api.dataforseo.com/v3/dataforseo_labs/google/search_intent/live" \
  -H "Authorization: Basic $(cat ~/.config/dataforseo/auth)" \
  -H "Content-Type: application/json" \
  -d '[{"keywords": ["kw1", "kw2"], "language_code": "en"}]'

历史关键词数据

curl -s -X POST "https://api.dataforseo.com/v3/dataforseo_labs/google/historical_search_volume/live" \
  -H "Authorization: Basic $(cat ~/.config/dataforseo/auth)" \
  -H "Content-Type: application/json" \
  -d '[{"keywords": ["KEYWORD"], "location_name": "United States", "language_code": "en"}]'

分析模式

1. 关键词研究（生成建议）

根据种子关键词生成关键词建议：

Input: seed keyword (e.g., "coffee maker")
Output:
- Related keyword ideas
- Search volume per keyword
- CPC and competition data
- Keyword difficulty score
- Search intent classification

2. 搜索量分析

获取准确的搜索量数据：

Input: list of keywords
Output:
- Monthly search volume
- Search volume trend (12 months)
- CPC estimate
- Competition level (0-1)
- Seasonal patterns

3. 关键词难度评估

分析排名难度：

Input: list of keywords
Output:
- Difficulty score (0-100)
- SERP feature presence
- Top 10 competitor strength
- Estimated effort to rank

难度解读：

• 0-20：容易（新网站也能获得排名）
• 20-40：中等（需要一定的权威度）
• 40-60：困难（只有成熟网站才能获得排名）
• 60-80：非常困难（需要很高的权威度）
• 80-100：极其困难（只有占据主导地位的网站才能获得排名）

4. 网站关键词分析

查找某个域名排名对应的关键词：

Input: domain (e.g., "example.com")
Output:
- All ranking keywords
- Position for each keyword
- Search volume
- Traffic estimate
- Featured snippet presence

5. 搜索意图分析

对关键词意图进行分类：

Input: list of keywords
Output:
- Intent type per keyword:
  - Informational (how, what, why)
  - Navigational (brand searches)
  - Commercial (best, review, compare)
  - Transactional (buy, price, discount)
- Content format recommendations

内容映射：

意图	内容类型
信息型	博客文章、指南、教程
导航型	着陆页、关于页面
商业型	对比页面、评论
交易型	产品页面、定价页面

关键词优先级框架

优先级矩阵

根据以下因素为每个关键词打分：

因素	权重	评分
搜索量	25%	高（3）、中（2）、低（1）
难度	30%	容易（3）、中等（2）、困难（1）
业务相关性	25%	高（3）、中（2）、低（1）
意图匹配度	20%	完美（3）、良好（2）、部分（1）

快速见效机会识别

快速见效机会具备以下特点：

• 每月搜索量 > 100
• 难度 < 40
• 商业型或交易型意图
• 与业务直接相关

输出格式

关键词研究报告

# Keyword Research: [seed keyword]

## Overview
- Total keywords found: X
- Average monthly volume: X
- Average difficulty: X

## Top Opportunities (Priority Sorted)

| Keyword | Volume | Difficulty | Intent | Priority |
|---------|--------|------------|--------|----------|
| [kw1] | X | X | Info | High |
| [kw2] | X | X | Trans | High |

## Keyword Clusters

### Cluster 1: [Topic]
- keyword a (vol: X, diff: X)
- keyword b (vol: X, diff: X)

## Content Recommendations

### Immediate Actions (Quick Wins)
1. [Keyword] -> Create [content type]
2. [Keyword] -> Create [content type]

与其他 SEO 技能集成

• 使用 seo-content 为目标关键词创建内容
• 使用 seo-backlinks 为竞争激烈的关键词建立权威度
• 使用 seo-serp 跟踪排名进展

[PROTOCOL]: 如有更改，请更新此标头，然后检查 CLAUDE.md