crebee-social-media-gateway

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

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