Instagram Data Skill

UnifAPI を通じて公開 Instagram データを読み取るための決定論的な読み取り経路。これ は Data Skill です: それ単独でマーケティングジョブを実行するわけではありません — 具体的な instagram/... 操作、レスポンスの形、落とし穴を名指しするので、あらゆる クリエイターファーストのワークフロー（ショートリスト作成、オーディエンス適合、料金算定のコンテキスト）が、 毎回サーフェスを再発見する代わりに、1 つの既知のレシピから読み取れます。

読み取り専用 — 手ではなく目。公開 Instagram データをリサーチし、 引用されたレコードを返します; 投稿、コメント、DM を決して行わず、UnifAPI は Instagram の認証情報を決して保持しません。

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

共有の unifapi スキルを通じて一度接続し（OAuth MCP）、その後、以下の 操作を呼び出します。プロフィールは {username} をキーに、投稿はその {shortcode}（URL セグメント）をキーにします — instagram/resolve/* は、必要なときに username↔user-id と shortcode↔media-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 として渡します。コストを報告する際は常に billing を保持します。

中核となる操作

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

ワークフロー

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

1. プロフィールを解決する。 instagram/users/{username} を呼び出して follower_count、 media_count、is_private、is_verified を取得します。
2. コンテンツとエンゲージメントを読む。 instagram/users/{username}/posts と .../reels を呼び出します; 各 InstagramPost は動画について like_count、comment_count、 play_count/view_count を持ち — そしてスポンサーコンテンツをフラグする is_paid_partnership を持ちます。next_cursor でページングします。
3. 反応を読む。 トップ投稿のセンチメントのために instagram/posts/{shortcode}/comments（と 返信エンドポイント）を呼び出します。
4. 新しいハンドルを発見する。 instagram/search?q=...、 instagram/explore、または instagram/locations/{id}/posts を呼び出し、その後、浮上した ハンドルを解決してステップ 1 にループします。
5. ネットワークまたはオーディエンスをマッピングする。 リーチの作業のために instagram/users/{username}/followers、 .../following、または .../tagged-posts（誰が彼らを取り上げているか）を呼び出します。
6. すべてを引用する。 すべての数値は、それが来た投稿またはプロフィールに紐付きます; billing.records_charged を報告します（billing メタデータが欠けている場合は 見積もります）。

形に関するメモ

• InstagramUser — {username} をキーにします。follower_count、 following_count、media_count、is_verified、is_private。
• InstagramPost — {shortcode} をキーにします。caption、like_count、 comment_count、play_count、view_count、taken_at、media_type、 is_paid_partnership、user、location、carousel。
• InstagramComment — text、like_count、child_comment_count。
• InstagramLocation — name、lat、lng、media_count。

落とし穴

• プロフィールは {username} をキーに、投稿は {shortcode} をキーにします — どちらも 公開 IG URL から読み取ります。数値の user-id または media-id が必要なときのみ instagram/resolve/* を使います。
• 非公開アカウント（is_private）はプロフィールを露出しますが、メディアを制限します — それを示し、 薄いカバレッジをごまかさないでください。
• is_paid_partnership は開示されたスポンサー投稿をマークします — 料金算定と ブランドセーフティに有用な根拠です、報告します。
• 残高が少ないと、リストページがひそかに切り詰められることがあります: billing.truncated_due_to_balance をチェックします — true のときページは部分的です。

出力

呼び出し側のワークフローが必要とするレコードを、それぞれその投稿または プロフィールに引用して返します、加えて 1 行のコストメモ（records_charged）。このスキルが 直接使われるときは、コンパクトなクリエイターサマリーがデフォルトです:

**@handle** — {followers} followers, {media} posts, verified {yes/no}. Recent posts: avg {likes} likes / {comments} comments. Paid partnerships: {N}. Evidence: {post URLs}. Records: ~{N}.

関連スキル

• kol-pricing、creator-shortlist、audience-fit-check（Influencer Marketing）— この読み取り経路の上で Instagram クリエイターを料金算定して精査します。
• unifapi — 共有データスキル: MCP を接続し、get_operation で正確なスキーマを参照します。