SocialEcho Social Media Management Agent

Use this skill to call SocialEcho external APIs with a team API key.

Prerequisites

1. Sign up / sign in at https://app.socialecho.net/.
2. Create a team.
3. In Team Management, create an API key.
4. Use explicit CLI options for auth/runtime (do not auto-read env vars):
• --api-key (required)
• --base-url (optional, default https://api.socialecho.net)
• --team-id (optional; maps to X-Team-Id when set)
• --lang (optional, default zh_CN)

Setup

cd socialecho-skills
npm ci

Runtime requirement: Node.js >=18

Commands

查询与报表（OpenAPI 约定为 GET + JSON body，脚本用 Node 原生 http(s) 发送）：

./team.js --api-key YOUR_KEY
./account.js --api-key YOUR_KEY --page 1 --type 1
./article.js --api-key YOUR_KEY --page 1 --account-ids 41,42
./report.js --api-key YOUR_KEY --start-date 2026-01-01 --end-date 2026-03-24 --time-type 1 --group day --account-ids 41,42

上传与发布相关：

./upload-url.js --api-key YOUR_KEY --content-type image/png
# 或: --content_type video/mp4
./reddit-communities.js --api-key YOUR_KEY --account-id 163751
./pinterest-boards.js --api-key YOUR_KEY --account-id 163751
./publish-article.js --api-key YOUR_KEY --payload ./publish-payload.example.json

GET /v1/upload/url 的 body 必须 包含 content_type（与实际上传文件一致的 MIME）。允许值为：image/jpeg、image/jpg、image/png、image/gif、image/webp、image/bmp；video/mp4、video/avi、video/mov、video/wmv、video/flv、video/webm、video/mkv、video/3gp、video/quicktime（详见 socialEchoApidocs_cn.md 第 5.5 节；脚本内常量 upload-url.js 的 CONTENT_TYPE_ENUM 同步校验）。

publish-article 的请求体字段以仓库内 openapi.json / openapi.yaml 中 POST /v1/publish/article 为准；请准备完整 JSON 文件并通过 --payload 传入。

Platform publish limits (copy, media, formats)

各平台文案长度、媒体数量、格式与尺寸等发布前校验规则见同目录 Markdown（与帮助中心内容对齐，供集成与运营参考）：

CLI：在终端打印全文到 stdout（便于管道保存或查阅）：

node ./platform-limits.js
node ./platform-limits.js --lang en
# 若已全局安装本包：
# socialecho-platform-limits
# socialecho-platform-limits --lang en

Notes

• 成功判定：HTTP 200 且响应 JSON 的 code 为 200 或 0（与当前对外接口约定一致）。
• 外部 API 限流：单 Key 建议不超过 120 次/分钟；循环调用请加节流与退避。
• 规范文件：仓库根目录同步的 默认模块.openapi.json 与 skill 内 openapi.json / openapi.yaml 内容一致（便于 Clawhub / GitHub 与 Agent 阅读）。