google-trends

Google Trends スキル

Google Trends から、任意の国とカテゴリのリアルタイムの急上昇検索ワードを取得します。

このスキルを使用するタイミング

次のような場合に起動します：

• 「[国]で今話題になっているものは？」と尋ねられた場合
• 「[国]で人気の[ゲーム／AI／テクノロジー／スポーツなど]」と尋ねられた場合
• 「[国]の Google Trends」と言われた場合
• 国ごとのトレンドを比較したい場合
• /google-trends が呼び出された場合

パラメーター

フラグ	デフォルト	選択肢
--geo	US	任意の2文字の国コード：US、BR、ID、GB、JP、IN、DE、FR、AU、MX、...
--category	all	all、games、technology、sports、entertainment、business、health、science、food、travel、beauty、politics、shopping
--hours	24	4、24、48、168（7日間）
--top	20	任意の整数
--method	auto	rss（高速、カテゴリフィルターなし）、csv（Selenium、カテゴリに対応）

自動メソッドのロジック： --category all の場合は rss を使用し、特定のカテゴリが指定された場合は csv を使用します。

国コード一覧

国	コード	国	コード
ブラジル	BR	インドネシア	ID
米国	US	インド	IN
英国	GB	日本	JP
ドイツ	DE	フランス	FR
オーストラリア	AU	メキシコ	MX
カナダ	CA	韓国	KR
アルゼンチン	AR	ナイジェリア	NG
フィリピン	PH	タイ	TH

スクリプトの実行

重要： 必ず run.py ラッパーを使用してください。仮想環境のセットアップが自動的に行われます。

基本的な使い方（一般的なトレンド、高速）

python scripts/run.py --geo BR

カテゴリを指定したトレンド（Seleniumを使用）

python scripts/run.py --geo BR --category games
python scripts/run.py --geo ID --category technology
python scripts/run.py --geo US --category sports --hours 48

複数の国（並列実行）

python scripts/run.py --geo BR --category games &
python scripts/run.py --geo ID --category games &
wait

期間を長くして上位 N 件を取得

python scripts/run.py --geo JP --category entertainment --hours 168 --top 30

ワークフロー

1. ユーザーの意図を解析 → 国、カテゴリ、期間を抽出します
2. パラメーターに対応付けます：
   • 「Brazil」→ --geo BR
   • 「Indonesia」→ --geo ID
   • 「games」→ --category games
   • 「AI/tech/technology」→ --category technology
   • 「過去1週間」／「7日間」→ --hours 168
3. ユーザーに伝えます：「[国]の[カテゴリ]のトレンドを取得しています（過去[N]時間）...」
4. スクリプトを実行し、JSON 出力を解析します
5. **結果を提示します：**順位、トレンド名、検索ボリュームを含む書式設定済みの表にします

出力形式

スクリプトは JSON を出力します：

{
  "geo": "BR",
  "category": "games",
  "hours": 24,
  "method": "csv",
  "count": 20,
  "trends": [
    {"rank": 1, "trend": "grêmio x internacional", "volume": "500K+", "started": "..."},
    {"rank": 2, "trend": "arsenal x chelsea", "volume": "500K+", "started": "..."}
  ]
}

結果の提示

出力は、見やすい Markdown 表に整形します：

## 🔥 Trending in Brazil — Games (past 24h)

| # | Trend | Volume |
|---|-------|--------|
| 1 | grêmio x internacional | 500K+ |
| 2 | arsenal x chelsea | 500K+ |
...

関連する場合は、表の後に簡単な背景情報や分析を加えます（例：「ブラジルの急上昇中のゲームではサッカーが圧倒的です。グレミオとインテルナシオナルの間で行われたGrenalダービーが、検索数の最大の急増につながりました。」）。

エラー処理

エラー	対応
BrowserError ／タイムアウト	--method rss で再試行します（カテゴリフィルターは解除されます）
InvalidParameterError	geo コードまたはカテゴリ名を確認します
仮想環境のセットアップ失敗	Python 3.8+ が利用可能か確認します
トレンドが返されない	より広いカテゴリまたは別の期間を試します

トラブルシューティング

• CSS メソッドが遅い：正常です。Selenium が Chrome をヘッドレスモードで起動します
• RSSでカテゴリフィルターが機能しない：RSSはカテゴリに対応していません。--method csv を使用してください
• 結果が空：より広い期間として --hours 168 を試してください
• 国が見つからない：python scripts/run.py --list-countries を実行して、対応するすべてのコードを確認してください