trip2g-metricool

Zero-dependency Metricool CLI for agent automation.

Built for agent automation. Single compiled JS file, zero runtime dependencies — readable in full in one scroll, safe to deploy in automated pipelines.

Requirements

• Node 18+
• .env file or environment variables set

Environment variables (all required)

Variable	Description
METRICOOL_API_KEY	API token
METRICOOL_USER_ID	User ID
METRICOOL_BLOG_ID	Brand ID

Install

git clone https://github.com/yourorg/trip2g_metricool
cd trip2g_metricool
npm install       # dev deps only: typescript, @types/node, eslint
npm run build     # produces metricool.js

Or copy the pre-built metricool.js directly — verify integrity first:

sha256sum metricool.js
# compare against hash in SKILL.md

Usage

# reads .env from current directory by default
node metricool.js post list
node metricool.js post list --start 2026-05-01T00:00:00 --end 2026-05-31T23:59:59

node metricool.js post create --text "Hello Threads" --network threads --draft
node metricool.js post create --text "Carousel post" --network threads --threads-type carousel --draft
node metricool.js post create --text "Multi" --network threads,instagram --date "2026-05-20T14:00:00" --timezone "Europe/Moscow" --draft

node metricool.js post update POST_ID --text "Updated text"
node metricool.js post delete POST_ID

# use a specific .env file
node metricool.js --env-file /path/to/.env post list

Development

npm run build    # compile metricool.ts → metricool.js
npm test         # unit tests
npm run lint     # eslint

Commit both metricool.ts and compiled metricool.js.