google-forums-search

Google Forums 検索

Frevana 経由で Google Forums の検索結果を取得します。

目的

このスキルは、Google の「Forums」タブからフォーラム形式の検索結果を見つけるためのものです。

入力：

• q
• 任意の device
• 任意の hl
• 任意の gl
• 任意の start
• 任意の start_date
• 任意の end_date

出力：

• Google Forums の検索結果を含む、検証済みのレスポンス JSON
• 正常に実行されるたびにローカルファイルに保存される、同じ検証済み JSON

このスキルはレスポンスが JSON であることを検証し、ディスクに保存してから、変更せずに標準出力へ返します。ユーザーから変換を明示的に求められない限り、返されたデータを書き換えたり、再構成したりしないでください。

このスキルに必要なもの

• ユーザーが指定する q
• 任意の device
• 任意の hl
• 任意の gl
• 任意の start
• 任意の start_date
• 任意の end_date
• 環境変数の FREVANA_TOKEN、または今回の実行時に指定する --token オーバーライド
• curl
• bash
• python3

実行順序

リクエストをシンプルかつ確実に保つため、次の手順に従ってください。

1. ユーザーが q または同等のフォーラム検索クエリを指定していることを確認します。
2. 場当たり的な curl コマンドではなく、スクリプトを優先して使います。
3. まずスクリプトに FREVANA_TOKEN を読み込ませます。
4. 対話型のシェルで使用する場合、FREVANA_TOKEN が設定されていなければ、スクリプトから入力を求めてもかまいません。
5. 非対話型の環境またはエージェントのワークフローでは、トークンが設定されていなければ直ちに失敗させ、ユーザーに FREVANA_TOKEN を設定するか、--token を明示的に指定するよう伝えます。
6. スクリプトを一度実行します。検証済みの JSON が標準出力に出力され、同じ JSON がファイルに保存されます。
7. 追加の解析や要約には、検索 API を再度呼び出すのではなく、保存済みの JSON ファイルを使用します。
8. 検証済みのレスポンス JSON を返すか、ユーザーがペイロード全体を必要としていない場合は、関連性の高いフォーラム検索結果を要約します。

コマンド

基本的なフォーラム検索

bash <skill-path>/scripts/search_google_forums.sh \
  --q "best programming language"

--query は --q のエイリアスとして使用できます。

国、言語、デバイスを指定して検索

bash <skill-path>/scripts/search_google_forums.sh \
  --q "vibe coding" \
  --gl us \
  --hl en \
  --device mobile

ページネーションと日付範囲を指定して検索

bash <skill-path>/scripts/search_google_forums.sh \
  --q "vibe coding" \
  --start 10 \
  --start-date 20260101 \
  --end-date 20260525

レスポンス JSON を指定したファイルに保存

bash <skill-path>/scripts/search_google_forums.sh \
  --q "vibe coding" \
  --output ./out/google-forums-search-result.json

今回の実行時にトークンをオーバーライド

bash <skill-path>/scripts/search_google_forums.sh \
  --q "vibe coding" \
  --token "your bearer token"

固定リクエスト形式

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

{
  "q": "vibe coding",
  "device": "mobile",
  "hl": "en",
  "gl": "us",
  "start": 10,
  "start_date": "20260101",
  "end_date": "20260525"
}

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

現在、Frevana エンドポイントのスキーマで公開されているのは q、device、hl、gl、start、start_date、end_date のみです。engine、api_key、output、no_cache、async、zero_trace など、サポートされていないパススルーフィールドは渡さないでください。また、Frevana エンドポイントのスキーマが拡張されるまでは、location、uule、period_unit、period_value、nfpr、filter、tbs など、その他のサポートされていない Google Forums フィールドも渡さないでください。

レスポンス形式

API は Frevana の JSON を返します。一般的なフィールドには次のものがあります。

• search_metadata
• search_parameters
• search_information
• organic_results
• related_searches
• pagination
• pagination

出力

• 成功時：スクリプトはレスポンス本文が JSON であることを検証し、ファイルに書き込み、保存先のパスを標準エラー出力に表示して、JSON を標準出力に出力します
• デフォルトのファイルパス：./out/google-forums-search-<UTC timestamp>-<pid>.json
• --output を指定した場合：デフォルトのパスではなく、指定されたファイルパスに同じ JSON が書き込まれます
• 失敗時：スクリプトはレスポンス本文または解析エラーを表示し、ゼロ以外の終了コードで終了します

注意事項

• --q または --query が必要です
• 結果を保存して要約するためだけにスクリプトを 2 回実行しないでください。常に、表示されるものと同じ JSON を保存します。
• --device は desktop、mobile、tablet のいずれかにのみ使用してください
• ユーザーが言語コードを指定した場合は --hl を使用してください
• ユーザーが国コードを指定した場合は --gl を使用してください
• ユーザーが結果オフセットによるページネーションを指定した場合は --start を使用してください
• --start-date と --end-date は、ユーザーが特定の日付範囲を指定した検索を求めた場合にのみ使用してください。Frevana では YYYYMMDD 形式の日付文字列を使用します
• curl が見つからない場合は、処理を中止し、curl をインストールするようユーザーに伝えてください
• python3 が見つからない場合は、処理を中止し、python3 をインストールするようユーザーに伝えてください
• Bearer トークンをユーザーにそのまま返さないでください
• ユーザーが完全なペイロードを求めていない限り、フォーラムのタイトル、ソース／コミュニティ、リンク、スニペット、コメント／回答数、日付、サイトリンク、利用可能な場合は後続のページネーション情報を要約してください

プロンプトの例

中国語

• 「Google Forums で vibe coding を検索」
• 「Google Forums で q=vibe coding、gl=us、hl=en、モバイル端末を指定して検索」
• 「Google Forums で AI coding を 20260101 から 20260525 まで検索し、生の JSON を保存」

英語

• 「Google Forums で vibe coding を検索」
• 「gl=us、hl=en、device=mobile を指定して、Google Forums の検索結果を調べて」
• 「Google Forums で AI coding を 20260101 から 20260525 まで検索し、生の JSON を保存」