- name
- socialecho-social-media-management-agent
- description
- SocialEcho social media management API skill for querying team, accounts, articles, reports, upload URL, Reddit communities, Pinterest boards, and publishing posts using team API key. Use for integration checks and data pulls.
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, 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 ciRuntime 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.jsonGET /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 enNotes
- 成功判定：HTTP
200且响应 JSON 的code为200或0（与当前对外接口约定一致）。 - 外部 API 限流：单 Key 建议不超过 120 次/分钟；循环调用请加节流与退避。
- 规范文件：仓库根目录同步的
默认模块.openapi.json与 skill 内openapi.json/openapi.yaml内容一致（便于 Clawhub / GitHub 与 Agent 阅读）。