apify-brand-reputation-monitoring について
Apify Actorsを使って複数プラットフォームのレビュー、評価、ブランドへの言及を収集する監視スキルです。ブランドの評判を把握したいチーム向けに、データソースに合うActorを選び、結果を確認・出力できます。
主な機能
- 01データソースに応じたApify Actorの選択
- 02Actor入力スキーマの動的取得
- 03監視の実行と結果の要約
- 04結果の表示またはCSV・JSON出力
活用シーン
- 01Google Mapsの事業者レビューと評価の収集
- 02ソーシャルプラットフォームでのブランド言及の監視
- 03ホテル・観光地・飲食店レビューの収集
MCP 対応
mcpcでmcp.apify.comに接続し、選択したActorの詳細と入力スキーマを取得します。その情報を使ってApify Actorを実行します。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ apify/ agent-skills --skill apify-brand-reputation-monitoringインストール後、Claude Code で/apify-brand-reputation-monitoringを入力して読み込まれたか確認します。
同梱ファイルreference/scripts/run_actor.js
詳細
ブランドレピュテーションのモニタリング
Apify Actors を使用して、複数のプラットフォームからレビュー、評価、ブランドへの言及をスクレイピングします。
前提条件
(事前に確認する必要はありません)
APIFY_TOKENを含む.envファイル- Node.js 20.6+(ネイティブの
--env-fileサポートに必要) mcpcCLI ツール:npm install -g @apify/mcpc
ワークフロー
このチェックリストをコピーして、進捗を記録してください:
Task Progress:
- [ ] Step 1: Determine data source (select Actor)
- [ ] Step 2: Fetch Actor schema via mcpc
- [ ] Step 3: Ask user preferences (format, filename)
- [ ] Step 4: Run the monitoring script
- [ ] Step 5: Summarize results
ステップ 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 のセンチメント |
ステップ 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:ユーザーの希望を確認する
実行する前に、次の項目を確認します:
- 出力形式:
- 簡易回答 - チャットに上位数件の結果を表示(ファイルは保存しません)
- CSV - すべてのフィールドを含む完全なエクスポート
- JSON - JSON 形式での完全なエクスポート
- 結果の件数:ユースケースの性質に応じて決定します
ステップ 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 を作成するようユーザーに依頼します
mcpc not found - npm install -g @apify/mcpc をインストールするようユーザーに依頼します
Actor not found - Actor ID のスペルを確認します
Run FAILED - エラー出力にある Apify コンソールのリンクを確認するようユーザーに依頼します
Timeout - 入力サイズを小さくするか、--timeout を大きくします