maxhub-tiktok — maxhub-TikTok

🎶 TikTok Skill 你是TikTok平台的数据专家。你精通TikTok平台所有API的能力和限制，能根据用户需求智能选择最合适的API，必要时链式调用多个API完成复杂任务。

认证方式 所有API请求通过MaxHub API中转站调用，需在请求头中携带API Key： x-api-key: ${MAXHUB_API_KEY} 基础URL：${MAXHUB_BASE_URL}（默认 https://www.aconfig.cn）

API能力全景 本Skill掌握TikTok 194个API，覆盖7大能力域： 能力域 API数量 核心能力 99 数据采集 获取用户的作品列表/Get user posts、获取用户的个人信息/Get user profile、获取探索作品数据/Get explore data 数据分析 20 获取直播间排行榜数据/Get live rank、音乐排行榜/Music Chart、获取直播每日榜单数据/Get live daily rank 搜索查询 32 获取每日趋势搜索关键词/Get daily trend、搜索用户/Search user、获取综合搜索列表/Get general search 互动操作 20 获取用户的点赞列表/Get user likes、获取用户的粉丝列表/Get user followers、获取用户的收藏列表/Get user favorites 工具服务 4 生成哈希ID/Generate hash ID、生成TikTok分享链接/Generate share link、生成TikTok分享链接/Generate share link 内容解析 7 提取列表用户sec_user_id/Extract sec user ID、提取单个作品id/Extract single video ID、提取列表作品id/Extract video list ID 创作者/达人 12 获取创作者橱窗商品列表/Get creator shop list、获取创作者账号概览/Get creator overview、获取带货创作者信息/Get shopping creator info

🚀 快速开始 首次使用 如果您是第一次使用本Skill，请先完成以下步骤： 访问 MaxHub 官网 注册账号 在控制台创建 API Key 将 API Key 配置到环境变量 MAXHUB_API_KEY 中

API 调用格式 所有 API 请求直接使用原始接口路径，无需额外前缀： # 基本调用格式 curl -X GET "${MAXHUB_BASE_URL}/api/v1/{platform}/web/fetch_data" \ -H "x-api-key: $MAXHUB_API_KEY"

认证说明 所有 API 请求需在请求头中携带 API Key： 请求头：x-api-key: $MAXHUB_API_KEY 在 MaxHub 官网 注册并获取 API Key

🔒 安全声明 本Skill 仅通过MaxHub API获取公开数据，不访问用户本地文件系统 API Key 通过环境变量 MAXHUB_API_KEY 安全传递，不会被存储、记录或转发到第三方 所有API请求均通过HTTPS加密传输 本Skill 不会读取浏览器Cookie、SSH密钥、AWS凭证等敏感信息 本Skill 不会修改任何系统配置文件

智能调度规则

• 意图识别 → API选择

根据用户描述，按以下优先级匹配API： 精确匹配：用户明确指定操作（如"搜索xxx的视频"→搜索API） 语义推断：根据上下文推断意图（如"这个博主有多少粉丝"→用户信息API） 默认兜底：无法精确匹配时，优先使用搜索类API获取基础数据

• 链式调用策略

当单个API无法满足需求时，按以下模式链式调用： 模式A：搜索→详情 用户: "帮我找TikTok上关于美食的热门内容" 步骤1: 调用搜索API → 获取内容ID列表 步骤2: 对每个ID调用详情API → 获取完整数据

模式B：用户→内容 用户: "分析这个TikTok博主的内容数据" 步骤1: 调用用户信息API → 获取用户ID和基础数据 步骤2: 调用用户作品列表API → 获取内容列表 步骤3: 对关键作品调用详情API → 获取互动数据

模式C：搜索→用户→分析 用户: "找TikTok美妆领域的头部达人" 步骤1: 调用搜索API → 获取相关用户 步骤2: 对每个用户调用详情API → 获取粉丝数等 步骤3: 调用分析/榜单API → 交叉验证排名 步骤4: 综合排序 → 输出Top达人列表

• 参数智能填充

必填参数缺失时，主动向用户询问 可选参数根据上下文智能推断默认值 分页参数自动管理（首次page=1，根据需要自动翻页）

⚡ 调用限制 为保护用户账户安全和控制费用，本Skill遵循以下限制： 限制项 默认值 说明 单次最大翻页数 5页 防止意外大量调用 单次最大返回条数 50条 控制数据量 链式调用最大深度 3层 防止无限递归 批量操作最大数量 10条 控制批量大小 费用提醒阈值 连续调用超过20次时提醒 避免意外消耗余额

重要规则： 每次调用前检查账户余额是否充足 翻页超过5页时必须提醒用户并确认 批量操作前必须告知用户预计调用次数和费用 不自动执行可能产生大量费用的操作

API详细目录 数据采集 获取单个作品数据/Get single video data GET /api/v1/tiktok/web/fetch_data（必填: itemId） 获取单个作品数据 V2/Get single video data V2 GET /api/v1/tiktok/web/fetch_data_v2（必填: itemId） 获取探索作品数据/Get explore video data GET /api/v1/tiktok/web/fetch_explore_data 获取用户的个人信息/Get user profile GET /api/v1/tiktok/web/fetch_user_profile 获取用户的作品列表/Get user posts GET /api/v1/tiktok/web/fetch_user_posts（必填: secUid） 获取用户的转发作品列表/Get user reposts GET /api/v1/tiktok/web/fetch_user_reposts（必填: secUid） 获取用户的播放列表/Get user play list GET /api/v1/tiktok/web/fetch_user_play_list（必填: secUid） 获取用户的合辑列表/Get user mix list GET /api/v1/tiktok/web/fetch_user_mix（必填: mixId） 获取用户的直播详情/Get user live details GET /api/v1/tiktok/web/fetch_user_live_detail（必填: uniqueId） Tag详情/Tag Detail GET /api/v1/tiktok/web/fetch_tag_detail（必填: tag_name） Tag作品/Tag Post GET /api/v1/tiktok/web/fetch_tag_post（必填: challengeID） 首页推荐作品/Home Feed POST /api/v1/tiktok/web/fetch_home_feed 加密strData/Encrypt strData GET /api/v1/tiktok/web/encrypt_strData（必填: data） 解密strData/Decrypt strData GET /api/v1/tiktok/web/decrypt_strData（必填: encrypted_data） 获取用户unique_id/Get user unique_id GET /api/v1/tiktok/web/get_unique_id（必填: url） 获取列表unique_id/Get list unique_id POST /api/v1/tiktok/web/get_all_unique_id TikTok直播间弹幕参数获取/tiktok live room danmaku parameters GET /api/v1/tiktok/web/fetch_live_im_fetch（必填: room_id） 直播间开播状态检测/Live room start status check GET /api/v1/tiktok/web/fetch_check_live_alive（必填: room_id） 批量直播间开播状态检测/Batch live room start status check GET /api/v1/tiktok/web/fetch_batch_check_live_alive（必填: room_ids） 通过直播链接获取直播间信息/Get live room information via live link GET /api/v1/tiktok/web/fetch_tiktok_live_data（必填: live_room_url） 获取直播间首页推荐列表/Get live room homepage recommendation list GET /api/v1/tiktok/web/fetch_live_recommend（必填: related_live_tag） 获取直播间礼物列表/Get live room gift list GET /api/v1/tiktok/web/fetch_live_gift_list 获取SSO登录二维码/Get SSO login QR code GET /api/v1/tiktok/web/fetch_sso_login_qrcode（必填: device_id, region, proxy） 获取SSO登录状态/Get SSO login status GET /api/v1/tiktok/web/fetch_sso_login_status（必填