Untapped SERP

本地服务

github.com商业与营销06 天前更新

代码仓库访问官网

关于 Untapped SERP

Untapped SERP 通过用户自己的 DataForSEO 账户，为 Codex 和 Claude Code 提供 Google 搜索结果与搜索量数据。它包含费用估算、支出记录和付费调用的每日上限。

主要功能

01获取本地化 Google 搜索结果
02查询搜索量、CPC、竞争度和趋势
03估算调用费用
04跟踪每日及每月支出
05缓存结果并执行每日上限

适用场景

01查看特定关键词和地点的 Google 结果
02查询关键词列表的月搜索量
03检查 SERP 功能和域名排名
04付费查询前估算费用

MCP 相关

向 MCP 客户端提供 Google SERP、搜索量、费用估算和支出查询工具，并使用已配置的 DataForSEO 账户。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

暂未收录安装方式

我们还没有获取到这个服务的安装包或远程地址，请按项目 README 中的说明安装。

代码仓库

安装包

mcpbuntapped-serp-mcp-0.2.0.mcpb0.2.0stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

Untapped SERP

通过你自己的 DataForSEO 账户，为你的 AI Agent（Codex 或 Claude Code）获取真实的 Google 搜索结果和搜索量，并设置每日支出上限。由 Find Untapped Growth 构建。

内置网页搜索只能从自身索引中为 Agent 提供少量结果。此插件则能提供 Google 针对特定地点的搜索词实际展示的内容：排名、「用户还问了」、本地商家信息、AI Overview 引用的网站、精选摘要，以及指定域名占据的所有位置。它还可提供 Google Ads 月搜索量。

工具

工具	功能	你的费用（DataForSEO 标价，读取于 2026-10-09）
`google_serp`	获取指定关键词、地点和设备的实时 Google 自然搜索结果	每 10 条结果收费 $0.002（深度为 10 时收费 $0.002）；`site:` 等搜索运算符的费用为 5 倍
`google_search_volume`	查询 1–100 个关键词的月搜索量、CPC、竞争度和 12 个月趋势（使用 `allow_large_batch` 时最多 1000 个）	每次调用收费 $0.09，关键词数量不限
`serp_estimate`	估算调用费用，并检查今天的支出上限是否允许调用	免费
`serp_spend`	查询今日和本月支出、上限、最近 10 次调用，以及凭据是否已设置	免费

价格：SERP · 按深度计费 · Google Ads 搜索量。插件会记录每条响应报告的费用，因此支出记录反映的是 DataForSEO 实际收取的费用，而非我们的估算。

安装

Claude Code： /plugin install untapped-serp --marketplace CTF-Max/untapped-plugins （也可以在终端中运行：claude plugin marketplace add CTF-Max/untapped-plugins，然后运行 claude plugin install untapped-serp@untapped-plugins）。
Codex： 运行 codex plugin marketplace add CTF-Max/untapped-plugins，然后运行 codex plugin add untapped-serp@untapped-plugins。
需要在 PATH 中安装 Python 3.10+，并将其命名为 python。仅使用标准库：无需通过 pip install 安装任何内容。

设置

创建 DataForSEO 账户，并复制 API 登录名和密码（控制面板 → API Access）。
将它们提供给插件：
- Claude Code 会在启用插件时要求你在插件设置中输入凭据（之后可通过 /plugin → untapped-serp → configure 进行配置）。凭据保存在电脑的安全凭据存储区中，而非设置文件中。
- Codex： 将它们设置为环境变量，然后重启 Codex：
```
setx DATAFORSEO_LOGIN "[email protected]"
setx DATAFORSEO_PASSWORD "your-api-password"
```
  （macOS/Linux：在 shell 配置文件中使用 export 设置它们。）

设置项

设置项（Claude Code）/ 变量	默认值	含义
每日支出上限 / `UNTAPPED_SERP_DAILY_CAP_USD`	`1.00`	当本 UTC 日已扣费金额加上正在处理的支出将超过此上限时，停止付费调用
`UNTAPPED_SERP_SANDBOX`	关闭	`1` = 使用 DataForSEO 的免费沙盒（虚拟数据，标记为 `sandbox: true`）
`UNTAPPED_SERP_HOME`	`~/.untapped-plugins/serp`（Windows：`C:\Users\<you>\.untapped-plugins\serp`）	缓存和支出记录的存放位置

费用保障

在缓存有效期内重复相同请求（SERP 为 24 小时，搜索量为 30 天）不会产生新费用。max_age_hours: 0 会强制获取最新结果。
结果未知的调用（超时、连接中断）绝不会自动重试；预留费用仍会计入今日支出上限。
只会调用 api.dataforseo.com（或 sandbox.dataforseo.com）上的两个 HTTPS 端点；拒绝使用代理和重定向，确保凭据不会发送到其他位置。
dry_run: true 或 serp_estimate 可显示费用，但不会发起调用。

值得了解的限制

一次 SERP 查询仅对应一个地点、一种设备和一个时间点。排名会随街区和时间变化。
Google Ads 搜索量以区间形式取整；对于较小的本地搜索词，常常为 null（无数据）；null 绝不等于零。
target: "not in top N" 表示在已获取的结果中未找到，而非「未被收录」。

开发

python -m unittest discover -s untapped-serp/tests   # offline, 21 tests
python tools/sync_shared.py --check                  # shared MCP lib copies are current
python tools/serp_smoke.py                           # free sandbox round trip

支持 Markdown

登录后评论