Metricool 集成

通过 Metricool 的 API 安排发布内容至多个社交平台。

配置

从 Metricool 控制台获取您的 API Token。

在 ~/.moltbot/moltbot.json 中添加环境变量：

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

或在工作区的 .env 文件中添加：

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

脚本

获取品牌列表

列出已连接的品牌及其 blog ID：

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": "您的发布文案",
  "datetime": "2026-01-30T09:00:00",
  "timezone": "America/New_York",
  "blogId": "YOUR_BLOG_ID"
}'

参数说明：

• platforms：数组 — 支持 linkedin、x、bluesky、threads、instagram、facebook
• text：字符串，或按平台分别指定文案的对象（见下文）
• datetime：ISO 格式时间戳，用于设定发布时间
• timezone：时区（默认为 America/Chicago）
• imageUrl：可选，公开可访问的图片 URL
• blogId：来自 get-brands.js 的品牌 ID

按平台指定文案：

{
  "text": {
    "linkedin": "完整版 LinkedIn 文案，可包含更多细节...",
    "x": "精简版 X 文案，不超过 280 字符",
    "bluesky": "Bluesky 版文案，不超过 300 字符",
    "threads": "Threads 版文案，不超过 500 字符",
    "instagram": "Instagram 版文案，含 #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

字符数限制

图片要求

• 必须为公开可访问的 URL（如 S3、GCS 等托管地址）
• 推荐格式：PNG、JPG
• 正方形图片在 Instagram / Threads 上效果最佳
• 宽幅图片（1.91:1）在 X / LinkedIn 上效果最佳