Threads Data Skill

UnifAPI を通じて公開 Threads（Meta）データを読み取るための、決定論的な読み取りパス。 これは Data Skill です。それ自体でマーケティングジョブを実行することはありません — 具体的な threads/... のオペレーション、レスポンス形状、落とし穴を明示するので、あらゆる テキストファーストのリスニングやコンテンツのワークフローが、毎回サーフェスを 再発見する代わりに 1 つの既知のレシピから読み取れます。

読み取り専用 — 手ではなく目。公開 Threads データをリサーチし、引用付きの レコードを返します。投稿や返信はせず、UnifAPI は Threads の認証情報を 一切保持しません。

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

共有の unifapi スキル（OAuth MCP）を通じて一度接続し、続いて以下の オペレーションを呼び出します。プロフィールは {username} でキー付けされます。出力が レコードコストを記載できるよう、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 として渡します。コストを報告する際は常に billing を保持してください。

コアオペレーション

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

ワークフロー

決定論的なレシピ。ジョブに合うものを選びます。各レシピは、呼び出すべきものを 正確に明示します。

1. 語を設定する。 ブランドやカテゴリのリスニングには、 threads/search/recent?q=...（最新）と threads/search/top?q=... （最も見られた）を一緒に呼び出します — recent はライブの会話を捉え、top は 実際に広がった意見を捉えます。next_cursor でページングします。
2. ハンドルを見つける。 threads/search/profiles?q=... を呼び出してその語の アカウントを浮かび上がらせ、続いて threads/users/{username} でフォロワー規模と biography を取得します。
3. プロフィールのアクティビティを読む。 threads/users/{username}/posts、 .../replies、.../reposts を呼び出し、ハンドルが何を言い、答え、 増幅しているかを取得します。
4. 意見をクラスタリングする。 recent と top の結果にまたがる text を 質問と意見にグループ化します。like_count がどの意見が共感を呼ぶかをランク付けします。
5. すべてを引用する。 すべての引用は、それが由来する投稿またはプロフィールに結びつきます。 billing.records_charged を報告します（billing メタデータがない場合は見積もり）。

形状ノート

• ThreadsUser — {username} でキー付け。full_name、biography、 follower_count、is_verified、is_private。
• ThreadsPost — code（URL セグメント）、text、taken_at、 like_count、image_url、video_url、user。

落とし穴

• search/recent は最新で search/top は最も見られたものです — バランスの取れた 読み取りには両方を使います。どちらか一方だけでは新しさか人気に偏ります。
• 投稿は like_count のみを露出します — 投稿オブジェクトに返信/リポスト数はありません。 広がりはリポスト数ではなく search/top のランキングから測ります。
• プライベートなハンドル（is_private）は読み取れる範囲を制限します — それを明示します。
• 残高が少ないと、リストページが静かに切り捨てられることがあります: billing.truncated_due_to_balance を確認します — true のときページは部分的です。

出力

呼び出し元のワークフローが必要とするレコードを、それぞれの投稿または プロフィールに引用して返し、加えて 1 行のコストノート（records_charged）を付けます。このスキルが 直接使われる場合は、コンパクトなリスニングブリーフがデフォルトです。

**"{term}" on Threads** — {N} recent / {N} top posts. Takes: {themes}. Loudest: "{quote}" ({likes} likes, by @handle). Evidence: {post URLs}. Records: ~{N}.

関連スキル

• social-listening-brief（Social Listening）、content-opportunity-brief（Content Strategy） — この読み取りパスの上に構築するリスニングとコンテンツアイデアの作業。
• unifapi — 共有データスキル: MCP を接続し、get_operation で正確なスキーマを調べる。