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.
Schedule posts to multiple social platforms through Metricool's API.
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": "[email protected]"
}
}
}
Or in your workspace .env:
METRICOOL_USER_TOKEN=your-api-token
[email protected]
List connected brands and their blog IDs:
node skills/metricool/scripts/get-brands.js
node skills/metricool/scripts/get-brands.js --json
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, facebooktext: String or object with per-platform text (see below)datetime: ISO datetime for schedulingtimezone: Timezone (default: America/Chicago)imageUrl: Optional publicly accessible image URLblogId: Brand ID from get-brands.jsPer-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"
}
}
node skills/metricool/scripts/list-scheduled.js
node skills/metricool/scripts/list-scheduled.js --start 2026-01-30 --end 2026-02-05
node skills/metricool/scripts/best-time.js linkedin
node skills/metricool/scripts/best-time.js x
| Platform | Limit |
|---|---|
| 3,000 | |
| X/Twitter | 280 |
| Bluesky | 300 |
| Threads | 500 |
| 2,200 |