关于 instagram-automation
面向 Instagram Business 或 Creator 账户的自动化技能,通过 Rube MCP 和 Composio 工具包发布内容、查看媒体与分析数据。支持单图、视频及轮播帖子。
主要功能
- 01发布图片和视频帖子
- 02创建多媒体轮播帖子
- 03查看媒体及账户分析
- 04检查发布额度
- 05获取帖子评论和轮播内容
适用场景
- 01发布 Instagram 图片或视频
- 02组合多项媒体发布轮播
- 03查看帖子触达和互动指标
- 04检查帖子评论
MCP 相关
通过 Rube MCP 调用 Composio 的 Instagram 工具包。需连接 Instagram Business 或 Creator 账户,并先获取当前工具架构。
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ davepoon/ buildwithclaude --skill instagram-automation安装后在 Claude Code 中输入/instagram-automation确认已加载。
详细介绍
通过 Rube MCP 自动化 Instagram
通过 Rube MCP 使用 Composio 的 Instagram 工具包自动化 Instagram 操作。
工具包文档:composio.dev/toolkits/instagram
前置条件
- 必须已连接 Rube MCP(可使用 RUBE_SEARCH_TOOLS)
- 通过
RUBE_MANAGE_CONNECTIONS建立有效的 Instagram 连接,并使用工具包instagram - 始终先调用
RUBE_SEARCH_TOOLS,以获取当前工具架构 - 需要 Instagram Business 或 Creator 账户(不支持个人账户)
设置
获取 Rube MCP:在客户端配置中将 https://rube.app/mcp 添加为 MCP 服务。不需要 API 密钥——只需添加该端点即可使用。
- 确认
RUBE_SEARCH_TOOLS能正常响应,以验证 Rube MCP 是否可用 - 使用工具包
instagram调用RUBE_MANAGE_CONNECTIONS - 如果连接状态不是 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:要发布的图片的公开 URLvideo_url:要发布的视频的公开 URLcaption:帖子说明文字ig_user_id:Instagram Business 账户用户 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 Business 账户用户 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:Instagram Business 账户用户 IDmedia_id:特定媒体帖子的 IDmetric:要获取的指标(例如,展示次数、覆盖人数、互动量)period:洞察数据的时间段(例如,day、week、lifetime)
注意事项:
- 只有 Business/Creator 账户才能查看洞察数据
- 某些指标要求达到最低粉丝数
- 洞察数据最长可能延迟 48 小时
period参数必须与指标类型匹配
4. 检查发布限制
使用场景:用户想在尝试发布内容前,确认自己是否可以发布
工具调用顺序:
INSTAGRAM_GET_IG_USER_CONTENT_PUBLISHING_LIMIT- 检查剩余发布额度[必需]
关键参数:
ig_user_id:Instagram 商业账号用户 ID
注意事项:
- Instagram 将 24 小时滚动窗口内的发布数量限制为 25 条
- 发布限制按滚动方式重置,而非在午夜重置
- 批量发布前检查限制,避免失败
5. 获取媒体评论和子项
使用场景:用户想查看帖子的评论或轮播帖子的子项
工具调用顺序:
INSTAGRAM_GET_IG_MEDIA_COMMENTS- 列出媒体帖子上的评论[必需]INSTAGRAM_GET_IG_MEDIA_CHILDREN- 列出轮播帖子的子项[可选]
关键参数:
media_id:媒体帖子的 IDig_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 响应采用指数退避机制
账号要求:
- 仅支持 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 |
由 Composio 提供支持
评论
支持 Markdown