google-news-search

Google News 検索

Frevana を通じて Google News を検索します。

目的

このスキルは、Google News の検索結果を見つけるためのものです。

入力：

• q
• 任意の gl
• 任意の hl
• 任意の topic_token
• 任意の publication_token
• 任意の section_token
• 任意の story_token

出力：

• Google News の検索結果を含む、検証済みのレスポンス JSON

このスキルはレスポンスが JSON であることを検証し、変更せずに返します。ユーザーが明示的に変換を依頼しない限り、返されたデータを書き換えたり、再構成したりしないでください。

このスキルに必要なもの

• ユーザーが指定する q
• 任意の gl
• 任意の hl
• 任意の topic_token
• 任意の publication_token
• 任意の section_token
• 任意の story_token
• 環境変数の FREVANA_TOKEN、または今回の実行に対する明示的な --token オーバーライド
• curl
• bash
• python3

実行順序

リクエストをシンプルかつ確実にするため、次の手順を使用してください。

1. ユーザーが q または同等の検索クエリを指定していることを確認します。
2. アドホックな curl コマンドよりもスクリプトを優先します。
3. まずスクリプトに FREVANA_TOKEN を読み込ませます。
4. 対話型シェルで使用する場合、FREVANA_TOKEN が設定されていなければ、スクリプトが入力を求めることがあります。
5. 非対話型またはエージェントのワークフローでは、トークンが設定されていない場合はすぐに失敗させ、ユーザーに FREVANA_TOKEN の設定、または --token の明示的な指定を促します。
6. 検証済みのレスポンス JSON を返すか、ユーザーが完全なペイロードを必要としていない場合は、最も関連性の高いニュース項目を要約します。
7. 必要に応じて、JSON をファイルにも保存します。

コマンド

基本的なニュース検索

bash <skill-path>/scripts/search_google_news.sh \
  --q "artificial intelligence"

--query は --q の別名として使用できます。

国と地域、言語を指定して検索

bash <skill-path>/scripts/search_google_news.sh \
  --q "artificial intelligence" \
  --gl US \
  --hl en

Google News トークンを使った検索

bash <skill-path>/scripts/search_google_news.sh \
  --q "economy" \
  --topic-token "CAAqJggKIiBDQkFTRWdvSUwyMHZNRGcxY1Y4U0FIVnVHZ0pWVXlnQVAB"

レスポンス JSON をファイルに保存

bash <skill-path>/scripts/search_google_news.sh \
  --q "artificial intelligence" \
  --gl US \
  --hl en \
  --output ./out/google-news-search-result.json

今回の実行に対するトークンのオーバーライド

bash <skill-path>/scripts/search_google_news.sh \
  --q "artificial intelligence" \
  --token "your bearer token"

固定リクエスト形式

スクリプトは、指定されていない任意のフィールドを省略して、次の形式のペイロードを送信します。

{
  "q": "artificial intelligence",
  "gl": "US",
  "hl": "en",
  "topic_token": "CAAq..."
}

必須なのは q のみです。ユーザーが指定していない gl、hl、トークン値を作り出さないでください。

レスポンス形式

API は JSON を返します。このスキルはレスポンスが JSON であることを検証し、変更せずに返します。

出力

• 成功：スクリプトはレスポンス本文が JSON であることを検証し、標準出力に表示します
• --output を指定した場合：同じ JSON を指定されたファイルパスにも書き込みます
• 失敗：スクリプトはレスポンス本文または解析エラーを表示し、ゼロ以外の終了コードで終了します

注意事項

• --q または --query を必須とします
• ユーザーが特定の国または地域を指定した場合は --gl を使用します
• ユーザーが特定の言語を指定した場合は --hl を使用します
• トークンフィールドは、ユーザーが対応する Google News トークンを指定した場合にのみ使用します
• curl がない場合は処理を停止し、ユーザーに curl のインストールを促します
• python3 がない場合は処理を停止し、ユーザーに python3 のインストールを促します
• Bearer トークンをユーザーに表示しないでください
• ユーザーが完全なペイロードを求めている場合を除き、生の JSON をそのまま出力するのではなく、ユーザーが実際に知りたいニュース結果を要約します

プロンプトの例

中国語

• 「Google News で AI ニュースを検索して」
• 「Google News で q=tesla、gl=US、hl=en の条件で調べて」
• 「この topic_token を使って Google News を検索し、生の JSON を保存して」

英語

• 「Google News で人工知能を検索して」
• 「gl=US と hl=en を指定して、Tesla の Google News 検索結果を調べて」
• 「この topic token を使って Google News を検索し、生の JSON をファイルに保存して」