TikTok・Instagram・YouTube の公開レコードを、クリエイター調査やソーシャルリスニングの Skills で活用。まず MCP、製品化するときは HTTP で。

要点: このクックブックは、3 つの統合を構築せずに、クリエイターリサーチやソーシャルリスニングのために TikTok・Instagram・YouTube のレコードを必要とする、実装段階の読者を対象としています。

UnifAPI は、TikTok・Instagram・YouTube の公開データを、$0.001 クレジットで価格設定された共有の MCP と HTTP のサーフェスを通じて公開します。本ガイドは、共通のプリミティブ、ページネーション、コスト計算の枠組みを示し、エージェントがカスタム GUI なしでクリエイターリサーチとソーシャルリスニングの Skills を実行できるようにします。

消費者向けの公開データワークフローの多く — ブランド監視、クリエイターリサーチ、製品ローンチ分析、トレンド検出 — は、結局のところ同じ 3 つのプラットフォームに行き着きます。短尺動画の TikTok、ビジュアルソーシャルの Instagram、長尺の YouTube です。この 3 つすべてから安定したフィードを構築するには、これまで 3 つのベンダー契約と 3 つの異なる形式が必要でした。UnifAPI なら、1 つの MCP サーバーと、全体を通じた 1 つの形で済みます。

実際に必要なエンドポイント

ほとんどのエージェントワークフローでは、プラットフォームごとに 3 つのプリミティブで十分です。キーワードやハッシュタグでの検索、ID による単一投稿や動画の取得、そしてクリエイターの最近の投稿の一覧です。それ以外のもの — コメント、関連投稿、フォロワーの文脈 — は補助的な詳細であり、主要なセットが手に入ってからエージェントが必要に応じて取りに行けます。

UnifAPI では、それらは次のようにマッピングされます。TikTok — /tiktok/search、/tiktok/videos/{id}、/tiktok/users/{id}/videos。YouTube — /youtube/search、/youtube/videos/{video_id}、/youtube/channels/{channel_id}/videos。Instagram — /instagram/search、/instagram/posts/{shortcode}、/instagram/users/{username}/posts。命名は意図的にプラットフォーム間で揃えてあるので、1 つを学んだエージェントのプロンプトは 3 つすべてを学んだことになります。

統一されたリクエストの形

すべての HTTP エンドポイントは同じ Authorization: Bearer <key> ヘッダーを受け付け、同じ外側の形式を返します。{ request_id, data, pagination?, billing } です。data の内側のフィールドはプラットフォーム固有(TikTok の動画にはハッシュタグのリストがあり、YouTube の動画にはチャンネルのメタデータがある)ですが、その周りの形は一貫しています。

その統一性は、聞こえる以上に重要です。エージェントのツール利用ループに、リトライポリシーが 1 つ、ページネーションハンドラーが 1 つ、エラー形式が 1 つで済む — 3 つではない、ということです。プラットフォーム固有の知識は、モデルが見られる data フィールドの内側にとどまります。

3 つのプラットフォームをまたいだページネーション

各プラットフォームはページネーションの仕方が異なります — TikTok はカーソルトークンを、YouTube は pageToken を、Instagram は end_cursor を使います。UnifAPI はそれらのシグナルを単一の { cursor, has_more } オブジェクトに正規化します。エージェントのループは cursor を読み、それを次の呼び出しの cursor クエリパラメータとして渡し、has_more が false に切り替わったら止まります。

デフォルトのページサイズはどのプラットフォームでも 20 レコードです。上限は 50 です。ほとんどのエージェント実行では 1 ページで十分です — モデルが意思決定をするのに、上位 20 件以上を必要とすることはめったにありません。

エージェント実行ごとのコスト見積もり

コストはレコード数 × $0.001 です。「今週の自社ブランドへの TikTok メンションを監視する」という実行が、20 件の検索結果を取得し、それから個別の動画 5 件のトランスクリプトを取りに行く場合、25 レコード — $0.025 です。「このアカウントのクリエイターリサーチ」という実行が、最近の投稿 50 件と動画詳細 10 件を取得する場合、60 レコード — $0.06 です。

私たちの役に立ってきた目安のルールはこうです。典型的なリサーチワークフローにはエージェント実行あたり $0.05、深掘りには $0.20 を見込んでおきましょう。初回チャージの 2,000 クレジットのボーナスだけでも、軽い実行をおよそ 40 回カバーします。

まとめて組み立てる

「今週の自社について 3 つすべてで何がトレンドかを見つける」というエンドツーエンドのエージェントは、次のようになります。/tiktok/search、/instagram/search、/youtube/search をブランドキーワードで並列呼び出しし、それぞれから上位 10 件を集め、各プラットフォームの上位 3 件について、/tiktok/videos/{id}、/instagram/posts/{shortcode}、または /youtube/videos/{video_id} に展開して完全なトランスクリプトやキャプションを取得し、その全体を要約プロンプトとともにモデルに渡します。

総コスト: 検索レコード 30 件 + 詳細取得 9 回 = 45 クレジット、$0.045。Instagram の投稿取得 3 回はそれぞれ、OpenAPI 契約で公開されている 1 呼び出しあたり最低 3 クレジットで課金されます。総統合数: 1。それがこの売り込みです — Skill から始め、https://mcp.unifapi.com で MCP サーバーを接続し、ツール呼び出しとワークスペースクレジットのために OAuth が必要なときだけサインインします。

次に読むべきもの

MCP で KOL 料金算定エージェントを動かす - これらのプラットフォームをクリエイター料金算定のエンリッチメントとして使います。

統一されたレスポンス形式 - 複数プラットフォームのレスポンスがどう比較可能なまま保たれるかを説明します。

API カタログ - ライブのプラットフォーム操作を一覧します。