mcpField
I
instagram-automation

instagram-automation

github.com/composiohq营销与增长78.4k105 次安装14 周前更新
代码仓库

关于 instagram-automation

面向营销人员和账号运营者的 Instagram 自动化技能,通过 Rube MCP 和 Composio Instagram 工具包处理发布、数据洞察、评论及额度检查。

主要功能

  1. 01发布图片和视频帖子
  2. 02创建轮播帖子
  3. 03查看媒体和账号洞察
  4. 04检查发布额度
  5. 05获取评论和轮播内容

适用场景

  1. 01发布带说明文字的图片或视频
  2. 02将多项媒体合并为轮播帖子
  3. 03查看帖子表现和账号指标
  4. 04检查评论并准备回复

MCP 相关

通过 Rube MCP 调用 Composio 的 Instagram 工具包,需要已连接的 Instagram 商业或创作者账号。

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/composiohq/awesome-claude-skills --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 密钥——只需添加该端点即可使用。

  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:洞察数据的时间段(例如,day、week、lifetime)

注意事项:

  • 只有 Business/Creator 账户才能查看洞察数据
  • 某些指标要求达到最低粉丝数
  • 洞察数据最长可能延迟 48 小时
  • period 参数必须与指标类型匹配
4. 检查发布限制

使用场景:用户想在尝试发布内容前,确认自己是否可以发布

工具调用顺序:

  1. INSTAGRAM_GET_IG_USER_CONTENT_PUBLISHING_LIMIT - 检查剩余发布额度[必需]

关键参数:

  • ig_user_id:Instagram 商业账号用户 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 响应采用指数退避机制

账号要求:

  • 仅支持 Instagram 商业账号或创作者账号
  • 个人账号无法使用 Instagram Graph API
  • 账号必须关联 Facebook Page

响应解析:

  • 媒体 ID 是数字字符串
  • 洞察数据可能嵌套在不同的响应键下
  • 分页使用基于游标的令牌

快速参考

任务工具标识关键参数
获取用户信息INSTAGRAM_GET_USER_INFO(无)
创建媒体容器INSTAGRAM_CREATE_MEDIA_CONTAINERimage_url/video_url, caption
创建轮播容器INSTAGRAM_CREATE_CAROUSEL_CONTAINERchildren, caption
发布帖子INSTAGRAM_CREATE_POSTig_user_id, creation_id
发布媒体INSTAGRAM_POST_IG_USER_MEDIA_PUBLISHig_user_id, creation_id
检查帖子状态INSTAGRAM_GET_POST_STATUSig_container_id
列出用户媒体INSTAGRAM_GET_IG_USER_MEDIAig_user_id
获取媒体详情INSTAGRAM_GET_IG_MEDIAig_media_id
获取帖子洞察INSTAGRAM_GET_POST_INSIGHTSmedia_id, metric
获取用户洞察INSTAGRAM_GET_USER_INSIGHTSig_user_id, metric, period
获取发布限制INSTAGRAM_GET_IG_USER_CONTENT_PUBLISHING_LIMITig_user_id
获取媒体评论INSTAGRAM_GET_IG_MEDIA_COMMENTSig_media_id
获取轮播子项INSTAGRAM_GET_IG_MEDIA_CHILDRENig_media_id

由 Composio 提供支持

评论

支持 Markdown