Metricool
by @willscott-v2
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.
clawhub install metricoolπ About This 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, 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"
}
}
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
βοΈ Configuration
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