← Back to Skills Marketplace

maxhub-tiktok

Name: maxhub-tiktok
Author: xiewxx

by Xie Hao · GitHub ↗ · v1.0.0 · MIT-0

cross-platform ⚠ suspicious

Downloads

Stars

Active Installs

Versions

Install in OpenClaw

/install maxhub-tiktok

Description

TikTok/TikTok平台TikTok数据采集、创作者分析与电商洞察。当用户提到tiktok、国际版抖音、海外短视频、creator、analytics等相关需求时激活此Skill。

README (SKILL.md)

🎶 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 p、获取用户的个人信息/Get user p、获取探索作品数据/Get explore
数据分析	20	获取直播间排行榜数据/Get live 、音乐排行榜/Music Chart Li、获取直播每日榜单数据/Get live
搜索查询	32	获取每日趋势搜索关键词/Get dail、搜索用户/Search user、获取综合搜索列表/Get general
互动操作	20	获取用户的点赞列表/Get user l、获取用户的粉丝列表/Get user f、获取用户的收藏列表/Get user f
工具服务	4	生成哈希ID/Generate has、生成TikTok分享链接/Generate、生成TikTok分享链接/Generate
内容解析	7	提取列表用户sec_user_id/Ex、提取单个作品id/Extract sin、提取列表作品id/Extract lis
创作者/达人	12	获取创作者橱窗商品列表/Get crea、获取创作者账号概览/Get Creato、获取带货创作者信息/Get shoppi

🚀 快速开始

首次使用

如果您是第一次使用本 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 不会修改任何系统配置文件

智能调度规则

1. 意图识别 → API选择

根据用户描述，按以下优先级匹配API：

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

2. 链式调用策略

当单个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达人列表

3. 参数智能填充

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

⚡ 调用限制

为保护用户账户安全和控制费用，本Skill遵循以下限制：

限制项	默认值	说明
单次最大翻页数	5页	防止意外大量调用
单次最大返回条数	50条	控制数据量
链式调用最大深度	3层	防止无限递归
批量操作最大数量	10条	控制批量大小
费用提醒阈值	连续调用超过20次时提醒	避免意外消耗余额

重要规则：

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

API详细目录

数据采集

获取单个作品数据/Get single video data
- GET /api/v1/tiktok/web/fetch_post_detail（必填: itemId）
获取单个作品数据 V2/Get single video data V2
- GET /api/v1/tiktok/web/fetch_post_detail_v2（必填: itemId）
获取探索作品数据/Get explore video data
- GET /api/v1/tiktok/web/fetch_explore_post
获取用户的个人信息/Get user profile
- GET /api/v1/tiktok/web/fetch_user_profile
获取用户的作品列表/Get user posts
- GET /api/v1/tiktok/web/fetch_user_post（必填: secUid）
获取用户的转发作品列表/Get user reposts
- GET /api/v1/tiktok/web/fetch_user_repost（必填: 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（必填: token, device_id, verifyFp, region, proxy）

认证SSO登录/Authenticate SSO login

GET /api/v1/tiktok/web/fetch_sso_login_auth（必填: device_id, verifyFp, region, proxy）

根据Gift ID查询礼物名称/Get gift name by gift ID

POST /api/v1/tiktok/web/fetch_gift_name_by_id

批量查询Gift ID对应的礼物名称($0.025/次,建议50个)/Batch get gift names by gift IDs ($0.025/call, suggest 50)

POST /api/v1/tiktok/web/fetch_gift_names_by_ids

获取单个作品数据/Get single video data

GET /api/v1/tiktok/app/v3/fetch_one_video（必填: aweme_id）

获取单个作品数据 V2/Get single video data V2

GET /api/v1/tiktok/app/v3/fetch_one_video_v2（必填: aweme_id）

获取单个作品数据 V3(支持国家参数)/Get single video data V3 (support country parameter)

GET /api/v1/tiktok/app/v3/fetch_one_video_v3（必填: aweme_id）

批量获取视频信息/Batch Get Video Information

POST /api/v1/tiktok/app/v3/fetch_multi_video

批量获取视频信息 V2/Batch Get Video Information V2

POST /api/v1/tiktok/app/v3/fetch_multi_video_v2

根据分享链接获取单个作品数据/Get single video data by sharing link

GET /api/v1/tiktok/app/v3/fetch_one_video_by_share_url_v2（必填: share_url）

根据分享链接获取单个作品数据/Get single video data by sharing link

GET /api/v1/tiktok/app/v3/fetch_one_video_by_share_url（必填: share_url）

使用用户名获取用户 user_id 和 sec_user_id/Get user_id and sec_user_id by Username

GET /api/v1/tiktok/app/v3/get_user_id_and_sec_user_id_by_username（必填: username）

获取指定用户的信息/Get information of specified user

GET /api/v1/tiktok/app/v3/handler_user_profile

获取指定 Webcast 用户的信息/Get information of specified Webcast user

GET /api/v1/tiktok/app/v3/fetch_webcast_user_info

通过用户名获取用户账号国家地区/Get user account country by username

GET /api/v1/tiktok/app/v3/fetch_user_country_by_username（必填: username）

获取类似用户推荐/Similar User Recommendations

GET /api/v1/tiktok/app/v3/fetch_similar_user_recommendations（必填: sec_uid）

获取用户转发的作品数据/Get user repost video data

GET /api/v1/tiktok/app/v3/fetch_user_repost_videos（必填: user_id）

获取用户主页作品数据 V1/Get user homepage video data V1

GET /api/v1/tiktok/app/v3/fetch_user_post_videos

获取用户主页作品数据 V2/Get user homepage video data V2

GET /api/v1/tiktok/app/v3/fetch_user_post_videos_v2

获取用户主页作品数据 V3（精简数据-更快速）/Get user homepage video data V3 (simplified data - faster)

GET /api/v1/tiktok/app/v3/fetch_user_post_videos_v3

获取指定音乐的详情数据/Get details of specified music

GET /api/v1/tiktok/app/v3/fetch_music_detail（必填: music_id）

获取指定音乐的视频列表数据/Get video list of specified music

GET /api/v1/tiktok/app/v3/fetch_music_video_list（必填: music_id）

获取指定话题的详情数据/Get details of specified hashtag

GET /api/v1/tiktok/app/v3/fetch_hashtag_detail（必填: ch_id）

获取指定话题的作品数据/Get video list of specified hashtag

GET /api/v1/tiktok/app/v3/fetch_hashtag_video_list（必填: ch_id）

获取指定直播间的数据/Get data of specified live room

GET /api/v1/tiktok/app/v3/fetch_live_room_info（必填: room_id）

检测直播间是否在线/Check if live room is online

GET /api/v1/tiktok/app/v3/check_live_room_online（必填: room_id）

批量检测直播间是否在线/Batch check if live rooms are online

POST /api/v1/tiktok/app/v3/check_live_room_online_batch

获取分享短链接/Get share short link

GET /api/v1/tiktok/app/v3/fetch_share_short_link（必填: url）

获取分享二维码/Get share QR code

GET /api/v1/tiktok/app/v3/fetch_share_qr_code（必填: object_id）

通过分享链接获取店铺ID/Get Shop ID by Share Link

GET /api/v1/tiktok/app/v3/fetch_shop_id_by_share_link（必填: share_link）

通过分享链接获取商品ID/Get Product ID by Share Link

GET /api/v1/tiktok/app/v3/fetch_product_id_by_share_link（必填: share_link）

获取商品详情数据（即将弃用，使用 fetch_product_detail_v2 代替）/Get product detail data (will be deprecated, use fetch_product_detail_v2 instead)

GET /api/v1/tiktok/app/v3/fetch_product_detail（必填: product_id）

获取商品详情数据V2/Get product detail data V2

GET /api/v1/tiktok/app/v3/fetch_product_detail_v2（必填: product_id）

获取商品详情数据V3 / Get product detail data V3

GET /api/v1/tiktok/app/v3/fetch_product_detail_v3（必填: product_id）

获取商品详情数据V4 / Get product detail data V4

GET /api/v1/tiktok/app/v3/fetch_product_detail_v4（必填: product_id）

获取商品评价数据/Get product review data

GET /api/v1/tiktok/app/v3/fetch_product_review（必填: product_id）

获取商家主页Page列表数据/Get shop home page list data

GET /api/v1/tiktok/app/v3/fetch_shop_home_page_list（必填: seller_id）

获取商家主页数据/Get shop home page data

GET /api/v1/tiktok/app/v3/fetch_shop_home（必填: page_id, seller_id）

获取商家商品推荐数据/Get shop product recommend data

GET /api/v1/tiktok/app/v3/fetch_shop_product_recommend（必填: seller_id）

获取商家商品列表数据/Get shop product list data

GET /api/v1/tiktok/app/v3/fetch_shop_product_list（必填: seller_id）

获取商家商品列表数据 V2/Get shop product list data V2

GET /api/v1/tiktok/app/v3/fetch_shop_product_list_v2（必填: seller_id）

获取商家信息数据/Get shop information data

GET /api/v1/tiktok/app/v3/fetch_shop_info（必填: shop_id）

获取商家产品分类数据/Get shop product category data

GET /api/v1/tiktok/app/v3/fetch_shop_product_category（必填: seller_id）

获取用户音乐列表数据/Get user music list data

GET /api/v1/tiktok/app/v3/fetch_user_music_list（必填: sec_uid）

获取内容翻译数据/Get content translation data

POST /api/v1/tiktok/app/v3/fetch_content_translate

获取主页视频推荐数据/Get home feed(recommend) video data

POST /api/v1/tiktok/app/v3/fetch_home_feed

TikTok APP加密算法/TikTok APP encryption algorithm

POST /api/v1/tiktok/app/v3/TTencrypt_algorithm

获取直播间商品列表数据/Get live room product list data

GET /api/v1/tiktok/app/v3/fetch_live_room_product_list（必填: room_id, author_id）

获取直播间商品列表数据 V2 /Get live room product list data V2

GET /api/v1/tiktok/app/v3/fetch_live_room_product_list_v2（必填: room_id, author_id）

加密或解密 TikTok APP 登录请求体/Encrypt or Decrypt TikTok APP login request body

POST /api/v1/tiktok/app/v3/encrypt_decrypt_login_request

获取单个广告详情/Get single ad detail

GET /api/v1/tiktok/ads/get_ads_detail（必填: ads_id）

获取关键词洞察数据/Get keyword insights data

GET /api/v1/tiktok/ads/get_keyword_insights

获取热门产品列表/Get top products list

GET /api/v1/tiktok/ads/get_top_products

获取热门标签列表/Get popular hashtags list

GET /api/v1/tiktok/ads/get_hashtag_list

获取关键词列表/Get keyword list

GET /api/v1/tiktok/ads/get_keyword_list

获取热门广告聚光灯/Get top ads spotlight

GET /api/v1/tiktok/ads/get_top_ads_spotlight

获取广告百分位数据/Get ad percentile data

GET /api/v1/tiktok/ads/get_ad_percentile（必填: material_id）

获取推荐广告/Get recommended ads

GET /api/v1/tiktok/ads/get_recommended_ads（必填: material_id）

获取关键词筛选器/Get keyword filters

GET /api/v1/tiktok/ads/get_keyword_filters

获取相关关键词/Get related keywords

GET /api/v1/tiktok/ads/get_related_keywords

获取关键词详细信息/Get keyword details

GET /api/v1/tiktok/ads/get_keyword_details

获取产品筛选器/Get product filters

GET /api/v1/tiktok/ads/get_product_filters

获取产品指标数据/Get product metrics

GET /api/v1/tiktok/ads/get_product_metrics（必填: id）

获取产品详细信息/Get product detail

GET /api/v1/tiktok/ads/get_product_detail（必填: id）

获取标签筛选器/Get hashtag filters

GET /api/v1/tiktok/ads/get_hashtag_filters

获取音乐筛选器/Get sound filters

GET /api/v1/tiktok/ads/get_sound_filters

获取音乐详情/Get sound detail

GET /api/v1/tiktok/ads/get_sound_detail（必填: clip_id）

获取音乐推荐/Get sound recommendations

GET /api/v1/tiktok/ads/get_sound_recommendations（必填: clip_id）

获取商品详情V1(桌面端-数据完整)/Get product detail V1(Full data)

GET /api/v1/tiktok/shop/web/fetch_product_detail（必填: product_id）

获取商品详情V2(移动端-数据少)/Get product detail V2 (Less Data)

GET /api/v1/tiktok/shop/web/fetch_product_detail_v2（必填: product_id）

获取商品详情V3(移动端-数据完整)/Get product detail V3 (Full Data)

GET /api/v1/tiktok/shop/web/fetch_product_detail_v3（必填: product_id）

获取商家商品列表V1/Get seller products list V1

GET /api/v1/tiktok/shop/web/fetch_seller_products_list（必填: seller_id）

获取商家商品列表V2(移动端)/Get seller products list V2 (Mobile)

GET /api/v1/tiktok/shop/web/fetch_seller_products_list_v2（必填: seller_id）

获取商品分类列表/Get product category list

GET /api/v1/tiktok/shop/web/fetch_products_category_list

根据分类ID获取商品列表/Get products by category ID

GET /api/v1/tiktok/shop/web/fetch_products_by_category_id（必填: category_id）

获取热卖商品列表/Get hot selling products list

GET /api/v1/tiktok/shop/web/fetch_hot_selling_products_list

数据分析

获取每日热门内容作品数据/Get daily trending video data
- GET /api/v1/tiktok/web/fetch_trending_post
音乐排行榜/Music Chart List
- GET /api/v1/tiktok/app/v3/fetch_music_chart_list
获取直播间排行榜数据/Get live room ranking list
- GET /api/v1/tiktok/app/v3/fetch_live_ranking_list（必填: room_id, anchor_id）
获取直播每日榜单数据/Get live daily rank data
- GET /api/v1/tiktok/app/v3/fetch_live_daily_rank
获取创作者直播概览/Get Creator Live Overview
- POST /api/v1/tiktok/creator/get_live_analytics_summary
获取创作者视频概览/Get Creator Video Overview
- POST /api/v1/tiktok/creator/get_video_analytics_summary
获取创作者视频列表分析/Get Creator Video List Analytics
- POST /api/v1/tiktok/creator/get_video_list_analytics
获取创作者商品列表分析/Get Creator Product List Analytics
- POST /api/v1/tiktok/creator/get_product_analytics_list
获取视频详细分段统计数据/Get Video Detailed Statistics
- POST /api/v1/tiktok/creator/get_video_detailed_stats
获取视频与商品关联统计数据/Get Video-Product Association Statistics

POST /api/v1/tiktok/creator/get_video_to_product_stats

获取视频受众分析数据/Get Video Audience Analysis Data

POST /api/v1/tiktok/creator/get_video_audience_stats

获取作品的统计数据/Get video metrics

GET /api/v1/tiktok/analytics/fetch_video_metrics（必填: item_id）

检测视频虚假流量分析/Detect fake views in video

GET /api/v1/tiktok/analytics/detect_fake_views（必填: item_id）

获取视频评论关键词分析/Get comment keywords analysis

GET /api/v1/tiktok/analytics/fetch_comment_keywords（必填: item_id）

获取创作者信息和里程碑数据/Get creator info and milestones

GET /api/v1/tiktok/analytics/fetch_creator_info_and_milestones（必填: user_id）

获取热门音乐排行榜/Get popular sound rankings

GET /api/v1/tiktok/ads/get_sound_rank_list

获取广告关键帧分析/Get ad keyframe analysis

GET /api/v1/tiktok/ads/get_ad_keyframe_analysis（必填: material_id）

获取广告互动分析/Get ad interactive analysis

GET /api/v1/tiktok/ads/get_ad_interactive_analysis（必填: material_id）

获取创意模式排行榜/Get creative pattern rankings

GET /api/v1/tiktok/ads/get_creative_patterns

获取流行趋势视频/Get popular trend videos

GET /api/v1/tiktok/ads/get_popular_trends

搜索查询

获取每日趋势搜索关键词/Get daily trending search words
- GET /api/v1/tiktok/web/fetch_trending_searchwords
获取综合搜索列表/Get general search list
- GET /api/v1/tiktok/web/fetch_general_search（必填: keyword）
搜索关键字推荐/Search keyword suggest
- GET /api/v1/tiktok/web/fetch_search_keyword_suggest（必填: keyword）
搜索用户/Search user
- GET /api/v1/tiktok/web/fetch_search_user（必填: keyword）
搜索视频/Search video
- GET /api/v1/tiktok/web/fetch_search_video（必填: keyword）
搜索直播/Search live
- GET /api/v1/tiktok/web/fetch_search_live（必填: keyword）
搜索照片/Search photo
- GET /api/v1/tiktok/web/fetch_search_photo（必填: keyword）
获取指定关键词的综合搜索结果/Get comprehensive search results of specified keywords
- GET /api/v1/tiktok/app/v3/fetch_general_search_result（必填: keyword）
获取指定关键词的视频搜索结果/Get video search results of specified keywords
- GET /api/v1/tiktok/app/v3/fetch_video_search_result（必填: keyword）
获取指定关键词的用户搜索结果/Get user search results of specified keywords

GET /api/v1/tiktok/app/v3/fetch_user_search_result（必填: keyword）

获取指定关键词的音乐搜索结果/Get music search results of specified keywords

GET /api/v1/tiktok/app/v3/fetch_music_search_result（必填: keyword）

获取指定关键词的话题搜索结果/Get hashtag search results of specified keywords

GET /api/v1/tiktok/app/v3/fetch_hashtag_search_result（必填: keyword）

获取指定关键词的直播搜索结果/Get live search results of specified keywords

GET /api/v1/tiktok/app/v3/fetch_live_search_result（必填: keyword）

获取地点搜索结果/Get location search results

GET /api/v1/tiktok/app/v3/fetch_location_search（必填: keyword）

创作者搜索洞察/Creator Search Insights

GET /api/v1/tiktok/app/v3/fetch_creator_search_insights

创作者搜索洞察详情/Creator Search Insights Detail

GET /api/v1/tiktok/app/v3/fetch_creator_search_insights_detail（必填: query_id_str）

创作者搜索洞察趋势/Creator Search Insights Trend

GET /api/v1/tiktok/app/v3/fetch_creator_search_insights_trend（必填: query_id_str）

创作者搜索洞察相关视频/Creator Search Insights Videos

GET /api/v1/tiktok/app/v3/fetch_creator_search_insights_videos（必填: keyword）

搜索粉丝列表/Search follower list

GET /api/v1/tiktok/app/v3/search_follower_list（必填: user_id, keyword）

搜索关注列表/Search following list

GET /api/v1/tiktok/app/v3/search_following_list（必填: user_id, keyword）

获取商品搜索结果/Get product search results

GET /api/v1/tiktok/app/v3/fetch_product_search（必填: keyword）

生成TikTok分享链接，唤起TikTok APP，跳转指定关键词搜索结果/Generate TikTok share link, call TikTok APP, and jump to the specified keyword search result

GET /api/v1/tiktok/app/v3/open_tiktok_app_to_keyword_search（必填: keyword）

搜索广告/Search ads

GET /api/v1/tiktok/ads/search_ads

获取查询建议/Get query suggestions

GET /api/v1/tiktok/ads/get_query_suggestions

搜索音乐提示/Search sound hints

GET /api/v1/tiktok/ads/search_sound_hint（必填: keyword）

搜索音乐/Search sounds

GET /api/v1/tiktok/ads/search_sound（必填: keyword）

搜索创作者/Search creators

GET /api/v1/tiktok/ads/search_creators（必填: keyword）

获取搜索关键词建议V1/Get search keyword suggestions V1

GET /api/v1/tiktok/shop/web/fetch_search_word_suggestion（必填: search_word）

获取搜索关键词建议V2(移动端)/Get search keyword suggestions V2 (Mobile)

GET /api/v1/tiktok/shop/web/fetch_search_word_suggestion_v2（必填: search_word）

搜索商品列表V1/Search products list V1

GET /api/v1/tiktok/shop/web/fetch_search_products_list（必填: search_word）

搜索商品列表V2(移动端)/Search products list V2 (Mobile)

GET /api/v1/tiktok/shop/web/fetch_search_products_list_v2（必填: search_word）

搜索商品列表V3/Search products list V3

GET /api/v1/tiktok/shop/web/fetch_search_products_list_v3（必填: keyword）

互动操作

获取用户的点赞列表/Get user likes
- GET /api/v1/tiktok/web/fetch_user_like（必填: secUid）
获取用户的收藏列表/Get user favorites
- GET /api/v1/tiktok/web/fetch_user_collect（必填: cookie, secUid）
获取作品的评论列表/Get video comments
- GET /api/v1/tiktok/web/fetch_post_comment（必填: aweme_id）
获取作品的评论回复列表/Get video comment replies
- GET /api/v1/tiktok/web/fetch_post_comment_reply（必填: item_id, comment_id）
获取用户的粉丝列表/Get user followers
- GET /api/v1/tiktok/web/fetch_user_fans（必填: secUid）
获取用户的关注列表/Get user followings
- GET /api/v1/tiktok/web/fetch_user_follow（必填: secUid）
获取用户喜欢作品数据/Get user like video data
- GET /api/v1/tiktok/app/v3/fetch_user_like_videos（必填: sec_user_id）
获取单个视频评论数据/Get single video comments data
- GET /api/v1/tiktok/app/v3/fetch_video_comments（必填: aweme_id）
获取指定视频的评论回复数据/Get comment replies data of specified video
- GET /api/v1/tiktok/app/v3/fetch_video_comment_replies（必填: item_id, comment_id）
获取指定用户的粉丝列表数据/Get follower list of specified user

GET /api/v1/tiktok/app/v3/fetch_user_follower_list

获取指定用户的关注列表数据/Get following list of specified user

GET /api/v1/tiktok/app/v3/fetch_user_following_list

获取商品评论V1/Get product reviews V1

GET /api/v1/tiktok/shop/web/fetch_product_reviews_v1（必填: product_id）

获取商品评论V2/Get product reviews V2

GET /api/v1/tiktok/shop/web/fetch_product_reviews_v2（必填: product_id）

申请使用TikTok交互API权限（Scope）/Apply for TikTok Interaction API permission (Scope)

GET /api/v1/tiktok/interaction/apply（必填: api_key, invite_code）

发送评论/Post comment

POST /api/v1/tiktok/interaction/post_comment

回复评论/Reply to comment

POST /api/v1/tiktok/interaction/reply_comment

点赞/Like

POST /api/v1/tiktok/interaction/like

关注/Follow

POST /api/v1/tiktok/interaction/follow

收藏/Collect

POST /api/v1/tiktok/interaction/collect

转发/Forward

POST /api/v1/tiktok/interaction/forward

工具服务

生成哈希ID/Generate hashed ID
- GET /api/v1/tiktok/web/generate_hashed_id（必填: email）
生成TikTok分享链接，唤起TikTok APP，跳转指定作品详情页/Generate TikTok share link, call TikTok APP, and jump to the specified video details page
- GET /api/v1/tiktok/app/v3/open_tiktok_app_to_video_detail（必填: aweme_id）
生成TikTok分享链接，唤起TikTok APP，跳转指定用户主页/Generate TikTok share link, call TikTok APP, and jump to the specified user profile
- GET /api/v1/tiktok/app/v3/open_tiktok_app_to_user_profile（必填: uid）
生成TikTok分享链接，唤起TikTok APP，给指定用户发送私信/Generate TikTok share link, call TikTok APP, and send private messages to specified users
- GET /api/v1/tiktok/app/v3/open_tiktok_app_to_send_private_message（必填: uid）

内容解析

提取用户user_id/Extract user user_id
- GET /api/v1/tiktok/web/get_user_id（必填: url）
提取用户sec_user_id/Extract user sec_user_id
- GET /api/v1/tiktok/web/get_sec_user_id（必填: url）
提取列表用户sec_user_id/Extract list user sec_user_id
- POST /api/v1/tiktok/web/get_all_sec_user_id
提取单个作品id/Extract single video id
- GET /api/v1/tiktok/web/get_aweme_id（必填: url）
提取列表作品id/Extract list video id
- POST /api/v1/tiktok/web/get_all_aweme_id
提取直播间弹幕/Extract live room danmaku
- GET /api/v1/tiktok/web/tiktok_live_room（必填: live_room_url, danmaku_type）
根据直播间链接提取直播间ID/Extract live room ID from live room link
- GET /api/v1/tiktok/web/get_live_room_id（必填: live_room_url）

创作者/达人

获取带货创作者信息/Get shopping creator information
- GET /api/v1/tiktok/app/v3/fetch_creator_info（必填: creator_uid）
获取创作者橱窗商品列表/Get creator showcase product list
- GET /api/v1/tiktok/app/v3/fetch_creator_showcase_product_list（必填: kol_id）
获取创作者账号健康状态/Get Creator Account Health Status
- POST /api/v1/tiktok/creator/get_account_health_status
获取创作者账号违规记录列表/Get Creator Account Violation Record List
- POST /api/v1/tiktok/creator/get_account_violation_list
获取创作者账号概览/Get Creator Account Overview
- POST /api/v1/tiktok/creator/get_account_insights_overview
获取创作者账号信息/Get Creator Account Info
- POST /api/v1/tiktok/creator/get_creator_account_info
获取橱窗商品列表/Get Showcase Product List
- POST /api/v1/tiktok/creator/get_showcase_product_list
获取视频关联商品列表/Get Video Associated Product List
- POST /api/v1/tiktok/creator/get_video_associated_product_list
获取同款商品关联视频/Get Product Related Videos
- POST /api/v1/tiktok/creator/get_product_related_videos
获取标签创作者信息/Get hashtag creator info

GET /api/v1/tiktok/ads/get_hashtag_creator（必填: hashtag）

获取创作者筛选器/Get creator filters

GET /api/v1/tiktok/ads/get_creator_filters

获取创作者列表/Get creator list

GET /api/v1/tiktok/ads/get_creator_list

调用示例

基础调用

curl -X GET "${MAXHUB_BASE_URL}/api/v1/douyin/web/fetch_hot_search_result" \
  -H "x-api-key: $MAXHUB_API_KEY" \
  -H "Content-Type: application/json"

带参数调用

curl -X GET "${MAXHUB_BASE_URL}/api/v1/douyin/web/fetch_one_video?aweme_id=123456" \
  -H "x-api-key: $MAXHUB_API_KEY"

POST请求

curl -X POST "${MAXHUB_BASE_URL}/api/v1/douyin/web/fetch_user_like_videos" \
  -H "x-api-key: $MAXHUB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"sec_user_id": "xxx"}'

带参数调用

curl -X GET "BASE_URL/API_PATH?param1=value1&param2=value2" \
  -H "x-api-key: $MAXHUB_API_KEY"

POST请求

curl -X POST "BASE_URL/API_PATH" \
  -H "x-api-key: $MAXHUB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"key": "value"}'

注意事项

所有请求必须携带有效的MaxHub API Key
API调用按次计费，注意控制调用次数
遵守平台数据使用规范，不采集敏感个人隐私数据
分页数据建议逐页获取，避免一次性请求过多
高频调用注意限流（默认60次/分钟）

Usage Guidance

Review this skill before installing. If you only need public TikTok analytics, restrict use to public data endpoints, keep MAXHUB_BASE_URL trusted, monitor MaxHub API usage/costs, and do not allow SSO, login, device registration, proxy, or encryption endpoints unless you explicitly intend to use those capabilities.

Capability Analysis

Type: OpenClaw Skill Name: maxhub-tiktok Version: 1.0.0 The skill bundle provides an extensive interface to over 200 TikTok-related APIs via a third-party proxy (aconfig.cn). While aligned with its stated purpose of data analysis, it includes high-risk capabilities such as automated account interactions (liking, following, commenting) and SSO login/session management (fetch_sso_login_status, fetch_sso_login_auth) in SKILL.md and references/api-catalog.md. These features allow an AI agent to perform actions on behalf of a user's account and handle sensitive session tokens, which poses a significant risk of account misuse or credential exposure if the agent is manipulated via prompt injection.

Capability Tags

requires-sensitive-credentials

Capability Assessment

⚠ Purpose & Capability

The stated purpose is TikTok public data collection, creator analysis, and ecommerce insight, but the included catalog also exposes SSO login/authentication, device registration, proxy-related inputs, and app/login encryption endpoints that are not clearly necessary for public analytics.

⚠ Instruction Scope

The skill tells the agent to intelligently choose among all available APIs and chain calls. Because the available APIs include login/auth and encryption-style endpoints, the boundaries for when those high-impact paths may be used are not clear enough.

ℹ Install Mechanism

There is no install code and no local execution mechanism, so the static scan being clean is expected. The user still has to trust the external MaxHub API service and configure a MaxHub API key.

ℹ Credentials

Reading MAXHUB_API_KEY and calling the MaxHub HTTPS API is proportionate for this integration, but the key may control paid API usage and should only be sent to a trusted MAXHUB_BASE_URL.

⚠ Persistence & Privilege

The artifacts do not show local persistence or filesystem access, but the remote API catalog includes TikTok account/login-session related flows using tokens, device identifiers, verifyFp, region, and proxy parameters.

How to Use

Make sure OpenClaw is installed (local or Docker)
Run the install command in chat: /install maxhub-tiktok
After installation, invoke the skill by name or use /maxhub-tiktok
Provide required inputs per the skill's parameter spec and get structured output

Version History

v1.0.0

maxhub-tiktok 1.0.0 - 首次发布，提供TikTok平台的数据采集、创作者分析及电商洞察能力。 - 支持194个API，涵盖数据采集、数据分析、搜索、互动、工具、内容解析等7大能力域。 - 所有API通过MaxHub中转站调用，仅需API Key认证，保障数据与环境安全。 - 智能调度API，支持链式调用与参数自动填充。 - 内置调用次数、翻页、批量等使用限制，防止超额消耗与安全隐患。 - 提供详细的API目录和使用指南，支持多样化的TikTok数据服务场景。

Metadata

Slug maxhub-tiktok

Version 1.0.0

License MIT-0

All-time Installs 0

Active Installs 0

Total Versions 1

Frequently Asked Questions

What is maxhub-tiktok?

TikTok/TikTok平台TikTok数据采集、创作者分析与电商洞察。当用户提到tiktok、国际版抖音、海外短视频、creator、analytics等相关需求时激活此Skill。 It is an AI Agent Skill for Claude Code / OpenClaw, with 23 downloads so far.

How do I install maxhub-tiktok?

Run "/install maxhub-tiktok" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is maxhub-tiktok free?

Yes, maxhub-tiktok is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does maxhub-tiktok support?

maxhub-tiktok is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created maxhub-tiktok?

It is built and maintained by Xie Hao (@xiewxx); the current version is v1.0.0.

More Skills

maxhub-tiktok

🎶 TikTok（TikTok）Skill

认证方式

API能力全景

🚀 快速开始

首次使用

API 调用格式

认证说明

🔒 安全声明

智能调度规则

1. 意图识别 → API选择

2. 链式调用策略

3. 参数智能填充

⚡ 调用限制

API详细目录

数据采集

数据分析

搜索查询

互动操作

工具服务

内容解析

创作者/达人

调用示例

基础调用

带参数调用

POST请求

带参数调用

POST请求

注意事项

What is maxhub-tiktok?

How do I install maxhub-tiktok?

Is maxhub-tiktok free?

Which platforms does maxhub-tiktok support?

Who created maxhub-tiktok?

💬 Comments