Social media autopilot
by @socialecho-net
SocialEcho social media management API skill for querying team, accounts, articles, reports, upload URL, Reddit communities, Pinterest boards, and publishing...
clawhub install social-media-autopilot-api📖 About This Skill
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
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（与帮助中心内容对齐，供集成与运营参考）：
| 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
200 且响应 JSON 的 code 为 200 或 0（与当前对外接口约定一致）。默认模块.openapi.json 与 skill 内 openapi.json / openapi.yaml 内容一致（便于 Clawhub / GitHub 与 Agent 阅读）。⚙️ Configuration
cd socialecho-skills
npm ci
Runtime requirement: Node.js >=18
📋 Tips & Best Practices
200 且响应 JSON 的 code 为 200 或 0（与当前对外接口约定一致）。默认模块.openapi.json 与 skill 内 openapi.json / openapi.yaml 内容一致（便于 Clawhub / GitHub 与 Agent 阅读）。