mcpField
G
google-search

google-search

github.com/fetcher-sh数据与数据库24.0k 次安装8 周前更新
代码仓库

关于 google-search

Google Search 通过 HTTP API 向开发者和 Agent 提供 Google 网页搜索结果。它支持搜索运算符、分页和地区参数，可使用预付额度或 x402 按次付费，并提供 MCP 端点。

主要功能

  1. 01以 JSON 返回 Google 网页搜索结果
  2. 02支持 Google 搜索运算符
  3. 03设置页码、语言和地区
  4. 04选择预付额度或 x402 付款
  5. 05提供 Google Search MCP 工具

适用场景

  1. 01查找限定在特定网站的页面
  2. 02搜索 PDF 或精确短语
  3. 03获取本地化搜索结果
  4. 04将搜索接入 MCP 客户端

MCP 相关

服务在 https://google.fetcher.sh/mcp 提供 MCP 端点。客户端可使用免费的发现和余额工具、付费的数据获取工具及 google_search 快捷工具；认证可使用 Bearer 密钥或 x402。

安装

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

$npx skills add https://github.com/fetcher-sh/fetcher-skills --skill google-search

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

详细介绍

Google 搜索 API

Google 提供的原生搜索结果，以简洁的 JSON 格式返回——每次调用只需发送一次普通 HTTP GET 请求，按使用量付费。Google 的搜索运算符可直接使用：site:、filetype:、intitle: 和带引号的精确短语，效果与在浏览器中完全一致。无需设置 Custom Search Engine，无每日查询配额，也无需账单账户。

基础 URL：https://google.fetcher.sh

身份验证

有两种付费方式，数据相同——完整机制请参阅 fetcher skill：

# 1. Prepaid credits (recommended — get a key at https://fetcher.sh/topup
#    or via POST /api/credits/topup, see the fetcher skill)
export FETCHER_API_KEY="bby_live_xxxxxxxxxxxx"
curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://google.fetcher.sh/api/search?query=hello"

# 2. x402 pay-per-call — omit the header; a GET with no payment returns 402
#    with machine-readable payment requirements (USDC on Base, Polygon,
#    Arbitrum, Monad, or Solana). @x402/fetch signs and retries automatically.

每个响应的格式都是 { "status": number, "message": string, "data": ... }；HTTP 状态码与 status 一致。

端点（$0.005/次调用）

端点返回内容
/api/search指定查询的 Google 网页搜索结果

必需参数：query。可选参数：safe（SafeSearch）、page（分页）、hl（界面语言，例如 en）、country（地区范围）、count（每页结果数，目前为 10）、noEncode（对于预先格式化的运算符字符串，跳过查询重新编码）。

使用场景

限定在单个网站内搜索：

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "query=site:github.com x402 payments" -G \
  "https://google.fetcher.sh/api/search"

仅搜索 PDF：

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "query=agentic commerce filetype:pdf" -G \
  "https://google.fetcher.sh/api/search"

精确短语：

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode 'query="pay per call api"' -G \
  "https://google.fetcher.sh/api/search"

本地化结果（英国，法语界面）并分页：

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "query=agentic commerce" -G \
  --data-urlencode "country=GB" \
  --data-urlencode "hl=fr" \
  --data-urlencode "page=2" \
  "https://google.fetcher.sh/api/search"

组合运算符——标题匹配并限定网站：

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "query=intitle:pricing site:x402.org" -G \
  "https://google.fetcher.sh/api/search"

MCP

{
  "mcpServers": {
    "google-search": {
      "url": "https://google.fetcher.sh/mcp",
      "headers": { "Authorization": "Bearer bby_live_..." }
    }
  }
}

免费工具：search_endpoints、describe_endpoint、check_balance。付费工具：fetch_data（上述任意端点）、topup_credits，以及命名快捷工具 google_search。移除 headers 区块即可改用 x402 按次付费——完整流程请参阅 fetcher skill。

错误

  • 400 — 缺少或无效的参数（消息中会指出参数名称）
  • 401 — 未知密钥或密钥已轮换
  • 402 — 需要付款（x402 挑战）或 topup_required（额度已用尽）
  • 404 — 非定价路径
  • 无速率限制；上游故障不退款（先结算，再交付）

参考

评论

支持 Markdown