How do I install the Metricool skill?

Run npx skillmds@latest add modbender/metricool in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Metricool safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Metricool?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Metricool free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Metricool?

modbender (@modbender) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Metricool by modbender — Agent Skill

Name: Metricool
Rating: 4.2 (5 reviews)
Author: modbender

File contents

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

---name: metricooldescription: 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`: ```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: ```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

Frequently asked questions

Metricool