apify-brand-reputation-monitoring

ブランドの評判モニタリング

Apify Actors を使用して、複数のプラットフォームからレビュー、評価、ブランドへの言及をスクレイピングします。

前提条件

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

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

ワークフロー

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

Task Progress:
- [ ] Step 1: Determine data source (select Actor)
- [ ] Step 2: Fetch Actor schema
- [ ] Step 3: Ask user preferences (format, filename)
- [ ] Step 4: Run the monitoring script
- [ ] Step 5: Summarize results

Step 1: データソースを決定する

ユーザーのニーズに基づいて、適切な Actor を選択します。

ユーザーのニーズ	Actor ID	最適な用途
Google Maps のレビュー	compass/crawler-google-places	ビジネスのレビュー、評価
Google Maps のレビューのエクスポート	compass/Google-Maps-Reviews-Scraper	レビューの専用スクレイピング
Booking.com のホテル	voyager/booking-scraper	ホテルデータ、スコア
Booking.com のレビュー	voyager/booking-reviews-scraper	詳細なホテルレビュー
TripAdvisor のレビュー	maxcopell/tripadvisor-reviews	観光名所・レストランのレビュー
Facebook のレビュー	apify/facebook-reviews-scraper	ページのレビュー
Facebook のコメント	apify/facebook-comments-scraper	投稿コメントのモニタリング
Facebook ページの指標	apify/facebook-pages-scraper	ページ評価の概要
Facebook のリアクション	apify/facebook-likes-scraper	リアクションの種類の分析
Instagram のコメント	apify/instagram-comment-scraper	コメントのセンチメント
Instagram のハッシュタグ	apify/instagram-hashtag-scraper	ブランドハッシュタグのモニタリング
Instagram の検索	apify/instagram-search-scraper	ブランドへの言及の発見
Instagram のタグ付けされた投稿	apify/instagram-tagged-scraper	ブランドタグの追跡
Instagram のエクスポート	apify/export-instagram-comments-posts	コメントの一括エクスポート
Instagram の包括的なモニタリング	apify/instagram-scraper	Instagram の全般的なモニタリング
Instagram API	apify/instagram-api-scraper	API ベースのモニタリング
YouTube のコメント	streamers/youtube-comments-scraper	動画コメントのセンチメント
TikTok のコメント	clockworks/tiktok-comments-scraper	TikTok のセンチメント

Step 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 の概要
• 入力スキーマ（必須および任意のパラメーター）

Step 3: ユーザーの希望を確認する

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

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

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

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

Step 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

Step 5: 結果を要約する

完了後、次の内容を報告します。

• 見つかったレビュー・言及の件数
• ファイルの場所と名前
• 利用可能な主なフィールド
• 次のステップの提案（センチメント分析、フィルタリング）

エラー処理

APIFY_TOKEN not found - APIFY_TOKEN=your_token を含む .env を作成するようユーザーに依頼します Actor not found - Actor ID のスペルを確認します Run FAILED - エラー出力にある Apify コンソールへのリンクを確認するようユーザーに依頼します Timeout - 入力サイズを小さくするか、--timeout を大きくします