instagram-post
Use when the user wants to post or schedule to Instagram through Publora: a single image, a 2-10 image carousel, a Reel or a Story. Requires a Business account and JPEG images; PNG and text-only posts are rejected by the API. Not for Threads (use threads-post).
publora · 已有 AI 审核记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add publora/skills --skill instagram-post技能说明
name: instagram-post description: Use when the user wants to post or schedule to Instagram through Publora: a single image, a 2-10 image carousel, a Reel or a Story. Requires a Business account and JPEG images; PNG and text-only posts are rejected by the API. Not for Threads (use threads-post).
Instagram Post
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.
Prerequisites
Plans: Works on the free Starter plan. Current limits and pricing: publora.com/pricing.
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 app.publora.com/dashboard/api
- Connect your agent to the MCP server at
https://mcp.publora.com, authenticating withAuthorization: Bearer sk_YOUR_API_KEY. In Claude Code:
claude mcp add publora --transport http https://mcp.publora.com \
--header "Authorization: Bearer sk_YOUR_API_KEY"
Claude Desktop, Cursor, Codex, OpenClaw and the claude.ai connector each need a different config file or flow: see client setup for the exact path and snippet.
REST API Fallback
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):
# 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
Platform Limits (API vs Native App)
These limits are specific to the Instagram Graph API and differ from native app limits:
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) |
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 |
Captions
| Feature | Limit |
|---|---|
| Caption length | 2,200 characters |
| Visible before "more" | First 125 characters |
| Hashtags | 30 per post (included in caption) |
Rate Limits
- 50 posts per 24 hours (some accounts report 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 UTC datetime. Optional: omit it and the post is created as a draft. Send a future time to schedule. A time five or more minutes in the past is rejected withSCHEDULED_TIME_IN_PAST, so for immediate posting use the current time plus a minute.mediaUrls: up to 10 public https image or video URLs. Publora downloads them server-side and attaches them before validation, so media and scheduling happen in one call. This is the one-shot alternative to the draft thenget_upload_urlthencomplete_mediaflow. Ingestion is rate-limited to 60 URLs per hour.
get_upload_url
Get presigned URL for media uploads.
Parameters:
postGroupId: Post ID to attach media tofileName: File name (e.g., "photo.jpg")contentType: Must beimage/jpegfor images,video/mp4for videotype:"image"or"video"
complete_media
Finalize a file uploaded through get_upload_url, after the presigned PUT succeeds. Optional, because scheduling also finalizes pending media, but calling it early surfaces format and probe errors before publish. Not needed for media attached with mediaUrls.
Parameters:
mediaId: the id returned byget_upload_url
list_connections
List your connected accounts with their platform IDs. Call this first and copy the IDs verbatim; they are never guessable.
list_posts / get_post / update_post / delete_post
Manage scheduled and draft posts. update_post also patches content and platforms on a draft or scheduled post, so fixing a typo or retargeting no longer means delete and recreate. delete_media and prune_media_reference clean up uploaded files.
Video Type Settings (via REST API)
Control how videos are published via platformSettings:
{
"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.
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
阅读完整来源 ↗