OpenSkillIndex← back to search
claude-code

Skills crebee-social-media-gateway

install
source · Clone the upstream repo
git clone https://github.com/openclaw/skills
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/ai-scarlett/crebee-social-media-gateway" ~/.claude/skills/clawdbot-skills-crebee-social-media-gateway && rm -rf "$T"
manifest: skills/ai-scarlett/crebee-social-media-gateway/SKILL.md
source content

CreBee 社交媒体网关

统一 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

POST /galic/v1/auth/token

响应：

{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "expiresAt": "2025-01-28T00:00:00.000Z",
  "createdAt": "2025-01-21T00:00:00.000Z"
}

提示：Token 创建后可长期使用，无需在每次调用接口前都重新创建。仅在 token 过期（见响应中的 

expiresAt
）或返回 401 时再重新获取即可。

步骤 2：在所有请求中使用 Token

POST /galic/v1/account/getAll
Authorization: Bearer <token>
Content-Type: application/json

通用约定

账号标识

大多数平台 API 需要指定操作哪个账号：

{
  "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 使用游标分页：

{
  "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
。

批量发布请求结构

{
  "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[]否封面图片路径列表

发布示例：批量发布视频到多个平台

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
      }
    }
  ]
}

响应:

{
  "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}
。

取消发布任务

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平台类型

请求示例

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
}

响应:

[
  {
    "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

    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
    - 服务器内部错误

错误响应格式：

{
  "code": 400,
  "raw": null,
  "message": "详细错误信息"
}