SuperAPI AI 工具集

instagram-automation

营销与增长

查看项目

更新于 10-15 15:41

技能介绍

用途

本技能用于通过 Rube MCP 接入 Composio 的 Instagram 工具包,自动化 Instagram 的发布、媒体管理与数据洞察等操作。

前置条件

  • 必须已连接 Rube MCP(RUBE_SEARCH_TOOLS 可用)
  • 需通过 RUBE_MANAGE_CONNECTIONS 建立 toolkit 为 instagram 的有效连接
  • 每次操作前应先调用 RUBE_SEARCH_TOOLS 获取当前工具模式
  • 需要 Instagram Business 或 Creator 账户,个人账户不受支持

设置方式

  1. 获取 Rube MCP:在客户端配置中添加 https://rube.app/mcp 作为 MCP 服务器,无需 API 密钥
  2. 确认 RUBE_SEARCH_TOOLS 可响应,以验证 Rube MCP 可用
  3. 调用 RUBE_MANAGE_CONNECTIONS 并指定 toolkit 为 instagram
  4. 若连接状态非 ACTIVE,按返回的授权链接完成 Instagram/Facebook OAuth
  5. 确认连接状态为 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

适用场景

适用于执行概述中描述的工作流或操作。仅当任务明确匹配上述范围时使用。

限制

  • 仅在任务明确匹配上述范围时使用本技能
  • 不要将输出视为环境特定验证、测试或专家审查的替代
  • 若缺少必需输入、权限、安全边界或成功标准,应停止并请求澄清