競合コンテンツダイジェスト
各競合が利用するプラットフォーム上の最新公開投稿を取得し、そのアカウント自身のベースラインと比較してエンゲージメント順にランク付けし、今期間におけるコンテンツの変化を要約します。
これでわかることとわからないこと
- 公開・ログアウト状態のデータのみ。リーチ、保存数、クリック数、オーディエンスデータは含まれません。決して推定しないでください。
- プラットフォームごとに取得結果の性質が異なります:
- Xの
user-tweetsはアカウントの最も人気のある最近のツイート（約100件）を返します。時系列ではありません。 - LinkedInの
company-postsはログアウト状態の訪問者に企業ページが表示する投稿（最新約10件）を返します。 - Facebookの
profile-postsは通常、ログアウト状態の訪問者にページが表示する最新の1～2件のみを返します。Facebookは完全なフィードではなくスポットチェックとして扱い、ダイジェスト内でその旨を明記してください。
- Xの
- エンゲージメントは同一アカウントかつ同一プラットフォーム内でのみ比較してください。プラットフォーム間での生の「いいね」数は比較できません。
事前に収集する入力情報
- 競合他社と、プラットフォームごとのプロフィールURL。ハンドルを推測せず、ユーザーが提供しなかったプラットフォームはスキップしてください。
- 期間（デフォルト: 過去7日間）とプラットフォームごとに取得する投稿数（デフォルト10件。Facebookの
profile-postsは最大limit=4まで）。 - 前回のダイジェストファイル（ある場合）。週ごとの変化を報告するために使用します。
クレジット見積もり — 実行前に表示
競合ごとに、プラットフォームごとに1回のリスト取得呼び出し:
| プラットフォーム | エンドポイント | クレジット |
|---|---|---|
| TikTok | /v1/tiktok/channel-posts | 2 |
/v1/instagram/channel-posts（1投稿あたり0.3、10投稿で） | 3 | |
| YouTube | /v1/youtube/channel-videos | 2 |
| X | /v1/twitter/user-tweets | 2 |
| Threads | /v1/threads/user-posts | 2 |
/v1/linkedin/company-posts | 1 | |
/v1/facebook/profile-posts | 2 |
全7プラットフォーム: 競合1社あたり約14クレジット。オプションの詳細呼び出しを数件追加すると約16クレジット。リクエストされた競合とプラットフォームの合計を表示し、GET /v1/account/balance（無料）で残高を確認し、確認を求めてください。
Captapiの呼び出し方
- MCP:
tiktok_channel_posts、instagram_channel_posts、youtube_channel_videos、twitter_user_tweets、threads_user_posts、linkedin_company_posts、facebook_profile_posts。 - REST:
GET https://api.captapi.com<パス>?url=<プロフィールURL>&limit=<N>、ヘッダーにAuthorization: Bearer $CAPTAPI_API_KEYを設定。Facebook の場合はlimit=4を使用。それより大きな値は422バリデーションエラーになります。
失敗した呼び出しは0クレジット。retryable: trueのエラーは1回再試行。retryable: falseのエラーはそのプラットフォームの回答として記録してください。
手順
- リストを取得 ユーザーが提供したすべての競合 × プラットフォームの組み合わせに対して行います。
- 期間でフィルタリング 各投稿の
publishedAtに基づいて行います。リストは最新の投稿を返しますが、期間は問いません。「この期間に投稿なし」は失敗した呼び出しとは別に報告してください。Xの場合、期間内のツイートのみを保持し、ソースが人気順であることを注記します。 - クロス投稿を統合: ある競合が異なるプラットフォームに、タイムスタンプが数分以内でテキストが重複する投稿をしている場合、それらは同一のアイテムとして扱います。
- 各投稿をスコアリング 同一アカウントの同一プラットフォーム内で比較:
エンゲージメント = いいね + コメント（+ シェア/リポストがあればそれも）；リフト = エンゲージメント / そのアカウントで取得した投稿のエンゲージメント中央値。リフトが2以上の投稿を「好調な投稿」とします。 - 各投稿にタグ付け フォーマット（ショート動画、ロング動画、画像、カルーセル、テキスト、リンク）と、キャプションから推測した2～4単語のトピックを付与します。
- 前回のダイジェストと比較（提供された場合）: 投稿頻度の変化、新しいトピック、追加・削除されたフォーマット。
ダイジェストのフォーマット
- アクティビティテーブル: 競合 × プラットフォーム → 今期間の投稿数（および前期間との変化）。
- 好調な投稿: 競合ごとに最大5件 — プラットフォーム、日付、フォーマット、キャプションの最初の行、エンゲージメントとリフト、リンク、ソースエンドポイント。
- テーマ
[人間のレビューが必要]: 競合が注力している3～5のトピックまたはフォーマット。それぞれ少なくとも2つのリンク付き投稿で裏付けます。 - ギャップと注意点: 提供されなかった、または失敗したプラットフォーム、上記のFacebookとXに関する注記、およびおおよその件数。
- 実行の総クレジット数。
人間のレビューが必要な箇所
- トピックタグとテーマ — キャプションから推測されています。
- データに基づく「戦略」の解釈。ダイジェストは何が投稿され、アカウントのベースラインと比較してどのようにパフォーマンスしたかを示すものであり、その理由を示すものではありません。