核心用法
MaxHub Toutiao是一款专注今日头条数据查询的Skill,通过MaxHub API接入字节跳动旗下资讯聚合平台,提供7个核心端点覆盖App端与Web端双入口:
内容数据:App端文章详情(app_get_article_info)、视频详情(app_get_video_info)、评论列表(app_get_comments),以及Web端文章/视频详情
用户数据:用户资料查询(app_get_user_info)、主页URL解析用户ID(app_get_user_id)
调用方式简洁,仅需curl+Bearer Token,参数通过query string传递,返回标准MaxHub JSON格式。
显著优点
1. 双端覆盖,数据互补:同时支持App端(group_id)与Web端(aweme_id),可交叉校验提升数据完整性
2. 链式调用设计:字段流字典清晰,支持文章→评论、URL→user_id→用户资料等链式场景
3. 防臆造机制完善:7端点硬白名单+4步Pre-call自检+App/Web替换矩阵,有效规避路径/参数编造风险
4. 零依赖部署:仅需curl,无第三方库依赖
5. 场景化文档:提供爆款内容采集、用户画像研究、双端对齐等5大典型场景指南
潜在局限
- 只读限制:明确禁止写入操作,无法进行点赞、评论、关注等交互
- 鉴权门槛:需单独注册MaxHub控制台获取API Key
- 数据受限:依赖MaxHub API覆盖范围,非官方直接接口,存在字段同步延迟可能
- 成本敏感:高频批量调用可能触发API配额或计费限制
- 平台依赖:今日头条接口变更可能导致端点失效,需关注Skill版本更新
适合人群
- 内容采集团队/数据工程师:构建头条爆款内容数据库
- MCN机构/品牌方:批量梳理头条号矩阵与作者画像
- 舆情研究员:监测视频传播路径与用户反馈
- 自媒体监控:跨端对齐核验内容元数据
常规风险
| 风险类型 | 说明 |
|---------|------|
| 凭证泄露 | API Key需严格保护,避免写入日志或对话 |
| 版本过期 | 持续404/410时需执行`skillhub upgrade` |
| 参数混淆 | App端`group_id`与Web端`aweme_id`不可混用 |
| 调用频率 | 需遵守MaxHub API速率限制 |
| 数据合规 | 采集内容需符合平台规则与数据安全法规 |