mcpField
D
dataforseo

dataforseo

github.com/nikhilbhansali营销与增长66175 次安装39 周前更新
代码仓库

关于 dataforseo

dataforseo 是用于调用 DataForSEO API 的营销数据技能，面向 SEO 数据检索与分析工作。它涵盖关键词、搜索结果、反向链接、网站审计等 API，并提供结果提取和 CSV 导出流程。

主要功能

  1. 01检索关键词搜索量与建议
  2. 02获取搜索结果和排名数据
  3. 03分析反向链接与竞争域名
  4. 04执行页面审计与技术栈查询
  5. 05提取结果并导出 CSV

适用场景

  1. 01研究关键词搜索量和竞争度
  2. 02检查网站的排名关键词
  3. 03分析竞争对手和链接差距
  4. 04将 SEO 数据保存为 CSV

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/nikhilbhansali/dataforseo-skill-claude --skill dataforseo

安装后在 Claude Code 中输入/dataforseo确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
api_reference.md
use_cases.md
scripts/
dataforseo_client.py

详细介绍

DataForSEO API 技能

用于访问所有 DataForSEO API 的通用接口，可全面检索和分析 SEO 数据。

凭据设置

首次使用前，请设置凭据：

import sys, os
sys.path.insert(0, os.path.expanduser('~/.agents/skills/dataforseo/scripts'))
from dataforseo_client import save_credentials, verify_credentials

# Get credentials from https://app.dataforseo.com/
login = "[email protected]"  # API login (email)
password = "your_api_password"    # API password (from dashboard)

# Verify and save
if verify_credentials(login, password):
    save_credentials(login, password)
    print("Credentials saved!")

凭据存储在 ~/.dataforseo_config.json 中。要更新凭据，请重新运行设置。

快速入门

import sys, os
sys.path.insert(0, os.path.expanduser('~/.agents/skills/dataforseo/scripts'))
from dataforseo_client import *

# Example: Get search volume
response = keywords_search_volume(
    keywords=["seo tools", "keyword research"],
    location_name="United States"
)
results = extract_results(response)
csv_path = to_csv(results, "keyword_volumes")
print(f"Results saved to: {csv_path}")

API 选择指南

用户请求要使用的函数
搜索量、CPC、竞争度keywords_search_volume()
关键词创意/建议labs_keyword_ideas() 或 labs_related_keywords()
网站排名所用的关键词labs_ranked_keywords()
关键词的 SERP 结果serp_google_organic()
本地/地图排名serp_google_maps()
YouTube 排名serp_youtube()
反向链接概况backlinks_summary()
反向链接列表backlinks_list()
引荐域名backlinks_referring_domains()
域名权威度/排名backlinks_bulk_ranks()
竞争域名labs_competitors_domain()
关键词差距分析labs_domain_intersection()
链接差距分析backlinks_domain_intersection()
页面技术审计onpage_instant_pages()
Lighthouse 评分lighthouse_live()
技术栈domain_technologies()
品牌提及content_search()
Google Trendsgoogle_trends()

核心工作流

  1. 导入客户端：添加技能路径并导入函数
  2. 调用 API 函数：传入必需参数
  3. 提取结果：使用 extract_results(response)
  4. 导出为 CSV：使用 to_csv(results, "filename")
import sys, os
sys.path.insert(0, os.path.expanduser('~/.agents/skills/dataforseo/scripts'))
from dataforseo_client import labs_ranked_keywords, extract_results, to_csv

response = labs_ranked_keywords(
    target="competitor.com",
    location_name="United States",
    language_name="English",
    limit=500
)
results = extract_results(response)
csv_path = to_csv(results, "ranked_keywords")

默认参数

大多数函数使用以下默认值：

  • location_name："United States"（可替换为 "India"、"United Kingdom" 等）
  • language_name："English"
  • limit：100（如需更多结果，可提高至 1000）
  • device："desktop"（SERP 也可使用 "mobile"）

常用地点名称

  • United States、United Kingdom、India、Germany、Australia、Canada
  • 城市级地点示例："New York,New York,United States"、"London,England,United Kingdom"

输出

所有结果都会导出为 CSV，保存到 ~/dataforseo_outputs/。如果未指定文件名，文件会自动使用时间戳命名。

参考文件

  • API 参考：references/api_reference.md - 完整的端点文档
  • 使用案例：references/use_cases.md - 可直接使用的代码示例

错误处理

response = some_api_function(...)
if response.get("status_code") == 20000:
    results = extract_results(response)
    # Process results
else:
    print(f"Error: {response.get('status_message')}")

速率限制与费用

  • 每分钟最多 2000 个请求
  • Live 方法的费用高于 Standard 方法
  • 使用 get_user_data() 查看用量
  • 响应包含 cost 字段

重要说明

  1. 异步端点：某些 API（merchant、app_data、business reviews）会创建任务。请单独检查任务状态。
  2. 限制：提高 limit 参数以获取全面的数据（默认值为 100，通常最大值为 1000）
  3. 多个关键词：以列表形式传入：keywords=["kw1", "kw2", "kw3"]

评论

支持 Markdown