✓ Verified ✍️ Content Creation ✓ Enhanced Data

Metricool

Schedule and manage social media posts via Metricool API.

Rating: 3.9 (306 reviews)
Downloads: 20,441 downloads
Version: 1.0.0

Overview

Schedule and manage social media posts via Metricool API.

Complete Documentation

View Source →

Metricool Integration

Schedule posts to multiple social platforms through Metricool's API.

Setup

Get your Metricool API token from the Metricool dashboard.

Add environment variables in ~/.moltbot/moltbot.json:

json

{
  "env": {
    "vars": {
      "METRICOOL_USER_TOKEN": "your-api-token",
      "METRICOOL_USER_ID": "[email protected]"
    }
  }
}

Or in your workspace .env:

text

METRICOOL_USER_TOKEN=your-api-token
[email protected]

Scripts

Get Brands

List connected brands and their blog IDs:

bash

node skills/metricool/scripts/get-brands.js
node skills/metricool/scripts/get-brands.js --json

Schedule a Post

bash

node skills/metricool/scripts/schedule-post.js '{
  "platforms": ["linkedin", "x", "bluesky", "threads", "instagram"],
  "text": "Your post text here",
  "datetime": "2026-01-30T09:00:00",
  "timezone": "America/New_York",
  "blogId": "YOUR_BLOG_ID"
}'

Parameters:

platforms: Array — linkedin, x, bluesky, threads, instagram, facebook
text: String or object with per-platform text (see below)
datetime: ISO datetime for scheduling
timezone: Timezone (default: America/Chicago)
imageUrl: Optional publicly accessible image URL
blogId: Brand ID from get-brands.js

Per-platform text:

json

{
  "text": {
    "linkedin": "Full LinkedIn post with more detail...",
    "x": "Short X post under 280 chars",
    "bluesky": "Bluesky version under 300 chars",
    "threads": "Threads version under 500 chars",
    "instagram": "Instagram with #hashtags"
  }
}

List Scheduled Posts

bash

node skills/metricool/scripts/list-scheduled.js
node skills/metricool/scripts/list-scheduled.js --start 2026-01-30 --end 2026-02-05

Get Best Time to Post

bash

node skills/metricool/scripts/best-time.js linkedin
node skills/metricool/scripts/best-time.js x

Character Limits

Platform	Limit
LinkedIn	3,000
X/Twitter	280
Bluesky	300
Threads	500
Instagram	2,200

Image Requirements

Must be publicly accessible URL (S3, GCS, etc.)
Recommended formats: PNG, JPG
Square images work best for Instagram/Threads
Wide images (1.91:1) work best for X/LinkedIn

Installation

Terminal bash


openclaw install metricool

Copied!

💻Code Examples

Add environment variables in `~/.moltbot/moltbot.json`:

add-environment-variables-in-moltbotmoltbotjson.json

{
  "env": {
    "vars": {
      "METRICOOL_USER_TOKEN": "your-api-token",
      "METRICOOL_USER_ID": "[email protected]"
    }
  }
}

Or in your workspace `.env`:

or-in-your-workspace-env.txt

METRICOOL_USER_TOKEN=your-api-token
[email protected]

}'

.txt

**Parameters:**
- `platforms`: Array — linkedin, x, bluesky, threads, instagram, facebook
- `text`: String or object with per-platform text (see below)
- `datetime`: ISO datetime for scheduling
- `timezone`: Timezone (default: America/Chicago)
- `imageUrl`: Optional publicly accessible image URL
- `blogId`: Brand ID from get-brands.js

**Per-platform text:**

example.sh

node skills/metricool/scripts/schedule-post.js '{
  "platforms": ["linkedin", "x", "bluesky", "threads", "instagram"],
  "text": "Your post text here",
  "datetime": "2026-01-30T09:00:00",
  "timezone": "America/New_York",
  "blogId": "YOUR_BLOG_ID"
}'

example.json

{
  "text": {
    "linkedin": "Full LinkedIn post with more detail...",
    "x": "Short X post under 280 chars",
    "bluesky": "Bluesky version under 300 chars",
    "threads": "Threads version under 500 chars",
    "instagram": "Instagram with #hashtags"
  }
}