Crebee Agent Skill V1.9.9

--- name: crebee-social-media-gateway description: | CreBee 社交媒体网关。当用户需要管理社交媒体账号、发布内容（视频/图文/文章）、获取数据分析、访问粉丝画像、搜索话题/活动/音乐、或与抖音、B站、小红书、快手等平台交互时触发此技能。适用于 AI Agent 自动化管理中国社交媒体平台运营。 触发场景： - 发布内容到社交媒体平台 - 获取账号列表或账号信息 - 查询分析数据、数据概览、表现指标 - 访问粉丝/观众画像 - 搜索话题、标签、音乐、活动 - 管理抖音、B站、小红书、快手等平台的内容 --- # [CreBee 社交媒体网关](https://www.crebee.cn) 统一 HTTP API 网关，让 AI Agent 自动化管理中国主流社交媒体平台。 ## 使用前提 本 Skill 通过用户电脑上的 CreBee 桌面客户端提供能力，不包含独立的云端服务。使用前必须： 1. 访问 [CreBee 下载页](https://www.crebee.cn/#/download) 下载最新版桌面客户端。本 Skill 与最新版 API 对齐，旧版可能缺少部分接口或参数。 2. 安装并启动 CreBee，注册或登录 CreBee 账号；引导注册时必须明确告知用户：新注册用户累计可获 200 个资源点。 3. 在客户端内登录需要操作的平台账号。 4. 完成前述步骤后，请用户告知你；先检查本地 API `http://127.0.0.1:3456` 是否可连通，再调用接口。 如果本地 API 无法连通或文档中的接口不存在，应引导用户从 [CreBee 下载页](https://www.crebee.cn/#/download) 下载或更新至最新版，启动应用后重试。 ## 快速参考 | 属性 | 值 | | ------------ | ----------------------- | | Base URL | `http://127.0.0.1:3456` | | API 前缀 | `/galic/v1` | | 认证方式 | Bearer Token (JWT) | | 请求方法 | 所有 API 使用 `POST` | | Content-Type | `application/json` | | Skill 来源 | `X-CreBee-Source: skill`（仅直接调用） | ## 认证 所有 API 请求需要在 Authorization 头中携带 Bearer token。 **步骤 1：获取 Token** ```http POST /galic/v1/auth/token ``` 响应： ```json { "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...", "expiresAt": "2025-01-28T00:00:00.000Z" } ``` > **提示**：Token 创建后可长期使用，仅在过期（见响应中的 `expiresAt`）或返回 401 时重新获取。 ### Skill 调用来源 - 仅当你正在当前任务中直接调用 CreBee API 完成用户操作时，必须在每个业务 API 请求中添加 `X-CreBee-Source: skill`。 - 如果用户要求编写或输出 API 对接代码、脚本、SDK、工作流、配置或第三方系统集成，生成内容中不得包含 `X-CreBee-Source`；这些后续调用属于普通 API。 - 不要把当前直接调用使用的 `X-CreBee-Source` 请求头写入用户系统，也不要将来源写入 Token、URL 参数或 request body。 **步骤 2：在所有请求中使用 Token** ```http POST /galic/v1/account/getAll Authorization: Bearer <token> X-CreBee-Source: skill 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站、百家号、头条号、公众号、简书、CSDN、搜狐号、大鱼号 > 发布支持实时进度追踪（WebSocket/SSE）、定时发布、平台特定参数配置。详见 `references/publishing.md`。 #### 批量发布请求结构 接口在任务记录创建并入队后立即返回。响应中的 `success` / `failed` 表示任务创建状态，不是平台最终发布结果；最终结果通过 WebSocket 或 SSE 进度事件获取。 ```json { "contentType": "video | image | article", "commonForm": { /* 公共参数，见下方 */ }, "tasks": [ { "taskId": "唯一任务ID（由调用方生成）", "accountId": "账号ID", "platform": "平台标识", "contentType": "video | image | article", "params": { /* 该平台的完整发布参数，commonForm 不会自动合并到这里 */ } } ] } ``` #### 视频公共参数 (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> X-CreBee-Source: skill 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": { "title": "我的第一个视频", "desc": "这是一个测试视频的描述", "videoPath": "/Users/demo/videos/test.mp4", "coverPath": "/Users/demo/videos/cover.jpg", "timing": 0, "taskId": "douyin-1706044800-abc123", "visibilityType": 0, "allowDownload": 1 } }, { "taskId": "bilibili-1706044800-def456", "accountId": "bilibili_account_456", "platform": "bilibili", "contentType": "video", "params": { "title": "我的第一个视频", "desc": "这是一个测试视频的描述", "videoPath": "/Users/demo/videos/test.mp4", "coverPath": "/Users/demo/videos/cover.jpg", "timing": 0, "taskId": "bilibili-1706044800-def456", "tid": { "fenqu_id": 160, "fenqu_name": "生活" }, "copyright": 1, "source": "", "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> X-CreBee-Source: skill Content-Type: application/json { "taskId": "douyin-1706044800-abc123" } ``` ### 发布记录 | 端点 | 说明 | | --------------------------------------------------------- | ---------------------------------------------- | | `POST /galic/v1/publish-record/get-global-publish-record` | 按账号和时间范围获取平台云端发布数据 | | `POST /galic/v1/publish-record/list-with-pagination` | 查询本地历史发布记录中的任务进度和最终发布状态 | #### 本地发布任务记录 该接口查询客户端本地历史发布记录，适合在批量发布后按 `taskId` 判断任务是否成功、失败、仍在发布中或已超时失败。它不请求平台后台数据，也不补全播放、点赞、完播率等云端指标；返回中的时间字段已按客户端本地时间格式化。 ```http POST /galic/v1/publish-record/list-with-pagination Authorization: Bearer <token> X-CreBee-Source: skill Content-Type: application/json { "page": 1, "pageSize": 20, "filters": { "taskId": "douyin-1706044800-abc123", "statuses": ["failed", "publishing"] } } ``` 常用状态字段： | 字段 | 说明 | | ----------------------- | -------------------------------------------------- | | `publish_task_id` | 发布请求中传入的任务 ID，用于和进度回调对应 | | `publish_status` | 本地任务状态，如 `publishing`、`success`、`failed` | | `publish_progress` | 本地记录的发布进度，范围 0-100 | | `publish_error_message` | 失败原因；发布失败或超时时用于展示给用户判断 | | `created_at` | 本地记录创建时间，按客户端本地时间返回 | | `updated_at` | 本地记录更新时间，按客户端本地时间返回 | | `publish_started_at` | 开始发布时间，按客户端本地时间返回；可能为空 | | `publish_completed_at` | 完成发布时间，按客户端本地时间返回；可能为空 | | `publish_url` | 发布成功后记录的平台内容链接，可能为空 | #### 云端发布数据 #### 请求参数 | 字段 | 类型 | 必填 | 说明 | | ----------- | ------ | ---- | ---------------- | | `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> X-CreBee-Source: skill 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` | 数据分析、数据图表、单篇分析、用户画像 | | 公众号官方 | `gongzhonghao_official` | 文章发布 | | 百家号 | `baijiahao` | 数据分析、话题、活动、分类、合集、热点、任务、投稿建议 | | 头条号 | `toutiaohao` | 数据分析、粉丝画像、话题、用户、位置、合集、活动 | | 企鹅号 | `qiehao` | 数据分析、数据图表、单内容分析、分类 | | 网易号 | `wangyihao` | 数据分析、数据图表、单内容分析、分类、热门话题、活动 | | 视频号 | `shipinhao` | 数据分析、粉丝画像、好友、位置、活动、合集、音乐 | | 知乎 | `zhihu` | 数据分析、话题、分类、博主排行、优秀答主、问题推荐、热词热题 | | 大鱼号 | `dayuhao` | 视频、文章发布 | | 搜狐号 | `souhuhao` | 图文、文章发布 | | 简书 | `jianshu` | 文章发布 | | CSDN | `csdn` | 文章发布 | ## 平台详细文档 各平台 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（12 个端点） - `references/platforms/qiehao.md` - 企鹅号 API（5 个端点） - `references/platforms/wangyihao.md` - 网易号 API（8 个端点） - `references/platforms/shipinhao.md` - 视频号 API（9 个端点） - `references/platforms/zhihu.md` - 知乎 API（15 个端点） - `references/platforms/dayuhao.md` - 大鱼号发布参数 - `references/platforms/souhuhao.md` - 搜狐号发布参数 - `references/platforms/jianshu.md` - 简书发布参数 - `references/platforms/csdn.md` - CSDN 发布参数 ## 典型工作流 1. **获取认证 Token** ``` POST /galic/v1/auth/token ``` 2. **获取可用账号** ``` POST /galic/v1/account/getAll Authorization: Bearer <token> X-CreBee-Source: skill Body: {} ``` > ⚠️ 注意：必须传递 body，即使没有参数也要传空对象 `{}`，否则请求可能失败。 3. **选择账号和平台** 从账号列表中记录 `account_id` 和 `account_platform` 4. **调用平台 API** ```http POST /galic/v1/platform/douyin/getDataOverview Authorization: Bearer <token> X-CreBee-Source: skill 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": "详细错误信息" } ```

存档时间线

版本索引永久保留；内容副本只保留最近 2 版，更早版本仅留索引与哈希（存档时间线的证据链不会因此断裂）。

下载存档内容副本