mcpField
A
apify-brand-reputation-monitoring

apify-brand-reputation-monitoring

github.com/apifyマーケティング・グロース2.5k2.5k 回インストール1 週間前に更新
リポジトリ

apify-brand-reputation-monitoring について

Apify Actorsを使って複数プラットフォームのレビュー、評価、ブランドへの言及を収集する監視スキルです。ブランドの評判を把握したいチーム向けに、データソースに合うActorを選び、結果を確認・出力できます。

主な機能

  1. 01データソースに応じたApify Actorの選択
  2. 02Actor入力スキーマの動的取得
  3. 03監視の実行と結果の要約
  4. 04結果の表示またはCSV・JSON出力

活用シーン

  1. 01Google Mapsの事業者レビューと評価の収集
  2. 02ソーシャルプラットフォームでのブランド言及の監視
  3. 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 サポートに必要)
  • mcpc CLI ツール: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-scraperInstagram 全体のモニタリング
Instagram APIapify/instagram-api-scraperAPI ベースのモニタリング
YouTube のコメントstreamers/youtube-comments-scraper動画コメントのセンチメント
TikTok のコメントclockworks/tiktok-comments-scraperTikTok のセンチメント
ステップ 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 - APIFY_TOKEN=your_token を含む .env を作成するようユーザーに依頼します mcpc not found - npm install -g @apify/mcpc をインストールするようユーザーに依頼します Actor not found - Actor ID のスペルを確認します Run FAILED - エラー出力にある Apify コンソールのリンクを確認するようユーザーに依頼します Timeout - 入力サイズを小さくするか、--timeout を大きくします

コメント