Skill: ai-scarlett/crebee-social-media-gateway (version 1.0.1)

--- name: crebee-social-media-gateway description: | CreBee 社交媒体网关。当用户需要管理社交媒体账号、发布内容（视频/图文/文章）、获取数据分析、访问粉丝画像、搜索话题/活动/音乐、或与抖音、B站、小红书、快手等 12 个平台交互时触发此技能。适用于 AI Agent 自动化管理中国社交媒体平台运营。 触发场景： - 发布内容到社交媒体平台 - 获取账号列表或账号信息 - 查询分析数据、数据概览、表现指标 - 访问粉丝/观众画像 - 搜索话题、标签、音乐、活动 - 管理抖音、B站、小红书、快手等平台的内容 --- # [CreBee 社交媒体网关](https://www.crebee.cn) 统一 HTTP API 网关，让 AI Agent 自动化管理 12 个中国主流社交媒体平台。欢迎访问官网 https://www.crebee.cn 下载试用。 ## 快速参考 | 属性 | 值 | | ------------ | ----------------------- | | Base URL | `http://127.0.0.1:3456` | | API 前缀 | `/galic/v1` | | 认证方式 | Bearer Token (JWT) | | 请求方法 | 所有 API 使用 `POST` | | Content-Type | `application/json` | ## 认证 所有 API 请求需要在 Authorization 头中携带 Bearer token。 **步骤 1：获取 Token** ```http POST /galic/v1/auth/token ``` 响应： ```json { "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...", "expiresAt": "2025-01-28T00:00:00.000Z", "createdAt": "2025-01-21T00:00:00.000Z" } ``` > **提示**：Token 创建后可长期使用，无需在每次调用接口前都重新创建。仅在 token 过期（见响应中的 `expiresAt`）或返回 401 时再重新获取即可。 **步骤 2：在所有请求中使用 Token** ```http POST /galic/v1/account/getAll Authorization: Bearer <token> Content-Type: application/json ``` ## 通用约定 ### 账号标识 大多数平台 API 需要指定操作哪个账号： ```json { "accountArgs": { "accountID": "string", "appAlias": "string" } } ``` - `accountID`：账号唯一标识（从 `account/getAll` 获取） - `appAlias`：平台标识（如 `douyin`、`bilibili`、`xiaohongshu`） **最佳实践**：先调用 `account/getAll` 获取可用账号列表及其 ID。 ### 日期参数 当 API 需要日期范围时（如 `startDate`、`endDate`）： - 使用 ISO 8601 日期字符串：`"2025-01-21"` 或 `"2025-01-21T00:00:00.000Z"` - 时间间隔通常使用 Unix 时间戳(秒) ### 分页 许多列表 API 使用游标分页： ```json { "cursor": "0", "count": 20 } ``` ## 核心 API ### 账号管理 | 端点 | 说明 | | ------------------------------- | ---------------------------- | | `POST /galic/v1/account/getAll` | 获取所有已登录的社交媒体账号 | ### 内容发布 | 端点 | 说明 | | -------------------------------------------- | ---------------------------------------- | | `POST /galic/v1/platform/publish/batch` | 批量发布内容（视频/图文/文章）到多个平台 | | `POST /galic/v1/platform/publish/cancelTask` | 取消排队中的发布任务 | **支持的内容类型:** - **视频 (video)**: 抖音、B站、快手、视频号、小红书、知乎、微博、百家号、头条号、企鹅号、网易号 - **图文 (image)**: 抖音、知乎、小红书、快手、头条号、视频号 - **文章 (article)**: 抖音、知乎、B站、百家号、头条号、公众号 > 发布支持实时进度追踪（WebSocket/SSE）、定时发布、平台特定参数配置。详见 `references/publishing.md`。 #### 批量发布请求结构 ```json { "contentType": "video | image | article", "commonForm": { /* 公共参数，见下方 */ }, "tasks": [ { "taskId": "唯一任务ID（由调用方生成）", "accountId": "账号ID", "platform": "平台标识", "contentType": "video | image | article", "params": { /* 平台特定参数 */ } } ] } ``` #### 视频公共参数 (commonForm) | 字段 | 类型 | 必填 | 说明 | | ----------- | ------ | ---- | ------------------------------------ | | `title` | string | 是 | 视频标题 | | `desc` | string | 是 | 视频描述 | | `videoPath` | string | 是 | 视频文件本地路径 | | `coverPath` | string | 是 | 封面图片本地路径 | | `timing` | number | 否 | 定时发布时间戳（秒），0 表示立即发布 | #### 图文公共参数 (commonForm) | 字段 | 类型 | 必填 | 说明 | | -------- | -------- | ---- | ---------------- | | `desc` | string | 否 | 图文描述 | | `images` | string[] | 否 | 图片本地路径列表 | #### 文章公共参数 (commonForm) | 字段 | 类型 | 必填 | 说明 | | --------- | -------- | ---- | ---------------- | | `title` | string | 否 | 文章标题 | | `content` | string | 否 | 文章内容（HTML） | | `covers` | string[] | 否 | 封面图片路径列表 | #### 发布示例：批量发布视频到多个平台 ```http POST /galic/v1/platform/publish/batch Authorization: Bearer <token> Content-Type: application/json { "contentType": "video", "commonForm": { "title": "我的第一个视频", "desc": "这是一个测试视频的描述", "videoPath": "/Users/demo/videos/test.mp4", "coverPath": "/Users/demo/videos/cover.jpg", "timing": 0 }, "tasks": [ { "taskId": "douyin-1706044800-abc123", "accountId": "douyin_account_123", "platform": "douyin", "contentType": "video", "params": { "visibilityType": 0, "allowDownload": 1 } }, { "taskId": "bilibili-1706044800-def456", "accountId": "bilibili_account_456", "platform": "bilibili", "contentType": "video", "params": { "tid": { "fenqu_id": 160, "fenqu_name": "生活" }, "copyright": 1, "tags": ["日常", "生活"], "pubType": 1 } } ] } ``` **响应:** ```json { "total": 2, "success": 2, "failed": 0, "results": [ { "accountId": "douyin_account_123", "platform": "douyin", "status": "success" }, { "accountId": "bilibili_account_456", "platform": "bilibili", "status": "success" } ] } ``` > **重要**: `taskId` 由调用方生成，用于关联 WebSocket/SSE 进度回调。建议格式：`{platform}-{timestamp}-{random}`。 #### 取消发布任务 ```http POST /galic/v1/platform/publish/cancelTask Authorization: Bearer <token> Content-Type: application/json { "taskId": "douyin-1706044800-abc123" } ``` ### 发布记录 | 端点 | 说明 | | --------------------------------------------------------- | ---------------------------------- | | `POST /galic/v1/publish-record/get-global-publish-record` | 按账号和时间范围获取平台的发布记录 | #### 请求参数 | 字段 | 类型 | 必填 | 说明 | | ----------- | ------ | ---- | ---------------- | | `account` | object | 是 | 账号信息 | | `startTime` | number | 是 | 开始时间戳（秒） | | `endTime` | number | 是 | 结束时间戳（秒） | **account 结构:** | 字段 | 类型 | 说明 | | ------------------ | ------ | -------- | | `account_id` | string | 账户 ID | | `account_platform` | string | 平台类型 | #### 请求示例 ```http POST /galic/v1/publish-record/get-global-publish-record Authorization: Bearer <token> Content-Type: application/json { "account": { "account_id": "douyin_account_123", "account_platform": "douyin" }, "startTime": 1705968000, "endTime": 1706227200 } ``` **响应:** ```json [ { "id": 1, "account_id": "douyin_account_123", "platform": "douyin", "content_type": "video", "title": "视频标题", "publish_status": "success", "publish_result_data": "{\"playCount\":1000,\"likeCount\":50,\"completePlayRate\":0.75}", "published_at": "2025-01-23T10:00:00.000Z", "account": { "account_id": "douyin_account_123", "account_platform": "douyin" } } ] ``` > **注意**: `publish_result_data` 是 JSON 字符串，包含平台特定指标（如完播率、2s 跳出率等），需解析后使用。 ## 支持的平台 | 平台 | appAlias | 主要能力 | | ------ | -------------- | ---------------------------------------------------------------- | | 抖音 | `douyin` | 数据分析、粉丝画像、话题、音乐、活动、热点、创意洞察、创作者活动 | | B站 | `bilibili` | 数据分析、投稿管理、评论、弹幕、收益、粉丝画像/趋势/排行 | | 小红书 | `xiaohongshu` | 数据分析、笔记、话题、位置、粉丝画像、观众来源/时段、活动中心 | | 快手 | `kuaishou` | 数据分析、粉丝画像、话题、活动、热点、音乐、创作灵感 | | 微博 | `weibo` | 数据分析、数据图表、话题、分类、素材中心 | | 公众号 | `gongzhonghao` | 数据分析、数据图表、单篇分析、用户画像 | | 百家号 | `baijiahao` | 数据分析、话题、活动、分类、合集、热点、任务、投稿建议 | | 头条号 | `toutiaohao` | 数据分析、粉丝画像、话题、用户、位置、合集、活动 | | 企鹅号 | `qiehao` | 数据分析、数据图表、单内容分析、分类 | | 网易号 | `wangyihao` | 数据分析、数据图表、单内容分析、分类、热门话题、活动 | | 视频号 | `shipinhao` | 数据分析、粉丝画像、好友、位置、活动、合集、音乐 | | 知乎 | `zhihu` | 数据分析、话题、分类、博主排行、优秀答主、问题推荐、热词热题 | ## 平台详细文档 各平台 API 的详细参数和响应说明，请阅读对应的参考文件： - `references/platforms/douyin.md` - 抖音 API（29 个端点） - `references/platforms/bilibili.md` - B站 API（27 个端点） - `references/platforms/xiaohongshu.md` - 小红书 API（14 个端点） - `references/platforms/kuaishou.md` - 快手 API（17 个端点） - `references/platforms/weibo.md` - 微博 API（8 个端点） - `references/platforms/gongzhonghao.md` - 公众号 API（4 个端点） - `references/platforms/baijiahao.md` - 百家号 API（14 个端点） - `references/platforms/toutiaohao.md` - 头条号 API（11 个端点） - `references/platforms/qiehao.md` - 企鹅号 API（5 个端点） - `references/platforms/wangyihao.md` - 网易号 API（8 个端点） - `references/platforms/shipinhao.md` - 视频号 API（9 个端点） - `references/platforms/zhihu.md` - 知乎 API（15 个端点） ## 典型工作流 1. **获取认证 Token** ``` POST /galic/v1/auth/token ``` 2. **获取可用账号** ``` POST /galic/v1/account/getAll Authorization: Bearer <token> Body: {} ``` > ⚠️ 注意：必须传递 body，即使没有参数也要传空对象 `{}`，否则请求可能失败。 3. **选择账号和平台** 从账号列表中记录 `account_id` 和 `account_platform` 4. **调用平台 API** ```http POST /galic/v1/platform/douyin/getDataOverview Authorization: Bearer <token> Content-Type: application/json { "accountArgs": { "accountID": "<account_id>", "appAlias": "douyin" }, "startDate": "2025-01-21", "endDate": "2025-01-28" } ``` ## 错误处理 所有 API 返回标准 HTTP 状态码： - `200` - 成功 - `400` - 请求参数错误 - `401` - 未授权（缺少或无效的 token） - `500` - 服务器内部错误 错误响应格式： ```json { "code": 400, "raw": null, "message": "详细错误信息" } ```


Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (MEDIUM)