apify-competitor-intelligence

競合情報

Apify Actors を使用して、複数のプラットフォームからデータを抽出し、競合他社を分析します。

前提条件

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

• APIFY_TOKEN を含む .env ファイル
• Node.js 20.6+（ネイティブの --env-file をサポート）
• mcpc CLI ツール：npm install -g @apify/mcpc

ワークフロー

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

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

ステップ 1：競合分析の種類を特定する

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

ユーザーのニーズ	Actor ID	最適な用途
競合他社のビジネスデータ	compass/crawler-google-places	立地分析
競合他社の連絡先の特定	poidata/google-maps-email-extractor	メールアドレスの抽出
機能のベンチマーキング	compass/google-maps-extractor	詳細なビジネスデータ
競合他社のレビュー分析	compass/Google-Maps-Reviews-Scraper	レビューの比較
ホテルの競合データ	voyager/booking-scraper	ホテルのベンチマーキング
ホテルのレビュー比較	voyager/booking-reviews-scraper	レビュー分析
競合他社の広告戦略	apify/facebook-ads-scraper	広告クリエイティブ分析
競合他社のページ指標	apify/facebook-pages-scraper	ページのパフォーマンス
競合他社のコンテンツ分析	apify/facebook-posts-scraper	投稿戦略
競合他社のリールのパフォーマンス	apify/facebook-reels-scraper	リール分析
競合他社のオーディエンス分析	apify/facebook-comments-scraper	コメントの感情分析
競合他社のイベントのモニタリング	apify/facebook-events-scraper	イベント追跡
競合他社のオーディエンスの重複	apify/facebook-followers-following-scraper	フォロワー分析
競合他社のレビューのベンチマーキング	apify/facebook-reviews-scraper	レビューの比較
競合他社の広告のモニタリング	apify/facebook-search-scraper	広告の発見
競合他社のプロフィール指標	apify/instagram-profile-scraper	プロフィール分析
競合他社のコンテンツのモニタリング	apify/instagram-post-scraper	投稿の追跡
競合他社のエンゲージメント分析	apify/instagram-comment-scraper	コメント分析
競合他社のリールのパフォーマンス	apify/instagram-reel-scraper	リール指標
競合他社の成長追跡	apify/instagram-followers-count-scraper	フォロワーの追跡
競合他社の包括的なデータ	apify/instagram-scraper	全般的な分析
API ベースの競合分析	apify/instagram-api-scraper	API アクセス
競合他社の動画分析	streamers/youtube-scraper	動画指標
競合他社の感情分析	streamers/youtube-comments-scraper	コメントの感情分析
競合他社のチャンネル指標	streamers/youtube-channel-scraper	チャンネル分析
TikTok の競合分析	clockworks/tiktok-scraper	TikTok データ
競合他社の動画戦略	clockworks/tiktok-video-scraper	動画分析
競合他社の TikTok プロフィール	clockworks/tiktok-profile-scraper	プロフィールデータ

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

mcpc を使用して Actor の入力スキーマと詳細を動的に取得します。

export $(grep APIFY_TOKEN .env | xargs) && mcpc --json mcp.apify.com --header "Authorization: Bearer $APIFY_TOKEN" tools-call fetch-actor-details actor:="ACTOR_ID" | jq -r ".content"

ACTOR_ID を、選択した Actor（例：compass/crawler-google-places）に置き換えてください。

次の情報が返されます。

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

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

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

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

ステップ 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 を設定するようユーザーに案内してください mcpc not found - npm install -g @apify/mcpc をインストールするようユーザーに案内してください Actor not found - Actor ID のスペルを確認してください Run FAILED - エラー出力に含まれる Apify コンソールへのリンクを確認するようユーザーに案内してください Timeout - 入力サイズを小さくするか、--timeout を大きくしてください