instagram-automation

通过 Rube MCP 自动化 Instagram

通过 Rube MCP 使用 Composio 的 Instagram 工具包自动化 Instagram 操作。

前提条件

• 必须已连接 Rube MCP（可使用 RUBE_SEARCH_TOOLS）
• 通过 RUBE_MANAGE_CONNECTIONS 建立有效的 Instagram 连接，并使用工具包 instagram
• 始终先调用 RUBE_SEARCH_TOOLS 获取当前工具架构
• 必须使用 Instagram Business 或 Creator 账户（不支持个人账户）

设置

获取 Rube MCP：在客户端配置中将 https://rube.app/mcp 添加为 MCP 服务。MCP 端点仍需使用已安装的 Rube 服务返回的提供商连接和授权流程；仅添加 URL 不会授予账户访问权限。

1. 确认 RUBE_SEARCH_TOOLS 有响应，以验证 Rube MCP 可用
2. 使用工具包 instagram 调用 RUBE_MANAGE_CONNECTIONS
3. 如果连接状态不是 ACTIVE，请点击返回的授权链接，完成 Instagram/Facebook OAuth
4. 运行任何工作流前，确认连接状态为 ACTIVE

核心工作流

1. 创建单张图片/视频帖子

适用场景：用户想在 Instagram 发布单张照片或视频

工具调用顺序：

1. INSTAGRAM_GET_USER_INFO - 获取 Instagram 用户 ID［前置条件］
2. INSTAGRAM_CREATE_MEDIA_CONTAINER - 使用图片/视频 URL 创建媒体容器［必需］
3. INSTAGRAM_GET_POST_STATUS - 检查媒体容器是否已就绪［可选］
4. INSTAGRAM_CREATE_POST 或 INSTAGRAM_POST_IG_USER_MEDIA_PUBLISH - 发布容器［必需］

关键参数：

• image_url：要发布的图片的公开 URL
• video_url：要发布的视频的公开 URL
• caption：帖子说明文字
• ig_user_id：Instagram Business 账户用户 ID

注意事项：

• 媒体 URL 必须可公开访问；私有或需要身份验证的 URL 会导致失败
• 视频容器可能需要一些时间处理；发布前请轮询 GET_POST_STATUS
• 说明文字支持话题标签和提及，但长度限制为 2200 个字符
• 发布尚未完成处理的容器会返回错误

2. 创建轮播帖子

适用场景：用户想在单条轮播帖子中发布多张图片/视频

工具调用顺序：

1. INSTAGRAM_CREATE_MEDIA_CONTAINER - 为每个媒体项目分别创建容器［必需，每个项目重复调用］
2. INSTAGRAM_CREATE_CAROUSEL_CONTAINER - 创建轮播容器，并引用所有媒体容器［必需］
3. INSTAGRAM_GET_POST_STATUS - 检查轮播容器是否就绪［可选］
4. INSTAGRAM_POST_IG_USER_MEDIA_PUBLISH - 发布轮播［必需］

关键参数：

• children：轮播中媒体容器 ID 的数组
• caption：轮播帖子的说明文字
• ig_user_id：Instagram Business 账户用户 ID

注意事项：

• 轮播必须包含 2 到 10 个媒体项目；少于或多于此数量都会失败
• 创建轮播容器前，必须逐个创建所有子容器
• 创建轮播前，所有子容器都必须完成处理
• 轮播支持混合媒体（图片 + 视频）

3. 获取媒体和洞察数据

适用场景：用户想查看帖子或分析帖子表现

工具调用顺序：

1. INSTAGRAM_GET_IG_USER_MEDIA 或 INSTAGRAM_GET_USER_MEDIA - 列出用户的媒体［必需］
2. INSTAGRAM_GET_IG_MEDIA - 获取特定帖子的详细信息［可选］
3. INSTAGRAM_GET_POST_INSIGHTS 或 INSTAGRAM_GET_IG_MEDIA_INSIGHTS - 获取帖子的指标［可选］
4. INSTAGRAM_GET_USER_INSIGHTS - 获取账户级洞察数据［可选］

关键参数：

• ig_user_id：Instagram Business 账户用户 ID
• media_id：特定媒体帖子的 ID
• metric：要获取的指标（例如，展示次数、触达人数、互动量）
• period：洞察数据的时间范围（例如，天、周、终身）

注意事项：

• 只有 Business/Creator 账户才能查看洞察数据
• 某些指标要求至少拥有一定数量的关注者
• 洞察数据可能延迟最多 48 小时
• period 参数必须与指标类型匹配

4. 检查发布限制

适用场景：用户想在尝试发布前确认是否可以发布

工具调用顺序：

1. INSTAGRAM_GET_IG_USER_CONTENT_PUBLISHING_LIMIT - 检查剩余发布配额【必需】

关键参数：

• ig_user_id：Instagram Business 账户用户 ID

注意事项：

• Instagram 将限制设为每 24 小时滚动窗口内发布 25 条内容
• 发布限制按滚动窗口重置，而非在午夜重置
• 批量发布前检查限制，避免操作失败

5. 获取媒体评论和子项

适用场景：用户想查看帖子评论或轮播帖子的子项

工具调用顺序：

1. INSTAGRAM_GET_IG_MEDIA_COMMENTS - 列出媒体帖子的评论【必需】
2. INSTAGRAM_GET_IG_MEDIA_CHILDREN - 列出轮播帖子的子项【可选】

关键参数：

• media_id：媒体帖子的 ID
• ig_media_id：替代媒体 ID 参数

注意事项：

• 评论可能会分页；请使用分页游标获取完整结果
• 轮播子项会作为独立媒体对象返回
• 账户的评论审核设置会影响返回内容

常见模式

ID 解析

Instagram 用户 ID：

1. Call INSTAGRAM_GET_USER_INFO
2. Extract ig_user_id from response
3. Use in all subsequent API calls

媒体容器状态检查：

1. Call INSTAGRAM_CREATE_MEDIA_CONTAINER
2. Extract container_id from response
3. Poll INSTAGRAM_GET_POST_STATUS with container_id
4. Wait until status is 'FINISHED' before publishing

分两阶段发布

• 阶段 1：使用内容 URL 创建媒体容器
• 阶段 2：处理完成后发布容器
• 对于视频内容，务必在两个阶段之间检查容器状态
• 对于轮播，必须先完成所有子项的阶段 1，再创建轮播容器

已知注意事项

媒体 URL：

• 所有图片/视频 URL 都必须是可公开访问的 HTTPS URL
• 需要身份验证、受到 CDN 限制或要求使用 Cookie 的 URL 将无法使用
• 临时 URL（如预签名 S3 URL）可能会在处理完成前过期

速率限制：

• 每 24 小时滚动窗口内发布 25 条内容
• API 速率限制与发布限制分别适用
• 对 429 响应实施指数退避

账户要求：

• 仅支持 Business 或 Creator Instagram 账户
• 个人账户无法使用 Instagram Graph API
• 账户必须关联 Facebook Page

响应解析：

• 媒体 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

适用场景

此技能适用于执行概述中所述的工作流或操作。

限制

• 仅当任务明确符合上述范围时，才使用此技能。
• 不要将输出视为环境特定验证、测试或专家审核的替代品。
• 如果缺少必要的输入、权限、安全边界或成功标准，请暂停并请求澄清。

执行写入操作前，请确认准确的已连接账户、获批的媒体、说明文字以及发布时间或排期时间。账户资格和发布配额取决于当前的 API／登录模式；应查询当前的架构和限制，而不是使用历史固定配额。不得绕过账户要求或重新发布私人数据；重试前，请核对容器和发布结果。