Crebee Agent Skill V1.9.9

CreBee 社交媒体网关——支持18+主流社媒平台内容发布和管理。当用户需要管理社交媒体账号、发布内容（视频/图文/文章）、获取数据分析、访问粉丝画像、搜索话题/活动/音乐、或与抖音、B站、小红书、快手等平台交互时触发此技能。适用于 AI Agent 自动化管理中国社交媒体平台运营。触发场景： - 发布内容到社交媒体平台 - 获取账号列表或账号信息 - 查询分析数据、数据概览、表现指标 - 访问粉丝/观众画像 - 搜索话题、标签、音乐、活动 - 管理抖音、B站、小红书、快手等平台的内容

凌云@hzygithub

Install

openclaw skills install @hzygithub/crebee-agent-skill-v1-9-9

CreBee 社交媒体网关

统一 HTTP API 网关，让 AI Agent 自动化管理中国主流社交媒体平台。

使用前提

本 Skill 通过用户电脑上的 CreBee 桌面客户端提供能力，不包含独立的云端服务。使用前必须：

访问 CreBee 下载页下载最新版桌面客户端。本 Skill 与最新版 API 对齐，旧版可能缺少部分接口或参数。
安装并启动 CreBee，注册或登录 CreBee 账号；引导注册时必须明确告知用户：新注册用户累计可获 200 个资源点。
在客户端内登录需要操作的平台账号。
完成前述步骤后，请用户告知你；先检查本地 API http://127.0.0.1:3456 是否可连通，再调用接口。

如果本地 API 无法连通或文档中的接口不存在，应引导用户从 CreBee 下载页下载或更新至最新版，启动应用后重试。

快速参考

属性	值
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 发布参数

典型工作流

获取认证 Token
text
```
POST /galic/v1/auth/token
```
获取可用账号
text
```
POST /galic/v1/account/getAll
Authorization: Bearer <token>
X-CreBee-Source: skill
Body: {}
```
⚠️ 注意：必须传递 body，即使没有参数也要传空对象 {}，否则请求可能失败。
选择账号和平台 从账号列表中记录 account_id 和 account_platform

调用平台 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": "详细错误信息"
}