google-news

Google News API

Google News のヘッドラインと検索結果を、クリーンな JSON で取得できます。呼び出しごとにプレーンな HTTP GET を 1 回実行し、使った分だけ支払います。RSS フィードのスクレイピングや、リダイレクト URL の手動デコード、非公開の内部エンドポイントは不要です。

ベース URL：https://google-news.fetcher.sh

認証

支払い方法は 2 種類ありますが、取得できるデータは同じです。詳しい仕組みについては、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-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、1 回あたり $0.005）

エンドポイント	取得内容
/api/search	1 つの言語版で、キーワードに一致するヘッドライン
/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 に解決

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 skill をご覧ください。

エラー

• 400 — パラメーターの欠落または無効（メッセージに該当のパラメーターが示されます）。最も一般的なのは languageCode の欠落です
• 401 — 不明なキー、またはローテーション済みのキー
• 402 — 支払いが必要（x402 チャレンジ）、または topup_required（クレジット残高の枯渇）
• 404 — 価格設定されていないパス
• レート制限はありません。上流での障害による返金もありません（配信前に決済されます）

リファレンス

• エージェントの完全なセットアップ：https://google-news.fetcher.sh/skill.md
• OpenAPI 3.1 コントラクト：https://google-news.fetcher.sh/openapi.json
• 簡潔なカタログ：https://google-news.fetcher.sh/llms.txt
• 支払い、クレジット、MCP の詳細：fetcher skill
• サイト：https://google-news.fetcher.sh