instagram-post

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Instagram Post

Instagram发帖

Create and schedule Instagram posts using the Publora MCP server. Supports image posts, carousels (2-10 images), Reels, and Stories. Requires an Instagram Business account.

使用Publora MCP服务器创建并排期Instagram帖子，支持图片帖、轮播帖（2-10张图片）、Reels和Stories。需使用Instagram商业账户。

Prerequisites

前置要求

Plans: Free Starter (15 posts/month), Pro, Premium

套餐： 免费入门版（每月15条帖子）、专业版、高级版

Getting Started

入门指南

Create account at publora.com/register (free)
Convert to Business account in Instagram settings (Personal and Creator accounts are NOT supported by the API)
Connect Instagram via OAuth in Publora Dashboard
Get API key at publora.com/settings/api
Configure MCP in Claude Desktop (
```
~/.claude/claude_desktop_config.json
```
):

json

{
  "mcpServers": {
    "publora": {
      "type": "http",
      "url": "https://mcp.publora.com",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

创建账户 前往 publora.com/register 注册（免费）
转换为商业账户 在Instagram设置中完成操作（API不支持个人账户和创作者账户）
关联Instagram账户 在Publora仪表盘中通过OAuth完成关联
获取API密钥 前往 publora.com/settings/api 领取
配置MCP 在Claude Desktop中修改配置文件（路径
```
~/.claude/claude_desktop_config.json
```
）：

json

{
  "mcpServers": {
    "publora": {
      "type": "http",
      "url": "https://mcp.publora.com",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

REST API Fallback

REST API备选方案

If the MCP server is unavailable or returns errors, use the REST API directly:

Base URL:

https://api.publora.com/api/v1

Authentication: Use

x-publora-key

header (NOT

Authorization: Bearer

bash

undefined

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

基础URL：

https://api.publora.com/api/v1

身份验证： 使用

x-publora-key

请求头（不要使用

Authorization: Bearer

）：

bash

undefined

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" }'


**Platform ID Format:** `instagram-{id}` where `{id}` is from `/platform-connections` response.

Example IDs: `instagram-11223344`, `instagram-55667788`

📖 **Full API documentation:** [docs.publora.com](https://docs.publora.com)


**平台ID格式：** `instagram-{id}`，其中`{id}`来自`/platform-connections`接口的返回结果。

示例ID：`instagram-11223344`、`instagram-55667788`

📖 **完整API文档：** [docs.publora.com](https://docs.publora.com)

Plan Limits

套餐额度

Plan	Posts/month	Price
Starter	15	Free
Pro	100/account	$2.99/account/month
Premium	500/account	$9.99/account/month

套餐	每月发帖数	价格
入门版	15	免费
专业版	每个账户100条	每个账户每月2.99美元
高级版	每个账户500条	每个账户每月9.99美元

Platform Limits (API vs Native App)

平台限制（API vs 原生应用）

These limits are specific to the Instagram Graph API and differ from native app limits:

以下限制为Instagram Graph API特有，与原生应用限制不同：

Images

图片

Feature	API Limit
Formats	JPEG only (PNG is NOT supported and will fail!)
Max file size	8 MB
Carousel images	2-10 (native app allows 20)
Aspect ratios	4:5 (portrait) to 1.91:1 (landscape)

功能	API限制
格式	仅支持JPEG（不支持PNG，上传会失败！）
最大文件大小	8 MB
轮播帖图片数量	2-10张（原生应用支持20张）
宽高比	4:5（竖版）到1.91:1（横版）

Videos

视频

Feature	Reels	Stories	Carousel Videos
Max duration	15 minutes (only 5-90s eligible for Reels tab)	60 seconds	60 seconds
Min duration	3 seconds	3 seconds	3 seconds
Max file size	300 MB	100 MB	300 MB
Formats	MP4, MOV	MP4, MOV	MP4, MOV

功能	Reels	Stories	轮播帖视频
最大时长	15分钟（仅5-90秒的内容有资格进入Reels推荐池）	60秒	60秒
最小时长	3秒	3秒	3秒
最大文件大小	300 MB	100 MB	300 MB
格式	MP4、MOV	MP4、MOV	MP4、MOV

Captions

文案

Feature	Limit
Caption length	2,200 characters
Visible before "more"	First 125 characters
Hashtags	30 per post (included in caption)

功能	限制
文案长度	2200字符
「更多」按钮前可见内容	前125字符
话题标签数量	每篇帖子最多30个（包含在文案内）

Rate Limits

频率限制

50 posts per 24 hours (some accounts report 25)

每24小时最多发50条帖子（部分账户反馈限制为25条）

Available Tools

可用工具

create_post

Create a new Instagram post.

Parameters:

```
platforms
```
: Array with your Instagram connection ID (e.g.,
```
["instagram-11223344"]
```
)
```
content
```
: Caption text (up to 2,200 characters)
```
scheduledTime
```
: ISO 8601 datetime (required - for immediate posting, use current time + 1 minute)

创建新的Instagram帖子。

参数：

```
platforms
```
：包含你的Instagram关联ID的数组（例如
```
["instagram-11223344"]
```
）
```
content
```
：文案内容（最多2200字符）
```
scheduledTime
```
：ISO 8601格式时间（必填 - 如需立即发布，使用当前时间加1分钟）

get_upload_url

Get presigned URL for media uploads.

Parameters:

```
postGroupId
```
: Post ID to attach media to
```
fileName
```
: File name (e.g., "photo.jpg")
```
contentType
```
: Must be
```
image/jpeg
```
for images,
```
video/mp4
```
for video
```
type
```
:
```
"image"
```
or
```
"video"
```

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

参数：

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

list_posts / update_post / delete_post

Manage scheduled and draft posts.

管理已排期和草稿状态的帖子。

Video Type Settings (via REST API)

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

Control how videos are published via

platformSettings

json

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

Setting	Values	Default	Description
`videoType`	`"REELS"` , `"STORIES"`	`"REELS"`	Determines how videos are published

Note:

platformSettings

is not available via MCP - use REST API for video type control.

通过

platformSettings

控制视频的发布形式：

json

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

设置项	可选值	默认值	说明
`videoType`	`"REELS"` 、 `"STORIES"`	`"REELS"`	决定视频的发布形式

注意：MCP不支持

platformSettings

参数 - 如需控制视频类型，请使用REST API。

Examples

示例

Single Image Post

单图帖子

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

[Attach JPEG image]

Important: Image must be JPEG format. PNG will be rejected.

将以下内容发布到Instagram：
"清晨咖啡+代码，开启一天的最佳方式。#devlife #coding"

[附上JPEG图片]

重要提示： 图片必须为JPEG格式，PNG会被拒绝。

Carousel Post

轮播帖

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

Note: Requires 2-10 JPEG images. Cannot mix images and videos in carousels.

用这5张产品截图创建Instagram轮播帖。
文案："我们的应用6个月的演进过程，滑动查看成长历程！#buildinpublic"

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

Reel

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

Videos default to Reels. Set

videoType: "STORIES"

via REST API for Stories.

将此视频作为Reels发布：
"我们新功能的60秒教程。#tutorial #app"

视频默认发布为Reels，如需发布为Stories，请通过REST API设置

videoType: "STORIES"

。

Story

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

Requires

platformSettings.instagram.videoType: "STORIES"

via REST API.

将这个30秒的片段作为Story发布（24小时后会自动消失）。

需要通过REST API设置

platformSettings.instagram.videoType: "STORIES"

。

Scheduled Post

排期帖子

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

将内容排期到明天上午10点发布：
"新功能即将发布，敬请期待！"
[附上JPEG图片]

Important Restrictions

重要限制

JPEG only for images: PNG, GIF, WebP are NOT supported by the Instagram API. Convert to JPEG before uploading.
Business account required: Personal and Creator accounts cannot post via API. Only Business accounts work.
Media required on every post: Instagram does not support text-only posts. Every post needs at least one image or video.
No mixed media in carousels: A carousel must be either all images OR all videos (via separate posts), not both.
Stories disappear: Stories are ephemeral and disappear after 24 hours.
Reel is the default: Videos are published as Reels by default. To post a Story, use the REST API with
```
videoType: "STORIES"
```
.

图片仅支持JPEG： Instagram API不支持PNG、GIF、WebP格式，上传前请转换为JPEG。
需使用商业账户： 个人账户和创作者账户无法通过API发帖，仅商业账户支持。
每篇帖子必须包含媒体： Instagram不支持纯文字帖子，每篇帖子至少需要一张图片或一个视频。
轮播帖不能混合媒体类型： 轮播帖必须全为图片或全为视频（需分开发布），不能同时包含两者。
Stories会自动消失： Stories为临时内容，发布24小时后会自动消失。
默认发布为Reels： 视频默认发布为Reels，如需发布为Story，请使用REST API并设置
```
videoType: "STORIES"
```
。

Best Practices

最佳实践

Content

内容

First 125 chars matter: This is what users see before tapping "more"
Hashtag strategy: Use 5-15 relevant hashtags (max 30)
Image quality: Use high-quality JPEG images for best results
Carousel engagement: Carousels get higher engagement than single images

前125字符很重要： 这是用户点击「更多」按钮前能看到的内容
话题标签策略： 使用5-15个相关话题标签（最多30个）
图片质量： 使用高质量JPEG图片可获得最佳效果
轮播帖互动性更高： 轮播帖的互动率高于单图帖子

Timing

发布时间

Best times: 11 AM - 1 PM, 7 PM - 9 PM in target timezone
Frequency: 1-2 posts per day for growth
Reels boost: Reels get algorithmic preference over static images

最佳发布时间： 目标时区的上午11点到下午1点，晚上7点到9点
发布频率： 每天发布1-2条更利于账号增长
Reels流量扶持： 算法对Reels的推荐权重高于静态图片

Engagement

互动

Reply to comments within the first hour
Use location tags when relevant
Cross-promote from Stories to Feed

发布后一小时内回复评论
相关内容可添加位置标签
可通过Stories向主页帖子导流

Troubleshooting

故障排查

Error	Cause	Solution
"Business account required"	Using Personal/Creator account	Convert to Business account in Instagram settings
"Invalid image format"	PNG or other non-JPEG format	Convert image to JPEG before uploading
"Media upload failed"	File too large or wrong format	Check: images < 8 MB JPEG, videos < 300 MB MP4
"Carousel requires 2-10 items"	Wrong number of images	Ensure 2-10 images for carousel
"Account not connected"	OAuth expired	Reconnect via Publora dashboard
Rate limit (429)	Exceeded 50 posts/day	Wait 24 hours

错误信息	原因	解决方案
"Business account required"	使用了个人账户/创作者账户	在Instagram设置中转换为商业账户
"Invalid image format"	使用了PNG或其他非JPEG格式	上传前将图片转换为JPEG格式
"Media upload failed"	文件过大或格式错误	检查：图片小于8MB且为JPEG格式，视频小于300MB且为MP4格式
"Carousel requires 2-10 items"	图片数量不符合要求	轮播帖需包含2-10张图片
"Account not connected"	OAuth授权已过期	通过Publora仪表盘重新关联账户
频率限制（429错误）	超过每日50条的发帖限制	等待24小时后再尝试