mcpField
A
apify-trend-analysis

apify-trend-analysis

github.com/apifyマーケティング・グロース285118 回インストール6 週間前に更新
リポジトリ

apify-trend-analysis について

Apify Actorsで複数のプラットフォームからデータを取得し、トレンドを発見・追跡するスキルです。調査内容に応じたActorの選択から実行、結果の要約やCSV・JSON出力まで扱います。

主な機能

  1. 01トレンド別のApify Actor選択
  2. 02Actor入力スキーマの取得
  3. 03件数上限と出力形式の設定
  4. 04データ取得と結果の要約

活用シーン

  1. 01Google Trendsの検索動向の追跡
  2. 02ソーシャルプラットフォームのハッシュタグ分析
  3. 03TikTokの人気サウンドや投稿の調査

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/apify/awesome-skills --skill apify-trend-analysis

インストール後、Claude Code で/apify-trend-analysisを入力して読み込まれたか確認します。

同梱ファイルreference/scripts/run_actor.jsreference/scripts/fetch_actor_details.js

詳細

トレンド分析

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

前提条件

（事前に確認する必要はありません）

  • APIFY_TOKEN を含む .env ファイル
  • Node.js 20.6 以降（ネイティブの --env-file をサポート）

ワークフロー

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

Task Progress:
- [ ] Step 1: Identify trend type (select Actor)
- [ ] Step 2: Fetch Actor schema
- [ ] Step 3: Ask user preferences (format, filename)
- [ ] Step 4: Run the analysis script
- [ ] Step 5: Summarize findings
ステップ 1：トレンドの種類を特定する

調査の目的に応じて、適切な Actor を選択します。

ユーザーのニーズActor ID最適な用途
検索トレンドapify/google-trends-scraperGoogle Trends データ
ハッシュタグの追跡apify/instagram-hashtag-scraperハッシュタグのコンテンツ
ハッシュタグの指標apify/instagram-hashtag-statsパフォーマンス統計
ビジュアルトレンドapify/instagram-post-scraper投稿の分析
トレンドの発見apify/instagram-search-scraper検索トレンド
包括的な追跡apify/instagram-scraper全データ
API ベースのトレンドapify/instagram-api-scraperAPI アクセス
エンゲージメントのトレンドapify/export-instagram-comments-postsコメントの追跡
商品トレンドapify/facebook-marketplace-scraperマーケットプレイスのデータ
ビジュアル分析apify/facebook-photos-scraper写真のトレンド
コミュニティのトレンドapify/facebook-groups-scraperグループのモニタリング
YouTube ショート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広告のトレンド
発見ページclockworks/tiktok-discover-scraper発見ページのトレンド
トレンドを探すclockworks/tiktok-explore-scraper探索コンテンツ
トレンドコンテンツclockworks/tiktok-trends-scraperバイラルコンテンツ
ステップ 2：Actor のスキーマを取得する

Actor の入力スキーマと詳細を取得します。

node --env-file=.env ${CLAUDE_PLUGIN_ROOT}/reference/scripts/fetch_actor_details.js --actor "ACTOR_ID"

選択した Actor（例：apify/google-trends-scraper）で ACTOR_ID を置き換えます。

次の情報が返されます。

  • Actor の情報（タイトル、説明、URL、カテゴリ、統計、評価）
  • README の概要
  • 入力スキーマ（必須および任意のパラメーター）
ステップ 3：ユーザーの希望を確認する

簡単な検索（例：「Nike のフォロワー数は？」「プラハのコーヒーショップを 5 軒探して」）では、このステップを省略して、クイック回答モードを使用し、ステップ 4 に進みます。

大規模なスクレイピングタスクでは、次の項目を確認します。

  1. 出力形式：
    • クイック回答 - 上位数件の結果をチャットに表示（ファイルは保存しません）
    • CSV - すべてのフィールドを含む完全なエクスポート
    • JSON - JSON 形式で完全にエクスポート
  2. 結果数：ユースケースの性質に応じて決定します

コストの安全対策：Actor の入力では、常識的な結果数の上限を必ず設定してください（例：maxResults、resultsLimit、maxCrawledPages、または入力スキーマ内の同等のフィールド）。ユーザーが明示的にそれ以上を求めない限り、結果数は 100 件を既定とします。大量のスクレイピング（1000 件以上）を実行する前に、Apify クレジットをより多く消費することをユーザーに警告してください。

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

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

node --env-file=.env ${CLAUDE_PLUGIN_ROOT}/reference/scripts/run_actor.js \
  --actor "ACTOR_ID" \
  --input 'JSON_INPUT'

CSV：

node --env-file=.env ${CLAUDE_PLUGIN_ROOT}/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 ${CLAUDE_PLUGIN_ROOT}/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 を作成するよう依頼します
Actor not found - Actor ID のつづりを確認します
Run FAILED - エラー出力の Apify コンソールへのリンクを確認するようユーザーに依頼します
Timeout - 入力サイズを小さくするか、--timeout を増やします

コメント

Markdown 対応