SuperAPI AI 工具集

instagram

通用与其它

查看项目

更新于 10-26 18:17

技能介绍

用途

该技能用于通过配套的 instagram-cli 命令行工具读取和管理已认证的 Instagram 非消息类数据,并回答用户分享的 Instagram 帖子或 Reel 相关问题。私信、收件箱、会话/消息读取、筛选收件箱、高频互动对象和私信搜索由单独的 instagram_messages 技能负责,不在本技能范围内。

主要能力

  • 账号与资料:列出已关联账号、获取本人或他人资料(含粉丝/关注数)、更新个人简介。
  • 兴趣管理:查看当前感兴趣/不感兴趣的话题,标记话题为感兴趣或不感兴趣。
  • 帖子与信息流:获取本人或他人帖子、关注信息流、密友信息流、话题标签帖子、按 ID 或 URL 获取单条帖子。
  • 社交关系:获取本人粉丝列表、关注列表、密友列表。
  • 互动数据:获取帖子评论、帖子点赞者、最近点赞帖子、最近评论帖子。
  • 收藏:获取收藏帖子、收藏夹,创建/重命名收藏夹,保存/取消保存帖子。
  • 故事:获取本人故事、故事归档、故事托盘、故事媒体、位置搜索。
  • 其他:活动通知、账号洞察、媒体理解、发布信息流、发布故事、设置头像。

使用方式

  1. 账号连接检查:运行 instagram-cli accounts。若返回带 user_fbid 的账号信息,说明已连接,可继续;缓存该结果,无需每条命令前重复检查。若失败或为空,运行 instagram-cli connect-url 获取连接 URL,并引导用户前往 Meta Accounts Center 关联 Instagram 账号。断开连接则运行 instagram-cli disconnect-url 并引导用户前往 Meta Accounts Center 移除关联账号。始终从命令输出读取 URL,不要硬编码。
  2. 账号作用域:除 accounts 外,所有命令都需要 --account-id <user_own_fbid>,该值必须来自 accounts 命令返回的当前认证用户自己的 user_fbid。若返回多个账号,先询问用户使用哪个。
  3. 执行命令:使用 exec 运行 instagram-cli <target> --account-id <user_own_fbid> [options]。
  4. 分页:仅在用户明确需要更多结果时使用 --after / --max-id 分页,不要自动拉取所有页。若响应包含 has_next_page: true 或 has_more: true 而未继续拉取,应告知用户已看到多少、还有更多,并询问是否继续。
  5. 写操作:仅在用户明确要求时才执行写操作,包括兴趣更新、发布、资料修改等。

适用场景

  • 回答用户分享的 Instagram 帖子或 Reel 相关问题,结合帖子上下文、媒体描述和必要的视觉检查。
  • 查询本人或他人的 Instagram 公开/认证数据,如资料、帖子、粉丝、关注、评论、点赞者等。
  • 管理收藏夹、保存帖子、更新兴趣、修改简介等账号操作。
  • 获取故事、位置搜索、账号洞察等数据。

限制

  • 不处理私信相关功能,需使用 instagram_messages 技能。
  • 无法读取排名首页时间线,feed 命令的 --variant 仅支持 following 和 favorites。
  • 不支持获取他人的关注列表。
  • Instagram API 有速率限制,过多调用会返回 429 Too Many Requests 且不会重试。若任务预计超过约 1000 次 API 调用,应先与用户确认范围、缩小工作或提出近似方案。
  • 不要向用户暴露 FBID、不透明 ID 或实现术语,仅使用用户名、显示名和通俗描述。
  • 不要对命令进行持续/频繁轮询。
  • 帖子输出使用 social_posts_v1 格式,直接读取 posts[],不要猜测 GraphQL 路径或用 jq 管道处理。
  • 部分字段在提供方响应中不可用时会被省略;feed 项可能缺少 url 或 created_at,若需引用、标注日期或链接,应运行 post --id <post_id> 获取完整记录。
  • 若缺少必要帖子数据,CLI 会失败并附带提供方给出的原因;无提供方原因时报告 schema 不匹配,而不是返回空帖子列表。
  • 呈现帖子时间时优先使用 post_created_at.user_local。
  • 不要表现得比实际更确定:明确说明检查了什么,猜测就说是猜测,承认无法验证的内容。