metricool – OpenClaw Skill

---

name: metricool description: Schedule and manage social media posts via Metricool API. Use when posting to multiple platforms (LinkedIn, X, Bluesky, Threads, Instagram), checking scheduled posts, or analyzing social metrics.

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:

{
  "env": {
    "vars": {
      "METRICOOL_USER_TOKEN": "your-api-token",
      "METRICOOL_USER_ID": "your@email.com"
    }
  }
}

Or in your workspace .env:

METRICOOL_USER_TOKEN=your-api-token
METRICOOL_USER_ID=your@email.com

Scripts

Get Brands

List connected brands and their blog IDs:

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

Schedule a Post

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:

{
  "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

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

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

Metricool Skill for Moltbot

Schedule and manage social media posts via Metricool API.

Platforms Supported

• LinkedIn
• X (Twitter)
• Bluesky
• Threads
• Instagram
• Facebook

Installation

Copy the metricool folder to your Moltbot skills directory, or download metricool.skill from releases.

Setup

1. Get your API token from Metricool dashboard
2. Add credentials to ~/.moltbot/moltbot.json:

{
  "env": {
    "vars": {
      "METRICOOL_USER_TOKEN": "your-api-token",
      "METRICOOL_USER_ID": "your@email.com"
    }
  }
}

Or add to your workspace .env file.

Scripts

Script	Purpose
get-brands.js	List connected accounts/brands
schedule-post.js	Schedule posts to multiple platforms
list-scheduled.js	View queued posts
best-time.js	Get optimal posting times

Usage Examples

# List your brands
node scripts/get-brands.js

# Schedule a post
node scripts/schedule-post.js '{
  "platforms": ["linkedin", "x", "bluesky"],
  "text": "Hello world!",
  "datetime": "2026-01-30T09:00:00",
  "timezone": "America/New_York"
}'

# Check scheduled posts
node scripts/list-scheduled.js --start 2026-01-30 --end 2026-02-05

License

MIT