apify-content-analytics

コンテンツ分析

Apify Actors を使用して、複数のプラットフォームからエンゲージメント指標を抽出し、コンテンツのパフォーマンスを追跡・分析します。

前提条件

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

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

ワークフロー

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

Task Progress:
- [ ] Step 1: Identify content analytics type (select Actor)
- [ ] Step 2: Fetch Actor schema
- [ ] Step 3: Ask user preferences (format, filename)
- [ ] Step 4: Run the analytics script
- [ ] Step 5: Summarize findings

ステップ 1：コンテンツ分析の種類を特定する

分析のニーズに応じて、適切な Actor を選択してください。

ユーザーのニーズ	Actor ID	最適な用途
投稿のエンゲージメント指標	apify/instagram-post-scraper	投稿のパフォーマンス
リールのパフォーマンス	apify/instagram-reel-scraper	リールの分析
フォロワーの増加状況の追跡	apify/instagram-followers-count-scraper	成長指標
コメントのエンゲージメント	apify/instagram-comment-scraper	コメント分析
ハッシュタグのパフォーマンス	apify/instagram-hashtag-scraper	ブランドハッシュタグ
メンションの追跡	apify/instagram-tagged-scraper	タグの追跡
包括的な指標	apify/instagram-scraper	全データ
API ベースの分析	apify/instagram-api-scraper	API アクセス
Facebook 投稿のパフォーマンス	apify/facebook-posts-scraper	投稿指標
リアクションの分析	apify/facebook-likes-scraper	エンゲージメントの種類
Facebook リールの指標	apify/facebook-reels-scraper	リールのパフォーマンス
広告パフォーマンスの追跡	apify/facebook-ads-scraper	広告分析
Facebook コメントの分析	apify/facebook-comments-scraper	コメントのエンゲージメント
ページパフォーマンスの監査	apify/facebook-pages-scraper	ページ指標
YouTube 動画の指標	streamers/youtube-scraper	動画のパフォーマンス
YouTube Shorts の分析	streamers/youtube-shorts-scraper	Shorts のパフォーマンス
TikTok コンテンツの指標	clockworks/tiktok-scraper	TikTok の分析

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

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

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

ACTOR_ID を、選択した Actor（例：apify/instagram-post-scraper）に置き換えてください。

次の情報が返されます。

• Actor の情報（タイトル、説明、URL、カテゴリ、統計、評価）
• README の概要
• 入力スキーマ（必須および任意のパラメーター）

ステップ 3：ユーザーの希望を尋ねる

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

大規模なスクレイピングタスクの場合は、次の項目を尋ねてください。

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

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

ステップ 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 - .env に APIFY_TOKEN=your_token を設定して作成するようユーザーに依頼してください
Actor not found - Actor ID のスペルを確認してください
Run FAILED - エラー出力にある Apify コンソールのリンクを確認するようユーザーに依頼してください
Timeout - 入力サイズを小さくするか、--timeout を増やしてください