TikTok Data Skill

UnifAPI を通じて公開 TikTok データを読むための決定論的なリードパスです。これは Data Skill です: それ自体でマーケティングジョブを実行することはありません — 具体的な tiktok/... オペレーション、レスポンス形状、落とし穴を名指しすることで、クリエイター先行 またはトレンド先行のあらゆるワークフロー（ショートリスト、オーディエンス適合、需要レーダー、 ローカルバズ）が、サーフェスを毎回再発見する代わりに、1 つの既知のレシピから読めるように します。

読み取り専用 — 手ではなく目。公開 TikTok データをリサーチし、出典付きのレコードを 返します。投稿、コメント、フォローは決してせず、UnifAPI が TikTok の認証情報を保持する ことも決してありません。

ライブの根拠には unifapi スキルを使う

共有の unifapi スキル（OAuth MCP）を通じて一度接続し、次に下記のオペレーションを 呼び出します。TikTok のユーザーと動画は 数値 id でキー付けされます — まず @handle や動画 URL をその id に解決してください（落とし穴を参照）。出力がレコードコストを記載できる よう、billing メタデータは保持してください。

レスポンス契約

単一エンティティのエンドポイントは、オブジェクトを data で返します:

{
  "request_id": "unif_...",
  "data": {},
  "billing": { "records_charged": 1, "balance_remaining": 99 }
}

リストのエンドポイントは、配列を data で返し、さらに pagination を返します:

{
  "request_id": "unif_...",
  "data": [],
  "pagination": { "has_more": false, "next_cursor": null },
  "billing": { "records_charged": 1 }
}

pagination.has_more が true のときは、pagination.next_cursor を次のリクエストの cursor として渡します（limit がページサイズを設定）。billing は常に保持してください。

コアオペレーション

ここに記載のないフィールドが必要ですか? 呼び出す前に unifapi スキルの get_operation を 使って正確なスキーマを読みます — ただしオペレーションはこのテーブルから選び、当てずっぽうで 発見しないでください。

ワークフロー

決定論的なレシピ。ジョブに合致するものを選びます。それぞれが何を呼び出すべきかを正確に 名指しします。

1. トピックで発見する。 ニッチについて tiktok/search/videos?q=...、 tiktok/search/users?q=...、または tiktok/search/hashtags?q=... を呼び出します。 混在した結果には tiktok/search?q=... を使います。
2. クリエイターを解決する。 tiktok/users/resolve?username=... を呼び出して数値 id を 取得し、次に tiktok/users/{id} で follower_count、like_count、video_count を 取得します。
3. エンゲージメントを読む。 tiktok/users/{id}/videos を呼び出します。各 Video は view_count、like_count、comment_count、share_count を持ちます — 動画ごとの エンゲージメントを計算します。next_cursor でページングします。
4. 動画とその反応を読む。 tiktok/videos/{id} を呼び出し（まず URL を tiktok/videos/resolve?url=... で解決）、次にセンチメントのために tiktok/videos/{id}/comments を呼び出します。
5. トレンドを追跡する。 video_count/view_count には tiktok/hashtags/{id} を、 タグやサウンドで何が広がっているかには tiktok/hashtags/{id}/videos（または tiktok/music/{id}/videos）を呼び出します。
6. ネットワークをマップする。 リーチとアフィニティの作業には tiktok/users/{id}/followers、.../following、または .../likes を呼び出します。
7. すべて出典付けする。 すべての数値は、それが来た動画またはプロフィールに紐づきます。 billing.records_charged（または billing メタデータが欠けているときは見積もり）を 報告します。

形状ノート

• User — username、display_name、follower_count、following_count、 like_count、video_count、is_verified、is_private、region。
• Video — video_description、view_count、like_count、 comment_count、share_count、duration、author、music、hashtags、 create_time。
• Hashtag — name、video_count、view_count、is_commerce。
• Music — title、author、is_original。

落とし穴

• TikTok のユーザーと動画は 数値 id でキー付けされます。あらゆる tiktok/users/{id}/... または tiktok/videos/{id}/... の呼び出しの 前に、 @handle を tiktok/users/resolve?username=... で、動画 URL を tiktok/videos/resolve?url=... で解決してください。
• tiktok/videos/batch は GET ではなく POST です（id はボディに）— 多数の動画 id を 一度にハイドレートするのに使います。
• 非公開のクリエイター（is_private）は読めるものを制限します — それを浮かび上がらせます。
• 残高が低いとリストページがサイレントに切り詰められることがあります: billing.truncated_due_to_balance をチェックします — true のときページは部分的なので、 いかなるカウントも信頼する前にチャージしてください。

出力

呼び出し元のワークフローが必要とするレコードを、それぞれその動画またはプロフィールに 出典付けして返し、さらに 1 行のコストノート（records_charged）を添えます。このスキルが 直接使われるときは、コンパクトなクリエイターサマリーがデフォルトです:

**@handle** — {followers} followers, {videos} videos. Recent videos: avg {views} views / {likes} likes / {comments} comments. Rising tags: {#hashtags}. Evidence: {video URLs}. Records: ~{N}.

関連スキル

• creator-shortlist、audience-fit-check（Influencer Marketing） — このリードパスの上で TikTok クリエイターをショートリストし精査する。
• social-listening-brief（Social Listening）、treatment-demand-radar、menu-demand-radar、restaurant-local-buzz（垂直） — TikTok を最初に読むトレンドと需要の作業。
• unifapi — 共有データスキル: MCP を接続し、get_operation で正確なスキーマを調べる。