用途
本技能用于通过 Rube MCP 接入 Composio 的 Instagram 工具包,自动化 Instagram 的发布、媒体管理与数据洞察等操作。
前置条件
- 必须已连接 Rube MCP(RUBE_SEARCH_TOOLS 可用)
- 需通过 RUBE_MANAGE_CONNECTIONS 建立 toolkit 为 instagram 的有效连接
- 每次操作前应先调用 RUBE_SEARCH_TOOLS 获取当前工具模式
- 需要 Instagram Business 或 Creator 账户,个人账户不受支持
设置方式
- 获取 Rube MCP:在客户端配置中添加 https://rube.app/mcp 作为 MCP 服务器,无需 API 密钥
- 确认 RUBE_SEARCH_TOOLS 可响应,以验证 Rube MCP 可用
- 调用 RUBE_MANAGE_CONNECTIONS 并指定 toolkit 为 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、video_url、caption、ig_user_id。
注意:媒体 URL 必须可公开访问,私有或需认证的 URL 会失败;视频容器处理可能耗时,发布前应轮询 GET_POST_STATUS;caption 支持话题标签和提及,上限 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。
注意:轮播需要 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、metric(如 impressions、reach、engagement)、period(如 day、week、lifetime)。
注意:洞察仅对 Business/Creator 账户可用;某些指标有最低粉丝数要求;洞察数据可能延迟至多 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 解析:先调用 INSTAGRAM_GET_USER_INFO,从响应中提取 ig_user_id,用于后续所有 API 调用。
媒体容器状态检查:创建容器后提取 container_id,轮询 INSTAGRAM_GET_POST_STATUS,等待状态为 'FINISHED' 后再发布。
两阶段发布:第一阶段用内容 URL 创建媒体容器;第二阶段在容器处理完成后发布。视频内容务必在阶段间检查容器状态;轮播需所有子项完成第一阶段后再创建轮播容器。
已知限制
- 媒体 URL:所有图片/视频 URL 必须是可公开访问的 HTTPS 地址;需认证、受 CDN 限制或需 cookie 的 URL 会失败;临时 URL(如预签名 S3)可能在处理完成前过期
- 速率限制:每 24 小时滚动窗口 25 帖;API 速率限制与发布限制独立;对 429 响应应实现指数退避
- 账户要求:仅支持 Business/Creator 账户;个人账户无法使用 Instagram Graph API;账户必须连接到 Facebook 页面
- 响应解析:媒体 ID 为数字字符串;洞察数据可能嵌套在不同响应键下;分页使用基于游标的令牌
快速参考
| 任务 | 工具 | 关键参数 |
|---|---|---|
| 获取用户信息 | 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 |
适用场景
适用于执行概述中描述的工作流或操作。仅当任务明确匹配上述范围时使用。
限制
- 仅在任务明确匹配上述范围时使用本技能
- 不要将输出视为环境特定验证、测试或专家审查的替代
- 若缺少必需输入、权限、安全边界或成功标准,应停止并请求澄清