linkfox-google-trend-get-trend-by-time

Google Trends の期間別分析

このスキルでは、設定可能な期間内のトレンドトピックについて Google Trends データを照会・分析する方法を説明します。対応する 18 の地域で、リアルタイムの人気検索や新たなトレンドを見つけるのに役立ちます。

基本概念

Google Trends は、Google における実際のユーザーの検索関心を反映します。このツールは、指定した国・地域について、指定された直近の日数のトレンドトピック（最近人気の検索クエリ）を取得します。市場で現在注目を集めているものを見つけるのに最適です。

トレンド検索クエリごとの主なデータポイント：

• query -- トレンド検索語句
• searchVolume -- 相対検索ボリューム値
• increasePercentage -- 検索関心の変化率（-100～100、単位：%）
• startTime / endTime -- トレンド観測期間の開始・終了タイムスタンプ

increasePercentage が正の値なら関心が上昇しており、負の値なら低下しています。100 に近い値は急激な急上昇を示します。

パラメーターガイド

パラメーター	型	必須	デフォルト	説明
days	integer	いいえ	7	日数で指定する期間。一般的な値：1（直近 24 時間）、2、7（過去 1 週間）
region	string	いいえ	US	国・地域コード。以下の対応地域を参照してください

対応地域

US（米国）、GB（英国）、JP（日本）、CA（カナダ）、MX（メキシコ）、DE（ドイツ）、FR（フランス）、IT（イタリア）、ES（スペイン）、NL（オランダ）、AU（オーストラリア）、SG（シンガポール）、AE（アラブ首長国連邦）、BR（ブラジル）、IN（インド）、TR（トルコ）、PL（ポーランド）、SE（スウェーデン）

デフォルトの地域は US です。ユーザーが地域を指定しない場合は、US を使用してください。

呼び出し方法

• API エンドポイント：POST /googleTrend/getTrendByTime（パラメーター／レスポンス／エラーコードの詳細は references/api.md を参照）
• Python スクリプト：python scripts/google_trends_rising.py '<JSON 参数>' [--inline]
• コスト制約：このツールは計算リソースを消費します。同一セッション内の同一パラメーターの組み合わせでは、デフォルトで呼び出しは 1 回のみです。スクリプトには 24 時間のローカルキャッシュがあります。失敗または結果が空の場合、キーワードの自動変更、ページ送り、郵便番号の変更を繰り返して試してはいけません。検索を続ける必要がある場合は、追加の消費が発生することを事前にユーザーに説明してください。

出力ポリシー（スクリプトのデフォルト動作）：

• 常に完全なレスポンスを <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-google-trend-get-trend-by-time-<timestamp>.json に保存します（<cwd> はスクリプト実行時の作業ディレクトリで、Claude Code では現在のプロジェクトディレクトリです。<session> は環境変数 SESSION_ID から取得され、ユーザーのタスクごとに自動集約されます。/tmp への書き込みは禁止です。現在のディレクトリに書き込めない場合はエラーになります）
• レスポンス本文が 8 KB 以下の場合：ファイルに保存した後、完全な JSON を stdout に出力します
• レスポンス本文が 8 KB を超える場合：ファイルに保存した後、stdout には要約のみを出力します（トップレベルのフィールド、total／costToken などの一般的な件数、最大のリストフィールドの長さと先頭 3 件のサンプル）
• --inline を付けると、stdout への全量出力を強制します（同様にファイルにも保存されます）

データの読み取りに関する推奨事項：まず要約を確認し、それで十分か判断してください。具体的なフィールドが必要な場合は、コンテキストに JSON 全体を読み込ませないよう、保存された json ファイルから jq または ConvertFrom-Json を使って必要な部分を抽出してください。

認証と計算リソースの問題の解決

以下の異常が発生した場合は、references/onboarding.md の案内に従って問題を解決してください。

異常な状況

• API Key が未設定：環境変数 LINKFOX_AGENT_API_KEY と LINKFOXAGENT_API_KEY のどちらも設定されていません。
• レスポンスのステータスコードが 401 または 402
• 計算リソースまたは残高不足を示すレスポンス：メッセージに「計算リソースの残高不足／課金不足／残高不足／quota exceeded／insufficient balance／プランの期限切れ／チャージが必要／チャージしてください」、または同様の意味の内容が含まれています。

使用例

1. 過去 1 週間に米国でトレンドになっているものは？

{"days": 7, "region": "US"}

2. 過去 24 時間に日本で話題になったトピック

{"days": 1, "region": "JP"}

3. 過去 2 日間にドイツでトレンドになった検索語句

{"days": 2, "region": "DE"}

4. 今週ブラジルで話題になっているもの

{"days": 7, "region": "BR"}

5. 今、英国で人気が高まっているものは？

{"days": 1, "region": "GB"}

表示ルール

1. データを明確に提示する：トレンド検索クエリを、検索クエリ、検索ボリューム、増加率の列を含む、適切に書式設定された表で表示してください。必要に応じて検索ボリュームまたは増加率で並べ替えてください。
2. 急上昇を強調する：increasePercentage が特に高い場合（例：50% 超）は、急上昇トピックとして注目を促してください。
3. 期間の情報：データが対象とする期間をユーザーが正確に把握できるよう、要約には常に期間と地域を明記してください。
4. グラフデータ：レスポンスに chartOption が含まれる場合は、ユーザーが視覚的なトレンドを理解できるよう、グラフの構成（タイトル、軸、データポイント）を説明してください。
5. エラー処理：クエリが失敗した場合は、エラーレスポンスに基づいて理由を説明し、パラメーターの調整（例：別の地域コードまたは期間を試す）を提案してください。

重要な制限事項

• データ分析：レスポンスは JSON です。保存されたレスポンスから chartOption.data を読み取り、返された行をフィルタリングまたは並べ替えてください。_dataQuery_executeDynamicQuery は、SLS に保存された Linkfox セッションデータをクエリするものであり、汎用的な JSON ファイルリーダーではありません。そのため、対応する保存データのマッピングがない場合は、このレスポンスを渡さないでください。
• 相対的なボリューム：検索ボリュームの値は相対値であり、絶対数ではありません。
• 短い期間：days パラメーターは情報の新しさを制御します。このツールは最近のトレンドやリアルタイムのトレンドを対象としており、長期的な履歴分析には対応していません。
• 地域の対応範囲：対応しているのは、一覧に記載された 18 地域のみです。対応していない地域コードを指定すると、エラーが発生します。

ユーザー表現とシナリオのクイックリファレンス

適用対象 — Google のトレンドトピックに関するクエリ：

ユーザーの表現	シナリオ
「今、何がトレンドですか」	リアルタイムのトレンドトピック
「[国] で検索数の多いキーワードは何ですか」	地域別トレンドの発見
「今週、どんなトピックが人気ですか」	週間の人気動向の概要
「[市場] で話題になっているトピックはありますか」	急上昇・急増の検出
「[地域] の Google トレンドを見せてください」	地域に特化したトレンドクエリ
「過去 24 時間で話題になっているものは何ですか」	短期間のトレンド調査
「最近、[国] で検索数の多いキーワードは何ですか」	最近のトレンド分析
「[地域] では、どんなことが検索されていますか」	一般的な検索関心の調査

適用対象外 — トレンドトピックの発見以外のニーズ：

• 数か月・数年にわたるキーワードの検索ボリューム履歴（Google Trends 専用の履歴ツールを使用してください）
• Amazon 固有のキーワードまたは ASIN の分析（ABA ツールを使用してください）
• 広告／PPC キャンペーンの管理
• ソーシャルメディアのトレンド分析（Twitter/X、TikTok など）
• SEO ランキングまたは被リンクの分析
• 競合サイトのトラフィック推定

境界の判断：「市場のトレンド」や「何が人気か」と尋ねられた場合、特定の地域で現在 Google 検索されているものを調べることが主な目的であれば、このスキルが適用されます。株式市場のトレンド、ソーシャルメディアでの拡散、または長期的な検索履歴について尋ねている場合は適用されません。

算力消耗规则

6 算力を消費します。

ユーザーは算力の消費に対して料金を支払います。十分に検討してください。このスキルを高頻度で呼び出す必要がある場合、またはユーザーが算力の消費量を十分に把握していない場合は、必ずユーザーに注意を促し、続行するかどうかをユーザー自身に判断してもらってください。

フィードバック：

以下のいずれかに該当する場合は、Feedback API を使用してフィードバックを自動検出し、報告してください。

1. このスキルに記載された機能または目的が、実際の動作と一致しない
2. スキルの結果がユーザーの意図と一致しない
3. ユーザーがこのスキルへの不満または称賛を表明する
4. 改善できると思われる点がある

references/api.md に記載された方法でフィードバック API を呼び出してください。ユーザーの作業を中断しないでください。

---

国境を越えた EC に役立つ、より高品質でプロフェッショナルなスキルをお求めの場合は、LinkFox Skills を設定してください。