openclaw-voc-skill/social-media/instagram-user-posts/SKILL.md

instagram-user-posts

功能用途

获取指定 Instagram 用户发布的帖子列表，包括图片、点赞数、评论数等。用于竞品内容策略分析、发帖频率和互动率评估。

入参规则

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

接口调用方式

• 请求方法: GET
• 接口地址: https://server.fmode.cn/thapi/v1/instagram/v1/fetch_user_posts_v2
• 请求头:
  • Authorization: Bearer tKIbAsEM8X+GmE2vHqGW7D/ICwK1Q5V4viKFrWiPB6HholGdLFqZJmmyNw==
  • Accept: application/json
• 接口配置文件路径: ./api-config.json

参数直接作为 GET 查询参数传递：

GET /thapi/v1/instagram/v1/fetch_user_posts_v2?user_id=12345678&count=12

注意: user_id 需先通过 instagram-user-info 接口获取 pk 字段。帖子的互动率可通过 (like_count + comment_count) / follower_count 计算。

返回格式

返回 JSON 对象，主要字段：

字段	类型	说明
items	array	帖子数组
has_more	boolean	是否有更多帖子
end_cursor	string	下一页游标

items 数组中每条帖子包含：

字段	类型	说明
id	string	帖子 ID
code	string	帖子短码（URL 用）
caption.text	string	帖子文案
like_count	integer	点赞数
comment_count	integer	评论数
taken_at	integer	发布时间戳
media_type	integer	媒体类型: 1=图片, 2=视频, 8=轮播
image_versions2	object	图片版本列表
video_versions	array	视频版本列表（仅视频帖子）
view_count	integer	视频观看次数（仅视频帖子）

依赖要求

• 直连代理: https://server.fmode.cn/thapi
• 需携带 Bearer Token 在 Authorization header 中
• 所有请求均为 GET 方法
• 关联技能: instagram-user-info（先获取 pk）、instagram-search（也可获取 pk）