google-trends

Google Trends

バンドルされているスクリプトを使って、Google Trends のデータを取得します。API キーは不要です。

クイックスタート

スキルディレクトリからスクリプトを実行します。

node scripts/trends.mjs <command> [options]

利用可能なコマンド

コマンド	説明
daily-trends	日次の急上昇検索トピックを取得します
realtime-trends	リアルタイムの急上昇トピックを取得します
autocomplete	キーワードのオートコンプリート候補を取得します
explore	キーワードのトレンドデータを調べます
interest-by-region	地域別の検索インタレストの内訳を取得します
related-topics	キーワードに関連するトピックを取得します
related-queries	キーワードに関連する検索クエリを取得します

使用例

米国の日次急上昇トピック：

node scripts/trends.mjs daily-trends --geo US

リアルタイムのトレンド（過去 4 時間）：

node scripts/trends.mjs realtime-trends --geo US --hours 4

オートコンプリート候補：

node scripts/trends.mjs autocomplete "artificial intelligence"

キーワードを調べる：

node scripts/trends.mjs explore "machine learning" --geo US --time "now 7-d"

地域別のインタレスト：

node scripts/trends.mjs interest-by-region "bitcoin" --geo US --resolution REGION

関連トピック：

node scripts/trends.mjs related-topics "python programming" --geo US

関連クエリ：

node scripts/trends.mjs related-queries "python programming" --geo US

オプションのリファレンス

各コマンドのオプションの詳細は、reference.md を参照してください。

出力

すべてのコマンドは JSON を標準出力に出力します。出力を解析して、ユーザーに必要なデータを抽出してください。状況に応じて、読みやすい形式（表、リスト、要約）で結果を提示してください。

エラー処理

Google によってリクエストがレート制限された場合、スクリプトは指数バックオフを使って再試行します（最大 3 回）。それでも失敗する場合は、ユーザーにその旨を伝え、時間をおいてから再試行するよう提案してください。