openclaw-voc-skill/dist/skills/instagram-user-posts/SKILL.md

---

name: instagram-user-posts description: 获取指定 Instagram 用户发布的帖子列表，包括点赞数、评论数、帖子文案等。适用于竞品品牌 IG 内容策略分析、KOL 帖子互动表现评估、品牌运营频率分析。 version: 1.3.0

author: nkkj-BrainHack

instagram-user-posts

功能用途

获取 Instagram 用户发布的帖子列表，分析内容策略、发帖规律和互动表现。

核心业务场景：

• 竞品品牌 IG 内容策略分析（发帖频率、内容主题、帖子互动率）
• KOL 帖子互动表现评估（单帖平均互动率计算）
• 品牌视觉内容风格分析（内容类型分布：图片/视频/轮播）

调用链（Workflow）

上游: instagram-search(query, select='users') → 搜索品牌/KOL → 取 username
上游: instagram-user-info(username) → 获取 pk 字段和粉丝数
本步: instagram-user-posts(user_id=pk) → 获取帖子列表
分析: 互动率 = (like_count + comment_count) / follower_count

入参规则

参数	类型	必填	说明
user_id	string	✅	Instagram 用户数字 ID（pk），从 instagram-user-info 的 user.pk 字段获取
count	integer	❌	每页帖子数量，最大 50（默认 12）
end_cursor	string	❌	翻页游标，首次不传，后续传上次返回的 end_cursor

接口调用方式

• 请求方法: GET

• 接口地址: https://server.fmode.cn/api/voc-social/instagram/v1/fetch_user_posts_v2

  GET ?user_id=12345678&count=12
  

关键响应字段

字段路径	业务用途
items[].id	帖子 ID
items[].caption.text	帖子文案 → 内容主题分析
items[].like_count	点赞数 → 互动率计算分子
items[].comment_count	评论数 → 互动率计算分子
items[].taken_at	发布时间戳 → 发帖频率分析
items[].media_type	媒体类型（1=图片 2=视频 8=轮播） → 内容类型分布
items[].view_count	视频观看次数（仅视频帖子）
has_more	是否还有更多帖子
end_cursor	下一页游标

依赖要求

• 统一代理: https://server.fmode.cn/api/voc-social/
• 请求方法 GET，参数作为查询参数传递
• user_id 必须从 instagram-user-info 的 user.pk 字段获取