instagram-post

Instagram 贴文

使用 Publora MCP 服务创建和安排 Instagram 贴文。支持图片贴文、轮播（2-10 张图片）、Reels 和快拍。需要 Instagram Business 账号。

前提条件

套餐： 免费 Starter 套餐即可使用。当前限制和价格：publora.com/pricing。

开始使用

1. 创建账号：publora.com/register（免费）
2. 转换为 Business 账号：在 Instagram 设置中进行转换（API 不支持 Personal 和 Creator 账号）
3. 连接 Instagram：通过 Publora Dashboard 进行 OAuth 授权
4. 获取 API 密钥：前往 app.publora.com/dashboard/api，仅当你的 Agent 无法通过 OAuth 登录，或你要使用下方的 REST API 备用方案时才需要
5. 将 Agent 连接到 MCP 服务：https://mcp.publora.com/mcp：
   • 升级不带 /mcp 的手动连接： Claude 会将 https://mcp.publora.com 视为与捆绑版本不同的服务。请在当前作用域中将现有连接改为 https://mcp.publora.com/mcp，保留其身份验证和所选账号；如有提示，请重新登录。或者，确认捆绑的连接使用的是预期账号，然后仅移除旧的手动条目。不要添加第二个条目，也不要自动删除凭据。
   • 已可使用 Publora 工具（publora-skills 插件或 Claude 中的 Publora 连接器）：无需设置。Claude 首次运行工具时会提示你登录 Publora。
   • 支持 OAuth 的 Agent（Claude Code、Cursor，以及 Claude 和 ChatGPT 应用）：按 URL 添加服务并登录，无需 API 密钥。在 Claude Code 中，添加服务后运行 /mcp 登录：

claude mcp add --transport http --scope user publora https://mcp.publora.com/mcp

• **不支持 OAuth 的 Agent：**将 API 密钥作为 Authorization: Bearer sk_YOUR_API_KEY 发送：

claude mcp add --transport http --scope user publora https://mcp.publora.com/mcp \
  --header "Authorization: Bearer sk_YOUR_API_KEY"

Claude Desktop、Cursor、Codex、OpenClaw 和 claude.ai 连接器各自需要不同的配置文件或流程：确切路径和代码片段请参阅客户端设置。

REST API 备用方案

如果 MCP 服务不可用或返回错误，请直接使用 REST API：

基础 URL： https://api.publora.com/api/v1

**身份验证：**使用 x-publora-key 标头（不要使用 Authorization: Bearer）：

# Get your connected platforms
curl -X GET "https://api.publora.com/api/v1/platform-connections" \
  -H "x-publora-key: sk_your_api_key"

# Create a post
curl -X POST "https://api.publora.com/api/v1/create-post" \
  -H "x-publora-key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "platforms": ["instagram-11223344"],
    "content": "Your caption here #hashtag",
    "scheduledTime": "2026-03-25T10:00:00Z"
  }'

平台 ID 格式： instagram-{id}，其中 {id} 来自 /platform-connections 响应。

ID 示例：instagram-11223344、instagram-55667788

📖 完整 API 文档：docs.publora.com

平台限制（API 与原生应用对比）

这些限制仅适用于 Instagram Graph API，与原生应用的限制不同：

图片

功能	API 限制
格式	JPEG、PNG、WebP（WebP 会自动转换）。不接受动画 GIF、BMP 和 TIFF。
最大文件大小	8 MB
轮播图片	2-10 张（原生应用最多允许 20 张）
宽高比	4:5（竖版）至 1.91:1（横版）

视频

功能	Reels	快拍	轮播视频
最长时长	15 分钟（只有 5-90 秒的视频符合 Reels 标签页的要求）	60 秒	60 秒
最短时长	3 秒	3 秒	3 秒
最大文件大小	300 MB	100 MB	300 MB
格式	MP4、MOV	MP4、MOV	MP4、MOV

说明文字

功能	限制
说明文字长度	2,200 个字符
点击“更多”前可见	前 125 个字符
主题标签	每条贴文最多 30 个（计入说明文字）

速率限制

• 每 24 小时最多发布 50 条贴文（部分账号报告的限制为 25 条）

可用工具

create_post

创建新的 Instagram 帖子。

参数：

• platforms：包含你的 Instagram 连接 ID 的数组（例如，["instagram-11223344"]）
• content：说明文字（最多 2,200 个字符）
• scheduledTime：ISO 8601 UTC 日期时间。可选：省略此项可将帖子创建为草稿。发送未来时间可安排发布。早于当前时间五分钟或以上的时间会被拒绝，并返回 SCHEDULED_TIME_IN_PAST，因此如需立即发布，请使用当前时间加一分钟。
• mediaUrls：最多 10 个公开的 https 图片或视频 URL。Publora 会在验证前于服务端下载并附加这些媒体，因此媒体处理和排期可在一次调用中完成。这是“先创建草稿，再调用 get_upload_url，然后调用 complete_media”流程的一步式替代方案。每小时最多接收 60 个 URL。

get_upload_url

获取媒体上传的预签名 URL。

参数：

• postGroupId：要附加媒体的帖子 ID
• fileName：文件名（例如，"photo.jpg"）
• contentType：图片必须为 image/jpeg，视频必须为 video/mp4
• type："image" 或 "video"

complete_media

在预签名 PUT 成功后，完成通过 get_upload_url 上传的文件。此操作为可选，因为排期时也会完成待处理媒体；但提前调用可在发布前显示格式和探测错误。通过 mediaUrls 附加的媒体无需调用此操作。

参数：

• mediaId：get_upload_url 返回的 ID

list_connections

列出已连接的账号及其平台 ID。请先调用此工具，并原样复制这些 ID；它们无法猜出。

list_posts / get_post / update_post / delete_post

管理已排期和草稿帖子。update_post 还可以修改草稿或已排期帖子的 content 和 platforms，因此，修正拼写错误或更改发布目标不再需要删除并重新创建。delete_media 和 prune_media_reference 可用于清理已上传的文件。

视频类型设置（通过 REST API）

通过 platformSettings 控制视频的发布方式：

{
  "platformSettings": {
    "instagram": {
      "videoType": "REELS"
    }
  }
}

设置	值	默认值	描述
videoType	"REELS"、"STORIES"	"REELS"	决定视频的发布方式

注意：MCP create_post 和 update_post 工具以及 REST 均接受 platformSettings。其架构是严格的：拼写错误的平台名称或键会导致验证错误，而不会被静默忽略。

示例

单图帖子

Post this to Instagram:
"Morning coffee and code. Best way to start the day. #devlife #coding"

[Attach JPEG image]

格式： JPEG、PNG 和 WebP 均可使用；WebP 会在发布前转换。

轮播帖子

Create an Instagram carousel with these 5 product screenshots.
Caption: "Our app evolution over 6 months. Swipe to see the journey! #buildinpublic"

注意：需要 2–10 张 JPEG 图片。轮播帖子不能混合图片和视频。

Reel

Post this video as a Reel:
"60-second tutorial on our new feature. #tutorial #app"

视频默认发布为 Reel。通过 REST API 设置 videoType: "STORIES" 可发布为 Story。

Story

Post this 30-second clip as a Story (will disappear after 24 hours).

需要通过 REST API 设置 platformSettings.instagram.videoType: "STORIES"。

定时发布的帖子

Schedule this for tomorrow at 10 AM:
"New feature announcement coming soon! Stay tuned."
[Attach JPEG image]

重要限制

1. 不接受动画 GIF、BMP 和 TIFF。 支持 JPEG、PNG 和 WebP，其中 WebP 会自动转换。

2. 需要商业账号：个人账号和创作者账号无法通过 API 发布。只有商业账号可用。

3. 每个帖子都必须包含媒体：Instagram 不支持纯文本帖子。每个帖子至少需要一张图片或一个视频。

4. 轮播帖子不能混合媒体类型：轮播帖子必须全部为图片或全部为视频（通过单独的帖子发布），不能两者兼有。

5. Story 会消失：Story 为临时内容，会在 24 小时后消失。

6. Reel 是默认类型：视频默认发布为 Reel。如需发布 Story，请使用 REST API 并设置 videoType: "STORIES"。

最佳实践

内容

1. 开头 125 个字符很重要：这是用户点击“更多”前看到的内容
2. 话题标签策略：使用 5–15 个相关话题标签（最多 30 个）
3. 图片质量：使用高质量 JPEG 图片以获得最佳效果
4. 轮播互动率：轮播帖子的互动率高于单图帖子

发布时机

• 最佳时段：目标时区上午 11 点 - 下午 1 点、晚上 7 点 - 9 点
• 发布频率：每天发布 1-2 条内容以实现增长
• Reels 加成：与静态图片相比，Reels 更受算法青睐

互动

• 在第一小时内回复评论
• 相关时添加位置标签
• 在快拍中交叉推广动态

故障排除

错误	原因	解决方案
"Business account required"	使用的是个人/创作者账户	在 Instagram 设置中将账户转换为商业账户
"Invalid image format"	使用了 PNG 或其他非 JPEG 格式	上传前将图片转换为 JPEG
"Media upload failed"	文件过大或格式错误	检查：图片应为小于 8 MB 的 JPEG，视频应为小于 300 MB 的 MP4
"Carousel requires 2-10 items"	图片数量错误	确保轮播内容包含 2-10 张图片
"Account not connected"	OAuth 已过期	通过 Publora 控制面板重新连接
Rate limit (429)	超过每天 50 条内容的限制	等待 24 小时