apify-content-analytics について
Apify Actorsを使って複数プラットフォームのコンテンツ反応を収集・分析するスキルです。投稿、動画、広告、ハッシュタグの評価に向け、Actorの選定、スキーマ確認、結果の出力と解釈を支援します。
主な機能
- 01分析目的に応じたApify Actorの選択
- 02Actor入力スキーマの確認
- 03分析の実行とCSVまたはJSON出力
- 04コンテンツの実績と要点の整理
- 05データ範囲と課金上の注意の提示
活用シーン
- 01Instagram投稿やReelsの反応比較
- 02Facebook広告や投稿の実績追跡
- 03YouTubeやTikTokのコンテンツ指標分析
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/apify-content-analyticsを入力して読み込まれたか確認します。
同梱ファイルreference/scripts/run_actor.js
詳細
コンテンツ分析
Apify Actors を使用して、複数のプラットフォームからエンゲージメント指標を抽出し、コンテンツのパフォーマンスを追跡・分析します。
使用する場面
- 投稿、リール、動画、広告、ハッシュタグのエンゲージメント、成長、ROI 指標が必要な場合。
- Apify Actors を使用して、複数のプラットフォームにまたがるコンテンツのパフォーマンスデータを収集する場合。
- エクスポートした分析結果と、どのコンテンツのパフォーマンスが最も高いかを簡潔にまとめた解説が必要な場合。
前提条件
有料実行の前に、前提条件を確認してください。
APIFY_TOKENを設定した.envファイル- Node.js 20.6 以降（ネイティブの
--env-fileサポートが必要です） - 選択した Actor とそのスキーマを確認するための、承認済み Apify コネクターまたは Console へのアクセス権。付属のランナーは REST を直接使用します。
.envは追跡対象から除外し、非公開にしてください。トークンはローカルで設定し、チャットやコマンド引数に貼り付けないでください。
ワークフロー
このチェックリストをコピーして、進捗を記録してください。
Task Progress:
- [ ] Step 1: Identify content analytics 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 analytics script
- [ ] Step 5: Summarize findings
ステップ 1：コンテンツ分析の種類を特定する
分析のニーズに応じて、適切な Actor を選択してください。
| ユーザーのニーズ | Actor ID | 最適な用途 |
|---|---|---|
| 投稿のエンゲージメント指標 | apify/instagram-post-scraper | 投稿のパフォーマンス |
| リールのパフォーマンス | apify/instagram-reel-scraper | リールの分析 |
| フォロワー増加の追跡 | apify/instagram-followers-count-scraper | 成長指標 |
| コメントのエンゲージメント | apify/instagram-comment-scraper | コメント分析 |
| ハッシュタグのパフォーマンス | apify/instagram-hashtag-scraper | ブランドハッシュタグ |
| メンションの追跡 | apify/instagram-tagged-scraper | タグの追跡 |
| 包括的な指標 | apify/instagram-scraper | 全データ |
| API ベースの分析 | apify/instagram-api-scraper | API アクセス |
| Facebook 投稿のパフォーマンス | apify/facebook-posts-scraper | 投稿の指標 |
| リアクション分析 | apify/facebook-likes-scraper | エンゲージメントの種類 |
| Facebook リールの指標 | apify/facebook-reels-scraper | リールのパフォーマンス |
| 広告パフォーマンスの追跡 | apify/facebook-ads-scraper | 広告の分析 |
| Facebook コメントの分析 | apify/facebook-comments-scraper | コメントのエンゲージメント |
| ページのパフォーマンス監査 | apify/facebook-pages-scraper | ページの指標 |
| YouTube 動画の指標 | streamers/youtube-scraper | 動画のパフォーマンス |
| YouTube ショートの分析 | streamers/youtube-shorts-scraper | ショート動画のパフォーマンス |
| TikTok コンテンツの指標 | clockworks/tiktok-scraper | TikTok の分析 |
ステップ 2：Actor スキーマを取得する
セッションで利用できる認証済み Apify コネクター、またはその Console ページを使用して、現在の Actor の詳細と入力スキーマを確認してください。呼び出す前に、実際のツール名とパラメーターを確認してください。シェル置換を使って .env を解析したり、CLI のヘッダー引数にトークンを渡したりしないでください。Actor の一覧は候補を見つけるためのものであり、利用可能性やスキーマが確認済みであることを示すものではありません。
次の情報が返されます。
- Actor の説明と README
- 必須および任意の入力パラメーター
- 出力フィールド（利用可能な場合）
ステップ 3：ユーザーの希望を確認する
実行前に、次の項目を確認してください。
- 出力形式：
- クイック回答 - 上位の結果をいくつかチャットに表示（ファイルは保存しない）
- CSV - 取得したフィールドを統合した、件数を制限したエクスポート
- JSON - JSON 形式での、件数を制限したエクスポート
- 結果の件数：ユースケースに応じて決定します
ステップ 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 件です。共有する前に、個人情報を最小限にするか、マスキングしてください。
公開されているエンゲージメント数だけでは、キャンペーンの ROI、支出、収益の帰属、インプレッション数、ユニークリーチを確認できません。許可されたファーストパーティデータが提供されない限り、これらは利用できない情報として報告します。エンゲージメント率の分母、観測期間、収集時刻を明示します。同じ形式やプラットフォームの指標同士を比較し、欠損値とゼロを区別して保持し、安定したコンテンツ ID を使って重複を排除します。フォロワー数の増加を把握するには、タイムスタンプ付きの観測を繰り返す必要があります。プロフィールのスナップショットが 1 件だけでは増加を算出できません。
制限事項
- 上記で説明した範囲にタスクが明確に該当する場合にのみ、このスキルを使用してください。
- 出力を、環境固有の検証、テスト、または専門家によるレビューの代替として扱わないでください。
- 必要な入力、権限、安全上の境界、または成功基準が不足している場合は、作業を中断して確認を求めてください。