用途
本技能用于通过 Rube MCP（Composio）自动化 Instagram 操作，覆盖内容发布、媒体管理、数据洞察和发布限制查询等任务。
前置条件
- 必须已连接 Rube MCP（RUBE_SEARCH_TOOLS 可用）。
- 通过 RUBE_MANAGE_CONNECTIONS 建立有效的 Instagram 连接，工具包为 instagram。
- 始终先调用 RUBE_SEARCH_TOOLS 获取当前工具架构。
- 需要 Instagram 商业或创作者账号，个人账号不支持。
设置
- 获取 Rube MCP：在客户端配置中添加 https://rube.app/mcp 作为 MCP 服务器。无需 API 密钥，添加端点即可使用。
- 确认 RUBE_SEARCH_TOOLS 有响应，以验证 Rube MCP 可用。
- 调用 RUBE_MANAGE_CONNECTIONS，工具包为 instagram。
- 若连接未处于 ACTIVE 状态，按返回的授权链接完成 Instagram/Facebook OAuth。
- 确认连接状态为 ACTIVE 后再运行任何工作流。
核心工作流
1. 创建单图/视频帖子
适用场景：用户希望向 Instagram 发布单张照片或视频。
工具顺序：
- INSTAGRAM_GET_USER_INFO：获取 Instagram 用户 ID（前置）。
- INSTAGRAM_CREATE_MEDIA_CONTAINER：使用图片/视频 URL 创建媒体容器（必需）。
- INSTAGRAM_GET_POST_STATUS：检查媒体容器是否就绪（可选）。
- INSTAGRAM_CREATE_POST 或 INSTAGRAM_POST_IG_USER_MEDIA_PUBLISH：发布容器（必需）。
关键参数：image_url（公开图片 URL）、video_url（公开视频 URL）、caption（帖子说明文字）、ig_user_id（Instagram 商业账号用户 ID）。
注意事项：媒体 URL 必须可公开访问，私有或需认证的 URL 会失败；视频容器处理需要时间，发布前应轮询 GET_POST_STATUS；说明文字支持话题标签和提及，上限 2200 字符；发布尚未处理完成的容器会返回错误。
2. 创建轮播帖
适用场景：用户希望在单条轮播帖中发布多个图片/视频。
工具顺序：
- INSTAGRAM_CREATE_MEDIA_CONTAINER：为每个媒体项创建单独容器（必需，每项重复）。
- INSTAGRAM_CREATE_CAROUSEL_CONTAINER：创建引用所有媒体容器的轮播容器（必需）。
- INSTAGRAM_GET_POST_STATUS：检查轮播容器就绪状态（可选）。
- INSTAGRAM_POST_IG_USER_MEDIA_PUBLISH：发布轮播（必需）。
关键参数：children（轮播的媒体容器 ID 数组）、caption（轮播帖说明文字）、ig_user_id（Instagram 商业账号用户 ID）。
注意事项：轮播需要 2-10 个媒体项，少于或多于都会失败；每个子容器必须在创建轮播容器前单独创建；所有子容器必须完全处理完成后才能创建轮播；轮播支持混合媒体（图片+视频）。
3. 获取媒体与洞察
适用场景：用户希望查看帖子或分析帖子表现。
工具顺序：
- INSTAGRAM_GET_IG_USER_MEDIA 或 INSTAGRAM_GET_USER_MEDIA：列出用户媒体（必需）。
- INSTAGRAM_GET_IG_MEDIA：获取特定帖子详情（可选）。
- INSTAGRAM_GET_POST_INSIGHTS 或 INSTAGRAM_GET_IG_MEDIA_INSIGHTS：获取帖子指标（可选）。
- INSTAGRAM_GET_USER_INSIGHTS：获取账号级洞察（可选）。
关键参数：ig_user_id、media_id（特定媒体帖子 ID）、metric（要获取的指标，如 impressions、reach、engagement）、period（洞察时间段，如 day、week、lifetime）。
注意事项：洞察仅对商业/创作者账号可用；部分指标需要最低粉丝数；洞察数据可能延迟最多 48 小时；period 参数必须与指标类型匹配。
4. 检查发布限制
适用场景：用户在尝试发布前确认是否可发布。
工具顺序：
- INSTAGRAM_GET_IG_USER_CONTENT_PUBLISHING_LIMIT：检查剩余发布配额（必需）。
关键参数：ig_user_id。
注意事项：Instagram 执行每 24 小时滚动窗口 25 条帖子的限制；发布限制按滚动方式重置，而非午夜重置；批量发布前应检查限制以避免失败。
5. 获取媒体评论与子项
适用场景：用户希望查看帖子评论或轮播的子项。
工具顺序：
- INSTAGRAM_GET_IG_MEDIA_COMMENTS：列出媒体帖子评论（必需）。
- INSTAGRAM_GET_IG_MEDIA_CHILDREN：列出轮播帖子子项（可选）。
关键参数：media_id、ig_media_id（备用媒体 ID 参数）。
注意事项：评论可能分页，需跟随分页游标获取完整结果；轮播子项以独立媒体对象返回；账号的评论审核设置会影响返回内容。
常见模式
ID 解析：
- Instagram 用户 ID：调用 INSTAGRAM_GET_USER_INFO，从响应中提取 ig_user_id，用于后续所有 API 调用。
- 媒体容器状态检查：调用 INSTAGRAM_CREATE_MEDIA_CONTAINER，提取 container_id，轮询 INSTAGRAM_GET_POST_STATUS，等待状态为 FINISHED 后再发布。
两阶段发布：
- 阶段一：使用内容 URL 创建媒体容器。
- 阶段二：容器处理完成后发布。
- 视频内容务必在两阶段之间检查容器状态。
- 轮播需所有子项完成阶段一后才能创建轮播容器。
已知陷阱
媒体 URL：所有图片/视频 URL 必须是可公开访问的 HTTPS URL；需认证、CDN 限制或需要 cookie 的 URL 会失败；临时 URL（如预签名 S3）可能在处理完成前过期。
速率限制：每 24 小时滚动窗口 25 条帖子；API 速率限制与发布限制分开适用；对 429 响应实施指数退避。
账号要求：仅支持商业或创作者 Instagram 账号；个人账号无法使用 Instagram Graph API；账号必须关联 Facebook 页面。
响应解析：媒体 ID 为数字字符串；洞察数据可能嵌套在不同响应键下；分页使用基于游标的令牌。
快速参考
| 任务 | 工具 Slug | 关键参数 |
|---|---|---|
| 获取用户信息 | INSTAGRAM_GET_USER_INFO | 无 |
| 创建媒体容器 | INSTAGRAM_CREATE_MEDIA_CONTAINER | image_url/video_url, caption |
| 创建轮播 | INSTAGRAM_CREATE_CAROUSEL_CONTAINER | children, caption |
| 发布帖子 | INSTAGRAM_CREATE_POST | ig_user_id, creation_id |
| 发布媒体 | INSTAGRAM_POST_IG_USER_MEDIA_PUBLISH | ig_user_id, creation_id |
| 检查帖子状态 | INSTAGRAM_GET_POST_STATUS | ig_container_id |
| 列出用户媒体 | INSTAGRAM_GET_IG_USER_MEDIA | ig_user_id |
| 获取媒体详情 | INSTAGRAM_GET_IG_MEDIA | ig_media_id |
| 获取帖子洞察 | INSTAGRAM_GET_POST_INSIGHTS | media_id, metric |
| 获取用户洞察 | INSTAGRAM_GET_USER_INSIGHTS | ig_user_id, metric, period |
| 获取发布限制 | INSTAGRAM_GET_IG_USER_CONTENT_PUBLISHING_LIMIT | ig_user_id |
| 获取媒体评论 | INSTAGRAM_GET_IG_MEDIA_COMMENTS | ig_media_id |
| 获取轮播子项 | INSTAGRAM_GET_IG_MEDIA_CHILDREN | ig_media_id |