apify-brand-reputation-monitoring

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

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

使用する場面

• ソーシャル、旅行、地図のプラットフォーム全体でレビュー、評価、ブランドへの言及をモニタリングする必要がある場合。
• ブランドのセンチメントや評判の追跡に適した Apify Actor を選択して実行する場合。
• エクスポートしたモニタリング結果と、評判に関するシグナルの概要が必要な場合。

前提条件

有料実行の前に、前提条件を確認してください。

• APIFY_TOKEN を含む .env ファイル
• Node.js 20.6 以降（ネイティブの --env-file サポートに必要）
• 選択した Actor とそのスキーマを確認するための、承認済み Apify コネクターまたは Console へのアクセス。付属のランナーは REST を直接使用します。
• .env は追跡対象にせず、非公開にしてください。トークンはローカルで設定し、チャットやコマンド引数に貼り付けないでください。

ワークフロー

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

Task Progress:
- [ ] Step 1: Determine data source (select Actor)
- [ ] Step 2: Fetch Actor schema via an approved connector or Console
- [ ] 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 のスキーマを取得する

セッションで利用可能な認証済み Apify コネクター、または Console ページを使用して、現在の Actor の詳細と入力スキーマを確認します。呼び出す前に、実際のツール名とパラメーターを特定してください。.env をシェルの置換で解析したり、トークンを CLI ヘッダー引数として渡したりしないでください。Actor の一覧は候補を見つけるためのものであり、利用可能性やスキーマが検証済みであることを示すものではありません。

以下が返されます：

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

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

実行前に、以下を尋ねてください：

1. 出力形式：
   • 簡易回答 - 上位数件の結果をチャットに表示します（ファイルは保存しません）
   • CSV - 件数を制限してエクスポートします。返されたフィールドの和集合を使用します
   • JSON - 件数を制限して JSON 形式でエクスポートします
2. 結果の件数：ユースケースに応じて決定します

ステップ 4：スクリプトを実行する

簡易回答（チャットに表示、ファイルなし）：

node --env-file=.env "<resolved-skill-directory>/reference/scripts/run_actor.js" \
  --actor "ACTOR_ID" \
  --input 'JSON_INPUT'

CSV：

node --env-file=.env "<resolved-skill-directory>/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 "<resolved-skill-directory>/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 を設定するよう依頼します Connector unavailable - Console でスキーマを確認します。利用できないツールを呼び出したと主張してはいけません。 Actor not found - Actor ID のスペルを確認します Run FAILED - エラー出力にある Apify コンソールのリンクを確認するようユーザーに依頼します Timeout - ローカルのタイムアウトではリモートの実行は中止されません。重複課金を避けるため、再試行する前に Console で出力された実行 ID を確認します。

実行の境界

起動する前に、選択した Actor、許可された公開データの範囲、現在の入力スキーマ、結果の上限、料金について、ユーザーの依頼内容に照らして確認します。データソースの利用規約とアクセス制御を尊重し、非公開グループのデータや不要な個人の連絡先情報を収集しないでください。まずは Actor がサポートする入力上限を小さく設定します。--max-items はダウンロードする出力のみを制限します（デフォルトは 1000）。Actor の処理量や課金は制限しません。ヘルパーは Apify にスキルを識別する User-Agent を送信します。コマンドのプレースホルダーには、インストール済みのスキルディレクトリを設定してください。出力ファイルには新しいパスを指定します。エクスポートでは、長い値や異種フィールドが保持されます。簡単な回答では最大 5 件のレコードを取得します。共有する前に、個人情報を最小限にするか、伏せてください。

レビューはプラットフォームと安定した ID で重複を排除し、評価尺度と取得時刻を記録します。また、ソース上の評価と推定された感情を区別します。対象範囲と尺度の定義がなければ、異なるプラットフォームの件数は比較できません。否定的、中立、不確実なケースを保持します。傾向を判定する前に、少数のデータを人が確認し、言語や皮肉の扱いを検証してください。1 回のスクレイピングで得られるのはスナップショットであり、継続的な監視ではありません。スケジュール設定や通知には、実際に設定済みのサービスと、許可された送信先が必要です。データ収集の一環として返信を投稿したり、レビュー投稿者に連絡したり、コンテンツを削除したりしないでください。

制限事項

• このスキルは、タスクが上記の説明にある範囲に明確に合致する場合にのみ使用してください。
• 出力を、環境固有の検証、テスト、専門家によるレビューの代わりとして扱わないでください。
• 必要な入力、権限、安全上の境界、または成功基準が不足している場合は、作業を中断して確認を求めてください。