一键调用20个社交平台API：MaxHub Skills开源工具包实战指南

香蕉鱿鱼怪

420人浏览 · 2026-05-19 12:12:08

香蕉鱿鱼怪 · 2026-05-19 12:12:08 发布

一键调用20个社交平台API：MaxHub Skills开源工具包实战指南

覆盖抖音、TikTok、B站、小红书等20+平台，991个API端点，ClawHub一键安装，5分钟上手数据采集。

你是不是也遇到过这些痛点？

做社交媒体数据分析的朋友，大概都经历过这种折磨：想抓抖音的热搜数据，得去翻抖音的逆向接口；想看TikTok的创作者画像，又得找另一套工具；小红书的笔记数据、B站的弹幕统计、微博的AI搜索……每个平台一套体系，API 文档散落各处，认证方式五花八门，光是环境搭建就能耗掉一整天。

更头疼的是，好不容易跑通了一个接口，平台一更新，接口就挂了。维护成本高得离谱，项目越做越像在给接口打补丁。

如果你有类似的困扰，这篇文章可能会帮你省下不少时间。

示例

在这里插入图片描述

MaxHub Skills 是什么？

MaxHub Skills 是一套基于 ClawHub（OpenClaw）生态的 AI 技能工具包，它将 20+ 主流社交平台的 API 封装成了标准化的 Skill 模块。每个 Skill 对应一个平台，包含完整的端点定义、参数说明、认证机制和使用示例。

简单来说，你只需要一个 API Key，就能通过统一的接口格式，访问抖音、TikTok、B站、小红书、微博、Instagram、YouTube、LinkedIn 等 20 个平台的 991 个 API 端点。

核心数据一览

指标	数值
覆盖平台	20 个
API 端点总数	991 个
端点覆盖最广	抖音（271个）、TikTok（189个）
安装方式	ClawHub CLI 一键安装
认证方式	统一 Bearer Token
数据源	严格对齐官方 API 文档

支持的平台清单

平台	端点数	核心能力
🎵 抖音	271	视频/用户/搜索/热榜/创作者/星图/指数
🌐 TikTok	189	视频/用户/搜索/广告分析/创作者/店铺
📕 小红书	77	笔记/用户/搜索/商品话题
💼 LinkedIn	85	公司/用户/内容广告/搜索职位
📸 Instagram	68	帖子/用户/搜索/工具转换
🐦 微博	64	微博/用户/搜索/热搜/视频推荐
📺 B站	41	视频/用户/搜索/直播评论
🎬 YouTube	37	视频/频道/搜索评论
📘 知乎	31	内容/用户/搜索热门
💬 微信	24	视频号/公众号
🍋 Lemon8	16	帖子用户/搜索发现
🎮 皮皮虾	16	帖子用户/搜索热门
💡 Reddit	16	帖子/版块/用户搜索
🎨 Sora2	14	出镜秀/帖子用户/工具
🐦‍⬛ Twitter	12	推文/用户/搜索热门
🎥 快手	9	视频/用户/热榜
🍉 西瓜	7	视频用户
📰 头条	7	内容用户
🧵 Threads	3	帖子用户/搜索
📧 Temp Mail	4	临时邮箱

架构设计：为什么这样分？

MaxHub Skills 的设计遵循一个核心原则：每个平台独立一个 Skill，绝不混合。这样做的好处很直接：

按需安装：只用抖音？装 maxhub-douyin 就够了，不用把 TikTok 和 Instagram 的配置也拉进来
独立更新：抖音接口变了，更新 douyin skill 即可，其他平台不受影响
权限隔离：不同平台的 API每个 Skill 内部采用意图路由的架构，将端点按功能分组到不同的 Reference 文件中。组到不同的 Reference 文件中。以抖音为例：

maxhub-douyin/
├── SKILL.md              # 主入口：意图识别 + 路由
├── _meta.json            # 元数据
├── references/
│   ├── api-video.md      # 视频与内容（113个端点）
│   ├── api-user.md       # 用户数据（46个端点）
│   ├── api-search.md     # 搜索（40个端点）
│   ├── api-trending.md   # 热榜与趋势（37个端点）
│   ├── api-creator.md    # 创作者（19个端点）
│   ├── api-index.md      # 指数与分析（8个端点）
│   ├── api-xingtu.md     # 星图（8个端点）
│   └── param-mappings.md # 参数映射
├── README.md
└─当你说“帮我查一下抖音的热搜榜”，AI 会自动路由到 `api-trending.md`，找到对应的端点并调用。ding.md`，找到对应的端点并调用。

***

## 5分钟上手：从安装到调用

### 第一步：安装 ClawHub

```bash
# macOS / Linux
curl -fsSL https://openclaw.com/install.sh | bash

# 验证安装
clawhub --version

第二步：获取 API Key

前往 https://www.aconfig.cn 注册账号，在控制台创建 API Key。

第三步：安装 Skill

# 安装抖音 Skill
clawhub skill install maxhub-douyin

# 安装 TikTok Skill
clawhub skill install maxhub-tiktok

# 安装 B站 Skill
clawhub skill install maxhub-bilibili

# 或者批量安装所有平台
for skill in maxhub-douyin maxhub-tiktok maxhub-bilibili maxhub-xiaohongshu maxhub-weibo maxhub-instagram maxhub-youtube maxhub-linkedin maxhub-twitter maxhub-reddit; do
  clawhub skill install "$skill"
done

第四步：配置 API Key

# 方式一：通过 ClawHub 配置
openclaw config set skills.entries.maxhub-douyin.apiKey "你的_API_KEY"

# 方式二：环境变量
export MAXHUB_API_KEY="你的_API_KEY"

第五步：开始调用

安装完成后，在支持 ClawHub 的 AI 客户端中直接用自然语言调用：

你：帮我查一下抖音视频 7372484719365098803 的详情
AI：调用 fetch_one_video 端点，返回视频数据...

你：TikTok 上 #dance 话题有哪些热门视频？
AI：调用 fetch_hashtag_video_list 端点...

你：获取B站UP主 203680252 的粉丝数据
AI：调用 fetch_user_info 端点...

实战案例：三个典型场景

场景一：竞品账号分析（抖音 + 小红书）

需求：分析某品牌在抖音和小红书的内容表现差异。

# 抖音：获取用户投稿视频列表
GET /api/v1/douyin/web/fetch_user_post_videos
参数: sec_user_id = "MS4wLjABAAAA..."

# 小红书：获取用户笔记列表
GET /api/v1/xiaohongshu/web/get_user_notes
参数: user_id = "5c2f338a000000000701e1c6"

通过两个 Skill 的组合调用，可以快速拉取跨平台的内容数据，做对比分析。

场景二：热搜监控（微博 + 抖音 + 头条）

需求：实时监控多个平台的热搜趋势。

# 微博热搜
GET /api/v1/weibo/web/fetch_hot_search

# 抖音热搜
GET /api/v1/douyin/app/v3/fetch_hot_search

# 头条热榜
GET /api/v1/toutiao/app/get_hot_search

三个端点统一格式，统一认证，一个脚本就能搞定多平台热搜聚合。

场景三：LinkedIn 商业情报

需求：获取某公司的员工分布和近期动态。

# 公司资料
GET /api/v1/linkedin/web/get_company_profile
参数: username = "google"

# 公司员工
GET /api/v1/linkedin/web/get_company_people
参数: username = "google"

# 公司帖子
GET /api/v1/linkedin/web/get_company_posts
参数: username = "google"

LinkedIn Skill 提供了 85 个端点，覆盖公司、用户、搜索、广告等维度的数据。

安全设计：我们做了什么？

在数据采集工具中，安全性是不可回避的话题。MaxHub Skills v3.2.0 针对安全做了以下处理：

1. 只读操作声明

所有 Skill 均声明为只读数据查询工具，不包含任何写入操作或指标操纵端点。曾经存在的 add_video_play_count（刷播放量）等端点已在安全审计中移除。

2. Cookie 安全警告

部分高级接口（如抖音创作者数据）需要用户提供平台 Cookie。对于这类接口，Skill 中内嵌了明确的安全提示：

⚠️ 仅在完全信任服务提供商时提供 Cookie。优先使用范围限定的 OAuth/API 令牌，使用独立测试账号，使用后轮换或撤销 Cookie。

3. 数据传输披露

所有 API 请求发送至 服务器，Skill 中明确标注了数据传输目标和服务商处理边界。

4. 源信息可追溯

每个 Skill 的 _meta.json 中标注了 homepage 和 repository 字段，方便用户验证服务来源。

技术细节：端点路径的精确性

一个容易被忽视但非常关键的点：**在 v3.0.0 版本中，我们对所有 991 个端点进行了一次全面审查，以 docs/ 目录中的 OpenAPI 规范为唯一数据源，重新生成了所有 Reference 文件。新生成了所有 Reference 文件。这意味着：

每个端点路径都来自官方文档，不存在臆想地址
路径中的子分类精确到具体版本（如 /api/v1/douyin/web/fetch_one_video 而非 /api/v1/douyin/.../fetch_one_video）
参数表包含名称、类型、必填状态、描述和示例值
废弃端点已过滤，不会出现在 Skill 中