shield_lock
金大哥
联系我们
← 返回 Skill 列表
extension
分类: 其它需要 API Key

CreBee-新媒体多平台分发工具

CreBee社交媒体网关。当用户需要管理社交媒体账号、发布内容（视频/图文/文章）、获取数据分析、访问粉丝画像、搜索话题/活动/音乐，或与抖音、B站、小红书、快手等12个平台交互时触发此技能。适用于AI Agent自动化管理中国社交媒体平台运营。触发场景：发布内容到社交媒体平台、获取账号列表、管理账号、获取数据报表、访问粉丝画像、搜索话题/活动等。

person作者: ai-scarletthubclawhub
open_in_new仓库download下载资源包

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