Instagram Publisher
/install instagram-publisher
Boring Instagram Publisher
Publish photos, carousels, and Reels to Instagram. Powered by Boring.
Security & Data Handling
- MCP link is a credential: Your MCP Server URL (
https://boring.aiagent-me.com/mcp/t/xxxxx...) contains an embedded authentication token. Treat it like a password — do not share it publicly. - Token scope: The embedded token grants publish access to your connected social media accounts. It can create posts, upload media, and manage scheduled posts on the platforms you have connected. It cannot access your social media passwords or modify account settings.
- Token storage: The token is stored server-side in Boring's database (MongoDB on DigitalOcean). It is never written to your local filesystem. You can regenerate or revoke it anytime at boring.aiagent-me.com/settings.
- Data flow: Analytics queries are sent from Boring's server (Google Cloud, us-central1) to the platform's API on your behalf. Only performance metrics are retrieved — no content is uploaded or modified.
- No local credentials: No local API keys, environment variables, or secrets are needed. All auth is embedded in the MCP link.
- Third-party service: This skill relies on Boring, an open-source social media management tool. Source code: github.com/snoopyrain.
Prerequisites
- Sign up at boring.aiagent-me.com with Google
- Connect Instagram — requires an Instagram Business or Creator account (personal accounts not supported)
- Get your MCP link: Go to Settings → copy your MCP Server URL (contains your auth token — treat it like a password)
- Add to Claude: Paste the MCP link as a Connector — no install, no API key needed
Workflow
Step 1: List Accounts
Call boring_list_accounts and filter for instagram platform.
Step 2: Confirm Content
IMPORTANT: Instagram requires media. Text-only posts are NOT supported.
| Type | Media | Specs |
|---|---|---|
| Photo | 1 image | JPG/PNG, 320x320 to 1440x1440 |
| Carousel | 2-10 images | All images must have matching aspect ratios |
| Reels | 1 video | MP4, 9:16 vertical, up to 90 seconds |
- Caption: Up to 2,200 characters
- If the user only provides text with no media, inform them that Instagram requires at least one image or video
Step 3: Prepare Media
Media must be publicly accessible URLs:
- Local files:
boring_upload_filewithfile_path→ returns public URL - External URLs:
boring_upload_from_url→ re-hosts to Boring cloud storage - Google Drive links: Pass directly to
media_urls
Step 4: Publish or Schedule
Call boring_publish_post:
boring_publish_post(
account_id="\x3Cinstagram_account_id>",
platform="instagram",
text="Your caption here #hashtags",
media_urls=["https://...image.jpg"]
)
For carousel (2-10 images):
boring_publish_post(
account_id="\x3Cinstagram_account_id>",
platform="instagram",
text="Swipe to see more!",
media_urls=["https://...1.jpg", "https://...2.jpg", "https://...3.jpg"]
)
For Reels (video):
boring_publish_post(
account_id="\x3Cinstagram_account_id>",
platform="instagram",
text="Check out this Reel!",
media_urls=["https://...video.mp4"]
)
Schedule: Add scheduled_at in ISO 8601 format:
boring_publish_post(..., scheduled_at="2025-12-25T10:00:00Z")
Step 5: Report
Show the post ID and confirmation. If scheduled, show the scheduled time.
Managing Scheduled Posts
- View:
boring_list_scheduled_postswithplatform: "instagram" - Cancel:
boring_cancel_scheduled_postwithscheduled_post_id
Instagram-Specific Notes
- Media is mandatory — always need at least 1 image or video
- Carousel aspect ratios: All images in a carousel must have the same aspect ratio
- Reels: Vertical video (9:16), up to 90 seconds
- Token: 60-day long-lived token with auto-refresh
- Rate Limit: 200 calls/hour per user, 4,800/hour per app
- Permissions:
instagram_business_content_publish,instagram_business_basic
Error Handling
| Error | Solution |
|---|---|
MediaRequired |
Instagram requires media — ask user for an image or video |
InvalidCarouselSize |
Carousel needs 2-10 images |
CarouselCreationFailed |
Check that all images have the same aspect ratio |
MediaTooLarge |
Images max 8MB |
TokenExpired |
Reconnect at boring.aiagent-me.com |
Documentation
Full API docs: boring-doc.aiagent-me.com
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install instagram-publisher - 安装完成后,直接呼叫该 Skill 的名称或使用
/instagram-publisher触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
Instagram Publisher 是什么?
Publish posts to Instagram. Use when the user says 'post to Instagram', 'publish on IG', 'schedule Instagram post', 'create Instagram carousel', 'post a Reel... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 115 次。
如何安装 Instagram Publisher?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install instagram-publisher」即可一键安装,无需额外配置。
Instagram Publisher 是免费的吗?
是的,Instagram Publisher 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
Instagram Publisher 支持哪些平台?
Instagram Publisher 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Instagram Publisher?
由 snoopyrain(@snoopyrain)开发并维护,当前版本 v1.0.1。