apify-trend-analysis

トレンド分析

Apify Actors を使用して複数のプラットフォームからデータを抽出し、新たなトレンドを発見して追跡します。

前提条件

有料実行の前に、前提条件を確認してください。

• APIFY_TOKEN を含む .env ファイル
• Node.js 20.6 以降（ネイティブの --env-file サポートに必要）
• 選択した Actor とそのスキーマを確認できる、承認済みの Apify コネクターまたは Console へのアクセス。付属のランナーは REST を直接使用します。
• .env を Git の追跡対象にせず、非公開にしてください。チャットやコマンド引数にトークンを貼り付けず、ローカルで設定してください。

ワークフロー

このチェックリストをコピーして、進捗を記録してください。

Task Progress:
- [ ] Step 1: Identify trend type (select Actor)
- [ ] Step 2: Fetch Actor schema via an approved connector or Console
- [ ] Step 3: Ask user preferences (format, filename)
- [ ] Step 4: Run the analysis script
- [ ] Step 5: Summarize findings

ステップ 1：トレンドの種類を特定する

調査のニーズに基づいて、適切な Actor を選択してください。

ユーザーのニーズ	Actor ID	最適な用途
検索トレンド	apify/google-trends-scraper	Google Trends データ
ハッシュタグの追跡	apify/instagram-hashtag-scraper	ハッシュタグのコンテンツ
ハッシュタグの指標	apify/instagram-hashtag-stats	パフォーマンス統計
ビジュアルトレンド	apify/instagram-post-scraper	投稿の分析
トレンドの発見	apify/instagram-search-scraper	検索トレンド
包括的な追跡	apify/instagram-scraper	全データ
API ベースのトレンド	apify/instagram-api-scraper	API アクセス
エンゲージメントのトレンド	apify/export-instagram-comments-posts	コメントの追跡
商品トレンド	apify/facebook-marketplace-scraper	マーケットプレイスのデータ
ビジュアル分析	apify/facebook-photos-scraper	写真のトレンド
コミュニティのトレンド	apify/facebook-groups-scraper	グループのモニタリング
YouTube Shorts	streamers/youtube-shorts-scraper	ショート動画のトレンド
YouTube のハッシュタグ	streamers/youtube-video-scraper-by-hashtag	ハッシュタグ付き動画
TikTok のハッシュタグ	clockworks/tiktok-hashtag-scraper	ハッシュタグのコンテンツ
トレンドの音源	clockworks/tiktok-sound-scraper	音声のトレンド
TikTok 広告	clockworks/tiktok-ads-scraper	広告のトレンド
Discover ページ	clockworks/tiktok-discover-scraper	Discover のトレンド
Explore のトレンド	clockworks/tiktok-explore-scraper	Explore のコンテンツ
トレンドのコンテンツ	clockworks/tiktok-trends-scraper	バイラルコンテンツ

ステップ 2：Actor のスキーマを取得する

セッションで利用可能な認証済み Apify コネクター、またはその Console ページを使用して、現在の Actor の詳細と入力スキーマを確認してください。呼び出す前に、実際のツール名とパラメーターを調べてください。シェルの置換で .env を解析したり、CLI のヘッダー引数としてトークンを渡したりしないでください。Actor の表は候補を見つけるためのものであり、利用可能性やスキーマが確認済みであることを示すものではありません。

次の情報が返されます。

• Actor の説明と README
• 必須および任意の入力パラメーター
• 出力フィールド（利用可能な場合）

ステップ 3：ユーザーの希望を確認する

実行前に、次の項目を確認してください。

1. 出力形式：
   • 簡易回答 - 上位の結果を数件、チャットに表示します（ファイルは保存しません）
   • CSV - 返されたフィールドの和集合を使用した、上限付きのエクスポート
   • JSON - JSON 形式での上限付きエクスポート
2. 結果の件数：ユースケースの性質に応じて決定します

ステップ 4：スクリプトを実行する

簡易回答（チャットに表示、ファイルなし）：

node --env-file=.env "<resolved-skill-directory>/reference/scripts/run_actor.js" \
  --actor "ACTOR_ID" \
  --input 'JSON_INPUT'

CSV：

node --env-file=.env "<resolved-skill-directory>/reference/scripts/run_actor.js" \
  --actor "ACTOR_ID" \
  --input 'JSON_INPUT' \
  --output YYYY-MM-DD_OUTPUT_FILE.csv \
  --format csv

JSON：

node --env-file=.env "<resolved-skill-directory>/reference/scripts/run_actor.js" \
  --actor "ACTOR_ID" \
  --input 'JSON_INPUT' \
  --output YYYY-MM-DD_OUTPUT_FILE.json \
  --format json

ステップ 5：調査結果を要約する

完了後、次の内容を報告してください。

• 見つかった結果の件数
• ファイルの場所と名前
• 主なトレンドの分析結果
• 次のステップの提案（より詳しい分析、コンテンツの機会など）

エラー処理

APIFY_TOKEN not found - APIFY_TOKEN=your_token を設定した .env を作成するようユーザーに依頼してください Connector unavailable - Console からスキーマを確認してください。利用できないツールを呼び出したと主張しないでください。 Actor not found - Actor ID のスペルを確認してください Run FAILED - エラー出力にある Apify Console のリンクを確認するようユーザーに依頼してください Timeout - ローカルのタイムアウトではリモートの実行は中断されません。重複課金を避けるため、再試行する前に Console で表示された実行 ID を確認してください。

実行範囲

実行前に、選択した Actor、許可された公開データの範囲、現在の入力スキーマ、結果の上限、料金をユーザーの依頼内容と照らして確認します。データソースの利用規約とアクセス制御を遵守し、非公開グループのデータや不要な個人の連絡先情報を収集しないでください。まずは Actor がサポートする入力上限を小さく設定して実行してください。--max-items が制限するのはダウンロードする出力のみです（既定値は1000）。Actor の処理量や請求額には上限を設けません。このヘルパーは、スキルを識別する User-Agent を Apify に送信します。コマンド内のプレースホルダーでは、インストール済みのスキルディレクトリを指定してください。出力ファイルには新しいパスを指定してください。エクスポートでは、長い値や不均一なフィールドが保持されます。簡易的な回答では、取得するレコードを最大5件にし、共有前に個人情報に関するフィールドを最小限にするか、伏せてください。

使用する場面

定義された期間や地域における検索関心度、公開ハッシュタグ、音源、コンテンツを比較する場合に使用します。正規化されたトレンド指数と、絶対的な視聴者数や販売数を区別し、収集日、サンプルの偏り、プラットフォームの対象範囲を明記してください。

制限事項

• 上記の説明にある範囲にタスクが明確に一致する場合にのみ、このスキルを使用してください。
• 出力を、環境固有の検証、テスト、または専門家によるレビューの代わりとして扱わないでください。
• 必要な入力、権限、安全上の境界、または成功基準が不足している場合は、作業を中断して確認してください。