Instagram Publisher

Publish Instagram images, Reels, and carousels, check publish status, and work with Instagram direct messages through bundled MyBrandMetrics scripts.

Use this skill when the user wants to publish to Instagram, post to IG, upload a Reel, create a carousel, publish a hosted media URL, publish a local media file, check an Instagram publish job, fetch recent Instagram DMs, or send an Instagram direct message.

Website: https://www.clawbus.com/
MyBrandMetrics API: https://mybrandmetrics.com/

Why This Instagram Publisher

Use this when you want Instagram publishing and messaging workflows without building a full Instagram backend yourself.

Core Capabilities

Setup Flow

1. Open https://mybrandmetrics.com/ and sign in with Google.
2. In MyBrandMetrics, open Data sources.
3. Connect Instagram Insights as a data source.
4. Wait until the MyBrandMetrics connection is ready.
5. Get the MyBrandMetrics API key, Instagram connection ID, and Instagram account ID from MyBrandMetrics.
6. Install the instagram-publish skill.
7. Provide credentials through command-line arguments, environment variables, or a workspace config.json.
8. Start an image, Reel, carousel, publish-status, or direct-message workflow with natural-language instructions or direct scripts.

Messaging scripts only require the API key and connection ID. Publishing scripts also require the account ID.

Credential Options

The scripts load credentials in this order:

1. Command-line arguments such as --api-key, --connection-id, and --account-id.
2. Environment variables: INSTAGRAM_API_KEY, INSTAGRAM_AUTHORIZATION_TOKEN, INSTAGRAM_CONNECTION_ID, INSTAGRAM_ACCOUNT_ID, and optionally INSTAGRAM_PUBLISH_CONFIG.
3. A workspace config.json file with an instagram object.

Example config.json:

{
  "instagram": {
    "authorization_token": "YOUR_API_KEY",
    "connection_id": "YOUR_CONNECTION_ID",
    "account_id": "YOUR_ACCOUNT_ID"
  }
}

Do not commit real API keys, connection IDs, or account IDs.

Workflow

Use natural-language prompts in chat after the skill is installed. Include:

• the task: publish, check status, fetch messages, or send a message;
• the media URL, local file path, or carousel item list;
• the post type when it is not obvious: IMAGE, REELS, or CAROUSEL;
• the caption;
• whether a Reel should be shared to feed;
• the publish ID for status checks;
• the message conversation_id and message text for DM replies.

Before publishing, confirm the Instagram account, media source, post type, and caption. For carousels, review every item before posting. For direct messages, confirm the target conversation_id and exact message text.

Instagram direct messaging is subject to Meta platform policy and messaging-window limits. If the API returns a policy error, show the real response instead of retrying indefinitely.

Use The Scripts Directly

Use scripts/publish_instagram.py for publishing and status checks.

Single image from URL:

python3 scripts/publish_instagram.py \
  --type IMAGE \
  --url "https://example.com/image.jpg" \
  --caption "Hello World!"

Reel from local file:

python3 scripts/publish_instagram.py \
  --type REELS \
  --path "/path/to/video.mp4" \
  --caption "Check this out!" \
  --thumb-offset 1000

Mixed carousel:

python3 scripts/publish_instagram.py \
  --type CAROUSEL \
  --items "/path/to/img1.jpg" "https://example.com/video2.mp4" \
  --caption "My Carousel"

Check publish status:

python3 scripts/publish_instagram.py \
  --check-id "PUBLISH_ID"

Fetch recent direct messages:

python3 scripts/receive_messages.py \
  --limit 25

Send a direct message:

python3 scripts/send_message.py \
  --conversation-id "CONVERSATION_ID" \
  --message "Thanks for reaching out!"

Parameters

Reference Files

The scripts print the real JSON response from the MyBrandMetrics API. Treat that response as the source of truth; do not fabricate publish IDs, media container IDs, message IDs, or success states.