mcpField
G
google-news

google-news

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

关于 google-news

google-news 是通过 fetcher.sh 获取 Google News 头条和搜索结果的技能，说明如何按语言地区查询、获取分类与主题头条，以及解析文章链接。

主要功能

  1. 01按语言版本搜索关键词头条
  2. 02获取最新及分类头条
  3. 03按主题 ID 获取头条
  4. 04查询支持的语言和地区代码
  5. 05将重定向网址解析为文章链接

适用场景

  1. 01搜索指定语言版本的新闻头条
  2. 02获取科技或商业分类头条
  3. 03将 Google News 重定向链接转换为文章网址

MCP 相关

可连接 https://google-news.fetcher.sh/mcp。MCP 提供端点发现、余额查询、数据获取、积分充值及 google_news_search 快捷工具。

安装

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

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

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

详细介绍

Google News API

将 Google News 头条和搜索结果以整洁的 JSON 格式返回——每次调用只需发送一个普通的 HTTP GET 请求，按使用量付费。无需抓取 RSS 订阅源，无需手动解码重定向 URL，也无需调用未公开的内部端点。

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

身份验证

两种付费方式，相同的数据——完整的机制说明请参阅 fetcher 技能：

# 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-news.fetcher.sh/api/search?keyword=hello&languageCode=en-US"

# 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 相同。

端点（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 解析为真实文章 URL

除 /api/language-regions 外，所有端点都必须提供 languageCode（例如 en-US、en-GB、fr-FR）。/api/language-regions 不接受任何参数，专门用于列出有效值。/api/search 还必须提供 keyword；/api/decode-article-url 还必须提供 url。

使用场景

搜索关键词，使用美式英语版本：

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "keyword=stablecoin regulation" -G \
  --data-urlencode "languageCode=en-US" \
  "https://google-news.fetcher.sh/api/search"

使用相同关键词搜索，改用英式英语版本：

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "keyword=ai policy" -G \
  --data-urlencode "languageCode=en-GB" \
  "https://google-news.fetcher.sh/api/search"

板块头条新闻（科技、商业）：

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "languageCode=en-US" -G \
  "https://google-news.fetcher.sh/api/technology"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "languageCode=en-US" -G \
  "https://google-news.fetcher.sh/api/business"

获取指定主题 ID 的头条新闻：

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "languageCode=en-US" -G \
  "https://google-news.fetcher.sh/api/topic/CAAqJggKIiBDQkFTRWdvSUwyMHZNRGxqTVdZU0FtVnVHZ0pWVXlnQVAB"

选择语言/地区代码前，先列出所有受支持的代码：

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://google-news.fetcher.sh/api/language-regions"

将 Google News 重定向 URL 解码为真实文章链接：

curl -H "Authorization: Bearer $FETCHER_API_KEY" -G \
  --data-urlencode "url=https://news.google.com/rss/articles/CBMi..." \
  "https://google-news.fetcher.sh/api/decode-article-url"

MCP

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

免费工具：search_endpoints、describe_endpoint、check_balance。付费工具：fetch_data（可调用上述任意端点）、topup_credits，以及名为 google_news_search 的快捷工具。改用 x402 按次付费时，移除 headers 代码块即可——完整流程请参阅 fetcher 技能。

错误

  • 400 — 参数缺失或无效（消息会指出具体参数）——最常见的情况是缺少 languageCode
  • 401 — 密钥未知或已轮换
  • 402 — 需要付款（x402 挑战）或 topup_required（积分已用尽）
  • 404 — 该路径未定价
  • 不设速率限制；上游故障不退款（先结算，后交付）

参考

评论

支持 Markdown