Instagram 数据 Skill

通过 UnifAPI 读取公开 Instagram 数据的确定性读取路径。这是一个 Data Skill：它本身不运行某个营销任务——它点明具体的 instagram/... 操作、响应形态和坑，让任何以创作者为先的工作流（入围、受众契合、定价上下文）从一份已知配方读取，而非每次重新发现这个面。

只读——眼睛，而非双手。它研究公开的 Instagram 数据并返回带引证的记录；它绝不发帖、评论或发 DM，UnifAPI 也绝不持有 Instagram 凭证。

用 unifapi skill 获取实时证据

通过共享的 unifapi skill 连接一次（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 skill 的 get_operation 读取确切的 schema——但从这张表里挑操作，不要盲目发现。

工作流

确定性配方。挑选与任务匹配的那个；每个都精确点明要调用什么。

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. 发掘新 handle。 调用 instagram/search?q=...、 instagram/explore 或 instagram/locations/{id}/posts，然后解析 浮现的 handle 并循环回第 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 时该页是部分的。

输出

返回调用方工作流所需的记录，每个都引证到它的帖子或画像，外加一行成本说明（records_charged）。当这个 skill 被直接使用时，默认是一份紧凑的创作者摘要：

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

相关 skills

• kol-pricing、creator-shortlist、audience-fit-check（Influencer Marketing）—— 在这条读取路径之上为 Instagram 创作者定价并甄别。
• unifapi —— 共享的数据 skill：连接 MCP 并用 get_operation 查找确切的 schema。