SuperAPI AI 工具集

google-search

数据与分析

查看项目

更新于 10-16 07:20

技能介绍

用途:该服务提供 Google 搜索结果的 JSON 接口,可作为 Google Search API 或 SERP API 的替代。每次调用为一次普通 HTTP GET,按次付费。支持 Google 搜索运算符,如 site:、filetype:、intitle: 和带引号的精确短语。无需设置自定义搜索引擎,无每日查询配额,无需计费账户。

主要能力:基础 URL 为 https://google.fetcher.sh。端点 /api/search 返回某个查询词的 Google 网页搜索结果,计费为每次调用 $0.005。必需参数为 query,可选参数包括 safe(SafeSearch)、page(分页)、hl(界面语言,如 en)、country(地区范围)、count(每页结果数,目前为 10)、noEncode(对预格式化运算符字符串跳过查询重编码)。每次响应结构为 { "status": number, "message": string, "data": ... },HTTP 状态码与 status 一致。

使用方式:认证有两种,数据相同。其一是预付费信用,设置 FETCHER_API_KEY 后通过 Authorization: Bearer 头调用;其二是 x402 按次付费,省略该头,未付款的 GET 会返回 402 及机器可读的付款要求(USDC,支持 Base、Polygon、Arbitrum、Monad 或 Solana),可用 @x402/fetch 自动签名并重试。示例命令:curl -H "Authorization: Bearer $FETCHER_API_KEY" "https://google.fetcher.sh/api/search?query=hello"。也可通过 MCP 配置调用,URL 为 https://google.fetcher.sh/mcp,headers 中带 Authorization: Bearer bby_live_...。免费工具包括 search_endpoints、describe_endpoint、check_balance;付费工具包括 fetch_data、topup_credits 以及快捷方式 google_search。

适用场景:将 Google 搜索结果集成到智能体或程序中,进行普通网页检索、限定站内搜索、按文件类型检索、精确短语匹配、本地化结果与分页查询等。

限制:错误码包括 400(缺少或无效参数)、401(未知或已轮换的密钥)、402(需要付款或信用耗尽)、404(非计价路径)。无速率限制;上游失败不退款,因为结算先于交付。完整代理设置见 https://google.fetcher.sh/skill.md,OpenAPI 3.1 契约见 https://google.fetcher.sh/openapi.json,精简目录见 https://google.fetcher.sh/llms.txt。