做社媒数据分析的人大多遇到过这样的尴尬:要采抖音得接一套SDK,要采小红书又是另一套鉴权,B站和微博还得再来两套。光是把这些平台的API对齐,就得耗费大量精力处理各家的认证方式、参数格式和返回结构。
XieWxx在GitHub开源的MaxHub API Skills就是来解决这个问题的——它把抖音、TikTok、B站、小红书、微博、Instagram、YouTube、LinkedIn等20+主流平台的API,封装成了标准化的Agent Skill模块,让你的AI助手(Claude Code、Codex、Cursor等)通过一句自然语言就能调起对应平台的公开数据。
这是什么
MaxHub API Skills是一套基于ClawHub(OpenClaw)生态的AI技能工具包,采用MIT协议开源。它的核心思路是:每个平台对应一个独立的Skill,所有Skill统一通过MAXHUB_API_KEY认证,请求发往同一个Base URL(https://www.aconfig.cn)。
截至目前,整个仓库覆盖了20个平台、共991个API端点。其中抖音端点最丰富,达到271个;TikTok有189个;LinkedIn 85个;小红书77个;Instagram 68个;微博64个;B站41个;YouTube 37个;知乎31个;微信24个——长尾平台如皮皮虾、Lemon8、Reddit、Sora2、Twitter、快手、西瓜视频、头条、Threads、Temp Mail也都有覆盖。
每个端点都严格对齐官方API文档,路径精确到具体版本(例如/api/v1/douyin/web/fetch_one_video),参数表包含名称、类型、必填状态和示例值,废弃端点已被过滤掉。
为什么值得用
统一接口,告别重复造轮子
传统方式下接20个平台意味着20套鉴权逻辑、20种参数格式、20套错误处理逻辑。MaxHub API Skills把这些差异在Skill层抹平了:拿到API Key后,所有平台的调用方式完全一致。
AI原生设计
Skill内部内置了意图识别路由。比如你对着AI说"帮我看看今天抖音热搜第一是什么",Skill会自动路由到api-trending.md里对应的端点并完成调用,不需要你手动拼URL和参数。
全平台公开数据合规采集
根据Skill的安全声明:仅获取公开数据,不触碰用户隐私;通过HTTPS加密传输;不存储、不转发用户凭证;不执行任何平台操纵操作(刷量、刷播放等)。已通过ClawHub安全审核。
中英双语文档
所有Skill文档都提供简体中文和English双版本,国内外开发者都能直接用。
5分钟上手
第一步:安装ClawHub
curl -fsSL https://openclaw.com/install.sh | bash
clawhub --version
第二步:获取API Key
前往www.aconfig.cn注册账号,在控制台创建API Key。
注意:Skill本身MIT协议开源免费,但底层API服务(aconfig.cn)按调用次数计费,具体费率以官网公布为准。
第三步:安装所需Skill
# 安装单个平台Skill
clawhub skill install maxhub-douyin
clawhub skill install maxhub-tiktok
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"
第五步:在AI助手中直接使用
如果你用的是Claude Code,也可以一键安装聚合Skill:
/plugin marketplace add bajiefuwu/maxhub-api-skill
/plugin install maxhub-api-skill
装完之后,直接用自然语言对话即可:
你:帮我查一下抖音视频 7372484719365098803 的详情
AI:调用 fetch_one_video 端点,返回视频数据...
你:TikTok上 #dance 话题有哪些热门视频?
AI:正在调用TikTok趋势接口...
Skill内部结构
以maxhub-douyin为例,每个Skill的目录结构非常清晰:
maxhub-douyin/
├── SKILL.md # 主入口:意图识别+路由
├── _meta.json # 元数据(含homepage和repository)
├── 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
└── README_CN.md
_meta.json中标注了homepage和repository字段,方便用户验证服务来源,确保端点路径来自官方文档而非臆想。
典型使用场景
内容运营
运营人员可以直接用自然语言查询各平台数据,不需要技术背景:"对比一下我们抖音和小红书上个月的账号数据"、"帮我整理本周B站上播放量增长最快的视频"。
竞品分析
"采集竞品账号在抖音上近30天的视频数据"、"分析这个品牌在小红书上的笔记互动表现"——跨平台数据一站拉齐。
数据驱动创作
"看看最近一周抖音上什么类型的视频最容易火"、"分析B站上这个分区播放量最高的视频有什么共同点"。
后端数据采集管道
由于底层是标准RESTful API,任何支持HTTP请求的语言都能直接调用,端点路径和参数完全透明,便于嵌入数据管道、报表系统和快速原型开发。
安全与边界
使用这套Skill时有几个点需要注意:
-
Cookie使用风险:部分接口可能需要Cookie认证,Skill中明确提示:仅在完全信任服务提供商时提供Cookie,优先使用范围限定的OAuth/API令牌,使用独立测试账号,用后轮换或撤销
-
写操作需谨慎:如Sora2的
create/upload/download、抖音的fetch_increase_post_view_count等非只读能力,Agent默认不应调用,必须获得用户明确授权并提示平台ToS风险 -
数据仅供参考:通过第三方API获取的数据,Skill明确声明"仅供参看",关键决策建议二次核验
-
费用控制:Skill内置调用限制防止意外产生高额费用,建议在aconfig.cn控制台自行设置调用配额上限
适合谁
如果你是AI助手重度用户,又经常需要拉取各平台公开数据做分析,MaxHub API Skills基本是目前覆盖最广、接入成本最低的开源方案之一。991个端点、20个平台、统一认证——这三个数字基本意味着你不需要再为每个平台单独写采集脚本了。
对于ClawHub/OpenClaw生态用户,一键clawhub skill install就能用;对于不在该生态里的开发者,底层就是标准HTTP接口,拿到API Key后用什么语言调都行。