mcpField
I
instagram-automation

instagram-automation

github.com/davepoon营销与增长3.7k152 次安装2 天前更新
代码仓库

关于 instagram-automation

面向 Instagram Business 或 Creator 账户的自动化技能,通过 Rube MCP 和 Composio 工具包发布内容、查看媒体与分析数据。支持单图、视频及轮播帖子。

主要功能

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

适用场景

  1. 01发布 Instagram 图片或视频
  2. 02组合多项媒体发布轮播
  3. 03查看帖子触达和互动指标
  4. 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 密钥——只需添加该端点即可使用。

  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