apify-audience-analysis

オーディエンス分析

Apify Actors を使用して、複数のプラットフォームからフォロワーの属性、エンゲージメントの傾向、行動データを抽出し、オーディエンスを分析して理解します。

使用する場面

• ソーシャルプラットフォームから、オーディエンスの属性、エンゲージメントの傾向、またはフォロワーの行動を把握する必要がある場合。
• Facebook、Instagram、YouTube、または TikTok のオーディエンス分析に適した Apify Actors を選択して実行する場合。
• データを構造化して抽出し、オーディエンスの分析結果を要約して解釈する必要がある場合。

前提条件

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

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

ワークフロー

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

Task Progress:
- [ ] Step 1: Identify market research type (select Actor)
- [ ] Step 2: Fetch Actor schema via an approved connector or Console
- [ ] Step 3: Ask user preferences (format, filename)
- [ ] Step 4: Run the analysis script
- [ ] Step 5: Summarize findings

ステップ 1：オーディエンス分析の種類を特定する

分析のニーズに応じて、適切な Actor を選択してください。

ユーザーのニーズ	Actor ID	最適な用途
Facebook のフォロワー属性	apify/facebook-followers-following-scraper	FB のフォロワー／フォロー中リスト
Facebook のエンゲージメント行動	apify/facebook-likes-scraper	FB 投稿の「いいね」分析
Facebook 動画のオーディエンス	apify/facebook-reels-scraper	FB Reels の視聴者
Facebook のコメント分析	apify/facebook-comments-scraper	FB 投稿／動画のコメント
Facebook コンテンツのエンゲージメント	apify/facebook-posts-scraper	FB 投稿のエンゲージメント指標
Instagram のオーディエンス規模	apify/instagram-profile-scraper	IG プロフィールの属性
Instagram の位置情報ベース分析	apify/instagram-search-scraper	IG の位置情報タグ付きオーディエンス
Instagram のタグ付けネットワーク	apify/instagram-tagged-scraper	IG のタグ付けネットワーク分析
Instagram の包括的分析	apify/instagram-scraper	IG のオーディエンスデータ全般
Instagram API ベースの分析	apify/instagram-api-scraper	IG API アクセス
Instagram のフォロワー数	apify/instagram-followers-count-scraper	IG のフォロワー追跡
Instagram コメントのエクスポート	apify/export-instagram-comments-posts	IG コメントの一括エクスポート
Instagram のコメント分析	apify/instagram-comment-scraper	IG コメントのセンチメント
YouTube 視聴者のフィードバック	streamers/youtube-comments-scraper	YT コメント分析
YouTube チャンネルのオーディエンス	streamers/youtube-channel-scraper	YT チャンネル登録者
TikTok のフォロワー属性	clockworks/tiktok-followers-scraper	TT フォロワーリスト
TikTok プロフィール分析	clockworks/tiktok-profile-scraper	TT プロフィールの属性
TikTok のコメント分析	clockworks/tiktok-comments-scraper	TT コメントのエンゲージメント

ステップ 2：Actor スキーマを取得する

セッションで利用できる認証済み Apify コネクター、または Actor の 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 の処理量や課金には上限を設定しません。このヘルパーは、スキルを識別する User-Agent を Apify に送信します。コマンドのプレースホルダー内にあるインストール済みスキルのディレクトリを解決してください。出力ファイルには新しいパスを指定する必要があります。エクスポートでは、長い値や異種のフィールドが保持されます。簡潔な回答では最大 5 件のレコードを取得し、共有する前に個人情報を最小限にするか、伏せ字にしてください。

制限事項

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

オーディエンス推定の制限

公開されているフォロワー数、コメント、プロフィール数は部分的なサンプルであり、検証済みの閲覧者層の属性ではありません。名前、写真、ハンドルからセンシティブな特性を推測してはいけません。観測されたインタラクションと、個人の実数、ボット、実際のリーチを区別してください。セグメントを比較する前に、プラットフォーム、対象期間、欠損フィールド、サンプルの分母、カバレッジを報告してください。少人数の特定可能なグループは集計し、結果から除外してください。