用途:通过普通 HTTP GET 获取 Google News 头条与搜索结果,输出干净 JSON,避免 RSS 抓取、重定向 URL 手工解码和未公开内部端点。基础 URL 为 https://google-news.fetcher.sh。
主要能力:共 12 个 GET 端点,每次调用 $0.005,包括 /api/search(按关键词搜索)、/api/latest(最新头条)、/api/world、/api/business、/api/technology、/api/entertainment、/api/sport、/api/science、/api/health 各版块头条、/api/topic/{topicId}(任意话题 ID 头条)、/api/language-regions(列出所有受支持的 languageCode)、/api/decode-article-url(把 Google News 重定向 URL 解析为真实文章链接)。除 /api/language-regions 外,每个端点都必须提供 languageCode(如 en-US、en-GB、fr-FR);/api/search 还额外要求 keyword,/api/decode-article-url 要求 url。响应统一为 { "status": number, "message": string, "data": ... },HTTP 状态与 status 一致。
使用方式:两种付费方式,数据相同。其一为预付费额度,在 https://fetcher.sh/topup 或通过 POST /api/credits/topup 获取密钥,然后请求带 Authorization: Bearer $FETCHER_API_KEY;其二为 x402 按次付费,省略该请求头,无付款的 GET 会返回 402 及机器可读付款要求(USDC,支持 Base、Polygon、Arbitrum、Monad 或 Solana),@x402/fetch 可自动签名重试。也可通过 MCP 接入,地址 https://google-news.fetcher.sh/mcp,并在 headers 中提供 Bearer 密钥;免费工具为 search_endpoints、describe_endpoint、check_balance,付费工具为 fetch_data(调用上述任一端点)、topup_credits,以及快捷工具 google_news_search。
适用场景:需要以编程方式做关键词新闻检索、按版块拉取头条、按话题 ID 取新闻,或把 Google News 跳转链接还原为原始文章地址的自动化流程与智能体。
限制:无速率限制;上游失败不退款(结算先于交付)。错误码:400 参数缺失或无效(最常为缺少 languageCode)、401 密钥未知或已轮换、402 需付款或额度耗尽、404 非计价路径。更多资料见 https://google-news.fetcher.sh/skill.md、https://google-news.fetcher.sh/openapi.json、https://google-news.fetcher.sh/llms.txt。