mcpField
D
dataforseo-tool

dataforseo-tool

github.com/garrettjsmith营销与增长13664 次安装11 周前更新
代码仓库

关于 dataforseo-tool

为 SEO 批量数据操作和自定义数据管道提供 DataForSEO 官方 MCP 服务的使用指南。适合需要大批量关键词、SERP 或商家数据，以及构建程序化系统的团队。

主要功能

  1. 01批量关键词搜索量数据
  2. 02批量 SERP 与地图结果
  3. 03Google 商家资料和评论
  4. 04自定义排名监测方案
  5. 05异步任务处理建议

适用场景

  1. 01一次查询大量关键词的搜索量
  2. 02比较多地多个关键词的本地排名
  3. 03批量采集竞争对手商家资料
  4. 04构建自定义排名仪表板

MCP 相关

DataForSEO 提供官方 MCP 服务，可供客户端执行 SERP、关键词、商家和反向链接数据操作。该技能将其定位为批量处理和自定义开发的数据接口。

安装

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

$npx skills add https://github.com/garrettjsmith/localseoskills --skill dataforseo-tool

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

详细介绍

DataForSEO 工具

**注意：**LocalSEOData（localseodata-tool）基于 DataForSEO 构建，为大多数本地 SEO 数据需求提供简化且预先组装好的解决方案。默认使用 LocalSEOData。对于大规模批量操作（1000+ 个查询）或需要原始 API 访问权限的自定义流水线构建，DataForSEO 仍是合适的选择。

DataForSEO 提供官方 MCP 服务。连接后，可使用它批量处理 SEO 数据操作——包括 SERP 结果、关键词搜索量、商家数据和大规模反向链接数据。这是你的批量数据和自定义工具 API。

何时使用 DataForSEO，而非其他工具

你的需求使用 DataForSEO改用
一次获取 500+ 个关键词的搜索量✅ 最适合批量处理Semrush（适合较小批次）
获取大量关键词+地理位置组合的 SERP 结果✅ 最适合大规模处理SerpAPI（适合单次查询）
以编程方式获取 Google Maps 商家数据✅—
通过 API 获取某个商家的 Google 评价✅—
大规模监控本地 Pack（自定义构建）✅Local Falcon（即用型解决方案）
反向链接数据⚠️ 提供此类数据，但索引较小Ahrefs（优先选择）
单个关键词研究❌ 大材小用Semrush
单次 SERP 检查❌ 大材小用SerpAPI
引用审计❌BrightLocal
地理网格排名可视化❌Local Falcon

何时适合使用 DataForSEO

以下情况适合使用 DataForSEO：

  • 规模：你需要一次获取 100+ 个关键词、50+ 个地理位置或 20+ 个竞争对手的数据
  • 自定义构建：你正在构建仪表板、工具或自动化系统
  • 编程访问：你需要用于处理的结构化数据，而非供人阅读的数据
  • 大规模成本效益：对于批量操作，按任务付费比订阅工具更划算

以下情况不适合使用 DataForSEO：

  • 你只需要快速查询一个答案（使用 SerpAPI 或 Semrush）
  • 你需要带有可视化功能的即用型产品（使用 Local Falcon、BrightLocal）
  • 你需要进行编辑类链接分析（使用 Ahrefs）

核心工作流

批量获取本地关键词搜索量

**何时使用：**你有一份较长的关键词列表，需要获取其中所有关键词的搜索量数据。

端点：

  • keywords_data/google_ads/search_volume — 获取关键词列表的搜索量、CPC 和竞争程度
  • keywords_data/google_ads/keywords_for_site — 获取某个域名获得流量的关键词

**使用场景：**你通过 local-keyword-research 生成了 200 个“服务+城市”关键词组合。无需在 Semrush 中逐个查询，可将它们批量提交给 DataForSEO。

**获取的数据：**每个关键词的搜索量、CPC、竞争程度和月度趋势。

批量获取 SERP 数据

**何时使用：**你需要检查大量关键词或地理位置中是否出现本地 Pack。

端点：

  • serp/google/organic/live — 包含本地 Pack 的完整 SERP
  • serp/google/maps/live — Google Maps 结果
  • serp/google/local_finder/live — 专门获取本地查找器结果

**使用场景：**检查 10 个城市中的 50 个关键词，确认哪些关键词会触发本地 Pack，以及哪些商家会出现在其中。这相当于 500 次 SERP 检查，手动操作几乎不可能，但通过 DataForSEO 就轻而易举。

要提取的信息：

  • 是否出现本地 Pack？（确认本地搜索意图）
  • 本地 Pack 中有哪些商家？（识别竞争对手）
  • 是否出现广告？（判断商业价值）
  • 是否出现 AI Overview？（内容优化信号）
Google 商家数据

**何时使用：**你需要以编程方式获取竞争对手或某个市场的 GBP 信息。

端点：

  • business_data/google/my_business_info — GBP 详情（名称、地址、类别、营业时间、照片等）
  • business_data/google/reviews — Google 评价，包括文本、评分和日期

使用场景：

  • 提取某个市场中排名靠前的 20 个竞争对手的 GBP 数据，以比较类别、评价数量和评分
  • 提取评价进行情感分析
  • 随时间监控竞争对手 GBP 的变化
自定义本地排名监控

适用场景： 构建自定义排名工具或仪表板，而不是使用 Local Falcon。

方法：

  1. 为服务区域定义坐标网格
  2. 对每个坐标，使用目标关键词运行 serp/google/maps/live
  3. 解析结果，查找目标商家在每个点的位置
  4. 汇总为 ARP/SoLV 风格的指标
  5. 设定每周／每月运行计划

何时构建自定义方案，何时使用 Local Falcon：

  • Local Falcon：开箱即用、可视化、支持活动管理，并可分享报告给客户
  • DataForSEO 自定义方案：完全可控、可自定义指标、可集成到自己的系统中，且在超大规模使用时成本更低

了解定价

  • 按任务付费模式——每次 API 调用都会消耗额度
  • SERP 任务：每条结果约 $0.002-0.005
  • 关键词数据：每批关键词约 $0.05
  • 商家数据：每条结果约 $0.005
  • 批量操作前，务必估算总成本
  • 大批量任务使用异步端点（提交任务并轮询结果）

下一步

获取的数据下一步操作技能
批量关键词搜索量按服务分组，映射到页面，并根据搜索量 × 意图确定优先级local-keyword-research
显示本地包结果的 SERP 数据针对包含本地包的关键词，重点优化 GBPgbp-optimization
竞争对手的 GBP 数据分析类别使用情况、评论基准和服务覆盖范围local-competitor-analysis
提取的竞争对手评论分析情感主题以及常见的抱怨／赞扬review-management
自定义排名数据使用地理网格分析框架进行解读geogrid-analysis

默认下一步： DataForSEO 为你提供原始数据。务必结合分析技能，将数据转化为决策。

评论

支持 Markdown