apify-competitor-intelligence

競合インテリジェンス

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

前提条件

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

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

ワークフロー

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

Task Progress:
- [ ] Step 1: Identify competitor analysis 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	最適な用途
競合他社のビジネスデータ	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 のスキーマを取得する

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

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

ACTOR_ID を選択した Actor（例：compass/crawler-google-places）に置き換えます。

取得できる情報：

• 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 を増やしてください