SocialEcho Social Media Management Agent
Use this skill to call SocialEcho external APIs with a team API key.
Prerequisites
- Sign up / sign in at
https://app.socialecho.net/. - Create a team.
- In Team Management, create an API key.
- Use explicit CLI options for auth/runtime (do not auto-read env vars):
--api-key(required)--base-url(optional, defaulthttps://api.socialecho.net)--team-id(optional; maps toX-Team-Idwhen set)--lang(optional, defaultzh_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（与帮助中心内容对齐，供集成与运营参考）：
| File | Language |
|---|---|
platform-publish-limits_cn.md | Chinese |
platform-publish-limits_en.md | English |
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 阅读）。