← 返回 Skills 市场
xiewxx

maxhub-tiktok

作者 Xie Hao · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
23
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install maxhub-tiktok
功能描述
TikTok/TikTok平台TikTok数据采集、创作者分析与电商洞察。当用户提到tiktok、国际版抖音、海外短视频、creator、analytics等相关需求时激活此Skill。
使用说明 (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，请先完成以下步骤：

  1. 访问 MaxHub 官网 注册账号
  2. 在控制台创建 API Key
  3. 将 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：

  1. 精确匹配：用户明确指定操作（如"搜索xxx的视频"→搜索API）
  2. 语义推断：根据上下文推断意图（如"这个博主有多少粉丝"→用户信息API）
  3. 默认兜底：无法精确匹配时，优先使用搜索类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详细目录

数据采集

  1. 获取单个作品数据/Get single video data
    • GET /api/v1/tiktok/web/fetch_post_detail（必填: itemId）
  2. 获取单个作品数据 V2/Get single video data V2
    • GET /api/v1/tiktok/web/fetch_post_detail_v2（必填: itemId）
  3. 获取探索作品数据/Get explore video data
    • GET /api/v1/tiktok/web/fetch_explore_post
  4. 获取用户的个人信息/Get user profile
    • GET /api/v1/tiktok/web/fetch_user_profile
  5. 获取用户的作品列表/Get user posts
    • GET /api/v1/tiktok/web/fetch_user_post（必填: secUid）
  6. 获取用户的转发作品列表/Get user reposts
    • GET /api/v1/tiktok/web/fetch_user_repost（必填: secUid）
  7. 获取用户的播放列表/Get user play list
    • GET /api/v1/tiktok/web/fetch_user_play_list（必填: secUid）
  8. 获取用户的合辑列表/Get user mix list
    • GET /api/v1/tiktok/web/fetch_user_mix（必填: mixId）
  9. 获取用户的直播详情/Get user live details
    • GET /api/v1/tiktok/web/fetch_user_live_detail（必填: uniqueId）
  10. Tag详情/Tag Detail
  • GET /api/v1/tiktok/web/fetch_tag_detail（必填: tag_name）
  1. Tag作品/Tag Post
  • GET /api/v1/tiktok/web/fetch_tag_post（必填: challengeID）
  1. 首页推荐作品/Home Feed
  • POST /api/v1/tiktok/web/fetch_home_feed
  1. 加密strData/Encrypt strData
  • GET /api/v1/tiktok/web/encrypt_strData（必填: data）
  1. 解密strData/Decrypt strData
  • GET /api/v1/tiktok/web/decrypt_strData（必填: encrypted_data）
  1. 获取用户unique_id/Get user unique_id
  • GET /api/v1/tiktok/web/get_unique_id（必填: url）
  1. 获取列表unique_id/Get list unique_id
  • POST /api/v1/tiktok/web/get_all_unique_id
  1. TikTok直播间弹幕参数获取/tiktok live room danmaku parameters
  • GET /api/v1/tiktok/web/fetch_live_im_fetch（必填: room_id）
  1. 直播间开播状态检测/Live room start status check
  • GET /api/v1/tiktok/web/fetch_check_live_alive（必填: room_id）
  1. 批量直播间开播状态检测/Batch live room start status check
  • GET /api/v1/tiktok/web/fetch_batch_check_live_alive（必填: room_ids）
  1. 通过直播链接获取直播间信息/Get live room information via live link
  • GET /api/v1/tiktok/web/fetch_tiktok_live_data（必填: live_room_url）
  1. 获取直播间首页推荐列表/Get live room homepage recommendation list
  • GET /api/v1/tiktok/web/fetch_live_recommend（必填: related_live_tag）
  1. 获取直播间礼物列表/Get live room gift list
  • GET /api/v1/tiktok/web/fetch_live_gift_list
  1. 获取SSO登录二维码/Get SSO login QR code
  • GET /api/v1/tiktok/web/fetch_sso_login_qrcode（必填: device_id, region, proxy）
  1. 获取SSO登录状态/Get SSO login status
  • GET /api/v1/tiktok/web/fetch_sso_login_status（必填: token, device_id, verifyFp, region, proxy）
  1. 认证SSO登录/Authenticate SSO login
  • GET /api/v1/tiktok/web/fetch_sso_login_auth（必填: device_id, verifyFp, region, proxy）
  1. 根据Gift ID查询礼物名称/Get gift name by gift ID
  • POST /api/v1/tiktok/web/fetch_gift_name_by_id
  1. 批量查询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
  1. 获取单个作品数据/Get single video data
  • GET /api/v1/tiktok/app/v3/fetch_one_video（必填: aweme_id）
  1. 获取单个作品数据 V2/Get single video data V2
  • GET /api/v1/tiktok/app/v3/fetch_one_video_v2（必填: aweme_id）
  1. 获取单个作品数据 V3(支持国家参数)/Get single video data V3 (support country parameter)
  • GET /api/v1/tiktok/app/v3/fetch_one_video_v3（必填: aweme_id）
  1. 批量获取视频信息/Batch Get Video Information
  • POST /api/v1/tiktok/app/v3/fetch_multi_video
  1. 批量获取视频信息 V2/Batch Get Video Information V2
  • POST /api/v1/tiktok/app/v3/fetch_multi_video_v2
  1. 根据分享链接获取单个作品数据/Get single video data by sharing link
  • GET /api/v1/tiktok/app/v3/fetch_one_video_by_share_url_v2（必填: share_url）
  1. 根据分享链接获取单个作品数据/Get single video data by sharing link
  • GET /api/v1/tiktok/app/v3/fetch_one_video_by_share_url（必填: share_url）
  1. 使用用户名获取用户 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）
  1. 获取指定用户的信息/Get information of specified user
  • GET /api/v1/tiktok/app/v3/handler_user_profile
  1. 获取指定 Webcast 用户的信息/Get information of specified Webcast user
  • GET /api/v1/tiktok/app/v3/fetch_webcast_user_info
  1. 通过用户名获取用户账号国家地区/Get user account country by username
  • GET /api/v1/tiktok/app/v3/fetch_user_country_by_username（必填: username）
  1. 获取类似用户推荐/Similar User Recommendations
  • GET /api/v1/tiktok/app/v3/fetch_similar_user_recommendations（必填: sec_uid）
  1. 获取用户转发的作品数据/Get user repost video data
  • GET /api/v1/tiktok/app/v3/fetch_user_repost_videos（必填: user_id）
  1. 获取用户主页作品数据 V1/Get user homepage video data V1
  • GET /api/v1/tiktok/app/v3/fetch_user_post_videos
  1. 获取用户主页作品数据 V2/Get user homepage video data V2
  • GET /api/v1/tiktok/app/v3/fetch_user_post_videos_v2
  1. 获取用户主页作品数据 V3（精简数据-更快速）/Get user homepage video data V3 (simplified data - faster)
  • GET /api/v1/tiktok/app/v3/fetch_user_post_videos_v3
  1. 获取指定音乐的详情数据/Get details of specified music
  • GET /api/v1/tiktok/app/v3/fetch_music_detail（必填: music_id）
  1. 获取指定音乐的视频列表数据/Get video list of specified music
  • GET /api/v1/tiktok/app/v3/fetch_music_video_list（必填: music_id）
  1. 获取指定话题的详情数据/Get details of specified hashtag
  • GET /api/v1/tiktok/app/v3/fetch_hashtag_detail（必填: ch_id）
  1. 获取指定话题的作品数据/Get video list of specified hashtag
  • GET /api/v1/tiktok/app/v3/fetch_hashtag_video_list（必填: ch_id）
  1. 获取指定直播间的数据/Get data of specified live room
  • GET /api/v1/tiktok/app/v3/fetch_live_room_info（必填: room_id）
  1. 检测直播间是否在线/Check if live room is online
  • GET /api/v1/tiktok/app/v3/check_live_room_online（必填: room_id）
  1. 批量检测直播间是否在线/Batch check if live rooms are online
  • POST /api/v1/tiktok/app/v3/check_live_room_online_batch
  1. 获取分享短链接/Get share short link
  • GET /api/v1/tiktok/app/v3/fetch_share_short_link（必填: url）
  1. 获取分享二维码/Get share QR code
  • GET /api/v1/tiktok/app/v3/fetch_share_qr_code（必填: object_id）
  1. 通过分享链接获取店铺ID/Get Shop ID by Share Link
  • GET /api/v1/tiktok/app/v3/fetch_shop_id_by_share_link（必填: share_link）
  1. 通过分享链接获取商品ID/Get Product ID by Share Link
  • GET /api/v1/tiktok/app/v3/fetch_product_id_by_share_link（必填: share_link）
  1. 获取商品详情数据（即将弃用，使用 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）
  1. 获取商品详情数据V2/Get product detail data V2
  • GET /api/v1/tiktok/app/v3/fetch_product_detail_v2（必填: product_id）
  1. 获取商品详情数据V3 / Get product detail data V3
  • GET /api/v1/tiktok/app/v3/fetch_product_detail_v3（必填: product_id）
  1. 获取商品详情数据V4 / Get product detail data V4
  • GET /api/v1/tiktok/app/v3/fetch_product_detail_v4（必填: product_id）
  1. 获取商品评价数据/Get product review data
  • GET /api/v1/tiktok/app/v3/fetch_product_review（必填: product_id）
  1. 获取商家主页Page列表数据/Get shop home page list data
  • GET /api/v1/tiktok/app/v3/fetch_shop_home_page_list（必填: seller_id）
  1. 获取商家主页数据/Get shop home page data
  • GET /api/v1/tiktok/app/v3/fetch_shop_home（必填: page_id, seller_id）
  1. 获取商家商品推荐数据/Get shop product recommend data
  • GET /api/v1/tiktok/app/v3/fetch_shop_product_recommend（必填: seller_id）
  1. 获取商家商品列表数据/Get shop product list data
  • GET /api/v1/tiktok/app/v3/fetch_shop_product_list（必填: seller_id）
  1. 获取商家商品列表数据 V2/Get shop product list data V2
  • GET /api/v1/tiktok/app/v3/fetch_shop_product_list_v2（必填: seller_id）
  1. 获取商家信息数据/Get shop information data
  • GET /api/v1/tiktok/app/v3/fetch_shop_info（必填: shop_id）
  1. 获取商家产品分类数据/Get shop product category data
  • GET /api/v1/tiktok/app/v3/fetch_shop_product_category（必填: seller_id）
  1. 获取用户音乐列表数据/Get user music list data
  • GET /api/v1/tiktok/app/v3/fetch_user_music_list（必填: sec_uid）
  1. 获取内容翻译数据/Get content translation data
  • POST /api/v1/tiktok/app/v3/fetch_content_translate
  1. 获取主页视频推荐数据/Get home feed(recommend) video data
  • POST /api/v1/tiktok/app/v3/fetch_home_feed
  1. TikTok APP加密算法/TikTok APP encryption algorithm
  • POST /api/v1/tiktok/app/v3/TTencrypt_algorithm
  1. 获取直播间商品列表数据/Get live room product list data
  • GET /api/v1/tiktok/app/v3/fetch_live_room_product_list（必填: room_id, author_id）
  1. 获取直播间商品列表数据 V2 /Get live room product list data V2
  • GET /api/v1/tiktok/app/v3/fetch_live_room_product_list_v2（必填: room_id, author_id）
  1. 加密或解密 TikTok APP 登录请求体/Encrypt or Decrypt TikTok APP login request body
  • POST /api/v1/tiktok/app/v3/encrypt_decrypt_login_request
  1. 获取单个广告详情/Get single ad detail
  • GET /api/v1/tiktok/ads/get_ads_detail（必填: ads_id）
  1. 获取关键词洞察数据/Get keyword insights data
  • GET /api/v1/tiktok/ads/get_keyword_insights
  1. 获取热门产品列表/Get top products list
  • GET /api/v1/tiktok/ads/get_top_products
  1. 获取热门标签列表/Get popular hashtags list
  • GET /api/v1/tiktok/ads/get_hashtag_list
  1. 获取关键词列表/Get keyword list
  • GET /api/v1/tiktok/ads/get_keyword_list
  1. 获取热门广告聚光灯/Get top ads spotlight
  • GET /api/v1/tiktok/ads/get_top_ads_spotlight
  1. 获取广告百分位数据/Get ad percentile data
  • GET /api/v1/tiktok/ads/get_ad_percentile（必填: material_id）
  1. 获取推荐广告/Get recommended ads
  • GET /api/v1/tiktok/ads/get_recommended_ads（必填: material_id）
  1. 获取关键词筛选器/Get keyword filters
  • GET /api/v1/tiktok/ads/get_keyword_filters
  1. 获取相关关键词/Get related keywords
  • GET /api/v1/tiktok/ads/get_related_keywords
  1. 获取关键词详细信息/Get keyword details
  • GET /api/v1/tiktok/ads/get_keyword_details
  1. 获取产品筛选器/Get product filters
  • GET /api/v1/tiktok/ads/get_product_filters
  1. 获取产品指标数据/Get product metrics
  • GET /api/v1/tiktok/ads/get_product_metrics（必填: id）
  1. 获取产品详细信息/Get product detail
  • GET /api/v1/tiktok/ads/get_product_detail（必填: id）
  1. 获取标签筛选器/Get hashtag filters
  • GET /api/v1/tiktok/ads/get_hashtag_filters
  1. 获取音乐筛选器/Get sound filters
  • GET /api/v1/tiktok/ads/get_sound_filters
  1. 获取音乐详情/Get sound detail
  • GET /api/v1/tiktok/ads/get_sound_detail（必填: clip_id）
  1. 获取音乐推荐/Get sound recommendations
  • GET /api/v1/tiktok/ads/get_sound_recommendations（必填: clip_id）
  1. 获取商品详情V1(桌面端-数据完整)/Get product detail V1(Full data)
  • GET /api/v1/tiktok/shop/web/fetch_product_detail（必填: product_id）
  1. 获取商品详情V2(移动端-数据少)/Get product detail V2 (Less Data)
  • GET /api/v1/tiktok/shop/web/fetch_product_detail_v2（必填: product_id）
  1. 获取商品详情V3(移动端-数据完整)/Get product detail V3 (Full Data)
  • GET /api/v1/tiktok/shop/web/fetch_product_detail_v3（必填: product_id）
  1. 获取商家商品列表V1/Get seller products list V1
  • GET /api/v1/tiktok/shop/web/fetch_seller_products_list（必填: seller_id）
  1. 获取商家商品列表V2(移动端)/Get seller products list V2 (Mobile)
  • GET /api/v1/tiktok/shop/web/fetch_seller_products_list_v2（必填: seller_id）
  1. 获取商品分类列表/Get product category list
  • GET /api/v1/tiktok/shop/web/fetch_products_category_list
  1. 根据分类ID获取商品列表/Get products by category ID
  • GET /api/v1/tiktok/shop/web/fetch_products_by_category_id（必填: category_id）
  1. 获取热卖商品列表/Get hot selling products list
  • GET /api/v1/tiktok/shop/web/fetch_hot_selling_products_list

数据分析

  1. 获取每日热门内容作品数据/Get daily trending video data
    • GET /api/v1/tiktok/web/fetch_trending_post
  2. 音乐排行榜/Music Chart List
    • GET /api/v1/tiktok/app/v3/fetch_music_chart_list
  3. 获取直播间排行榜数据/Get live room ranking list
    • GET /api/v1/tiktok/app/v3/fetch_live_ranking_list（必填: room_id, anchor_id）
  4. 获取直播每日榜单数据/Get live daily rank data
    • GET /api/v1/tiktok/app/v3/fetch_live_daily_rank
  5. 获取创作者直播概览/Get Creator Live Overview
    • POST /api/v1/tiktok/creator/get_live_analytics_summary
  6. 获取创作者视频概览/Get Creator Video Overview
    • POST /api/v1/tiktok/creator/get_video_analytics_summary
  7. 获取创作者视频列表分析/Get Creator Video List Analytics
    • POST /api/v1/tiktok/creator/get_video_list_analytics
  8. 获取创作者商品列表分析/Get Creator Product List Analytics
    • POST /api/v1/tiktok/creator/get_product_analytics_list
  9. 获取视频详细分段统计数据/Get Video Detailed Statistics
    • POST /api/v1/tiktok/creator/get_video_detailed_stats
  10. 获取视频与商品关联统计数据/Get Video-Product Association Statistics
  • POST /api/v1/tiktok/creator/get_video_to_product_stats
  1. 获取视频受众分析数据/Get Video Audience Analysis Data
  • POST /api/v1/tiktok/creator/get_video_audience_stats
  1. 获取作品的统计数据/Get video metrics
  • GET /api/v1/tiktok/analytics/fetch_video_metrics（必填: item_id）
  1. 检测视频虚假流量分析/Detect fake views in video
  • GET /api/v1/tiktok/analytics/detect_fake_views（必填: item_id）
  1. 获取视频评论关键词分析/Get comment keywords analysis
  • GET /api/v1/tiktok/analytics/fetch_comment_keywords（必填: item_id）
  1. 获取创作者信息和里程碑数据/Get creator info and milestones
  • GET /api/v1/tiktok/analytics/fetch_creator_info_and_milestones（必填: user_id）
  1. 获取热门音乐排行榜/Get popular sound rankings
  • GET /api/v1/tiktok/ads/get_sound_rank_list
  1. 获取广告关键帧分析/Get ad keyframe analysis
  • GET /api/v1/tiktok/ads/get_ad_keyframe_analysis（必填: material_id）
  1. 获取广告互动分析/Get ad interactive analysis
  • GET /api/v1/tiktok/ads/get_ad_interactive_analysis（必填: material_id）
  1. 获取创意模式排行榜/Get creative pattern rankings
  • GET /api/v1/tiktok/ads/get_creative_patterns
  1. 获取流行趋势视频/Get popular trend videos
  • GET /api/v1/tiktok/ads/get_popular_trends

搜索查询

  1. 获取每日趋势搜索关键词/Get daily trending search words
    • GET /api/v1/tiktok/web/fetch_trending_searchwords
  2. 获取综合搜索列表/Get general search list
    • GET /api/v1/tiktok/web/fetch_general_search（必填: keyword）
  3. 搜索关键字推荐/Search keyword suggest
    • GET /api/v1/tiktok/web/fetch_search_keyword_suggest（必填: keyword）
  4. 搜索用户/Search user
    • GET /api/v1/tiktok/web/fetch_search_user（必填: keyword）
  5. 搜索视频/Search video
    • GET /api/v1/tiktok/web/fetch_search_video（必填: keyword）
  6. 搜索直播/Search live
    • GET /api/v1/tiktok/web/fetch_search_live（必填: keyword）
  7. 搜索照片/Search photo
    • GET /api/v1/tiktok/web/fetch_search_photo（必填: keyword）
  8. 获取指定关键词的综合搜索结果/Get comprehensive search results of specified keywords
    • GET /api/v1/tiktok/app/v3/fetch_general_search_result（必填: keyword）
  9. 获取指定关键词的视频搜索结果/Get video search results of specified keywords
    • GET /api/v1/tiktok/app/v3/fetch_video_search_result（必填: keyword）
  10. 获取指定关键词的用户搜索结果/Get user search results of specified keywords
  • GET /api/v1/tiktok/app/v3/fetch_user_search_result（必填: keyword）
  1. 获取指定关键词的音乐搜索结果/Get music search results of specified keywords
  • GET /api/v1/tiktok/app/v3/fetch_music_search_result（必填: keyword）
  1. 获取指定关键词的话题搜索结果/Get hashtag search results of specified keywords
  • GET /api/v1/tiktok/app/v3/fetch_hashtag_search_result（必填: keyword）
  1. 获取指定关键词的直播搜索结果/Get live search results of specified keywords
  • GET /api/v1/tiktok/app/v3/fetch_live_search_result（必填: keyword）
  1. 获取地点搜索结果/Get location search results
  • GET /api/v1/tiktok/app/v3/fetch_location_search（必填: keyword）
  1. 创作者搜索洞察/Creator Search Insights
  • GET /api/v1/tiktok/app/v3/fetch_creator_search_insights
  1. 创作者搜索洞察详情/Creator Search Insights Detail
  • GET /api/v1/tiktok/app/v3/fetch_creator_search_insights_detail（必填: query_id_str）
  1. 创作者搜索洞察趋势/Creator Search Insights Trend
  • GET /api/v1/tiktok/app/v3/fetch_creator_search_insights_trend（必填: query_id_str）
  1. 创作者搜索洞察相关视频/Creator Search Insights Videos
  • GET /api/v1/tiktok/app/v3/fetch_creator_search_insights_videos（必填: keyword）
  1. 搜索粉丝列表/Search follower list
  • GET /api/v1/tiktok/app/v3/search_follower_list（必填: user_id, keyword）
  1. 搜索关注列表/Search following list
  • GET /api/v1/tiktok/app/v3/search_following_list（必填: user_id, keyword）
  1. 获取商品搜索结果/Get product search results
  • GET /api/v1/tiktok/app/v3/fetch_product_search（必填: keyword）
  1. 生成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）
  1. 搜索广告/Search ads
  • GET /api/v1/tiktok/ads/search_ads
  1. 获取查询建议/Get query suggestions
  • GET /api/v1/tiktok/ads/get_query_suggestions
  1. 搜索音乐提示/Search sound hints
  • GET /api/v1/tiktok/ads/search_sound_hint（必填: keyword）
  1. 搜索音乐/Search sounds
  • GET /api/v1/tiktok/ads/search_sound（必填: keyword）
  1. 搜索创作者/Search creators
  • GET /api/v1/tiktok/ads/search_creators（必填: keyword）
  1. 获取搜索关键词建议V1/Get search keyword suggestions V1
  • GET /api/v1/tiktok/shop/web/fetch_search_word_suggestion（必填: search_word）
  1. 获取搜索关键词建议V2(移动端)/Get search keyword suggestions V2 (Mobile)
  • GET /api/v1/tiktok/shop/web/fetch_search_word_suggestion_v2（必填: search_word）
  1. 搜索商品列表V1/Search products list V1
  • GET /api/v1/tiktok/shop/web/fetch_search_products_list（必填: search_word）
  1. 搜索商品列表V2(移动端)/Search products list V2 (Mobile)
  • GET /api/v1/tiktok/shop/web/fetch_search_products_list_v2（必填: search_word）
  1. 搜索商品列表V3/Search products list V3
  • GET /api/v1/tiktok/shop/web/fetch_search_products_list_v3（必填: keyword）

互动操作

  1. 获取用户的点赞列表/Get user likes
    • GET /api/v1/tiktok/web/fetch_user_like（必填: secUid）
  2. 获取用户的收藏列表/Get user favorites
    • GET /api/v1/tiktok/web/fetch_user_collect（必填: cookie, secUid）
  3. 获取作品的评论列表/Get video comments
    • GET /api/v1/tiktok/web/fetch_post_comment（必填: aweme_id）
  4. 获取作品的评论回复列表/Get video comment replies
    • GET /api/v1/tiktok/web/fetch_post_comment_reply（必填: item_id, comment_id）
  5. 获取用户的粉丝列表/Get user followers
    • GET /api/v1/tiktok/web/fetch_user_fans（必填: secUid）
  6. 获取用户的关注列表/Get user followings
    • GET /api/v1/tiktok/web/fetch_user_follow（必填: secUid）
  7. 获取用户喜欢作品数据/Get user like video data
    • GET /api/v1/tiktok/app/v3/fetch_user_like_videos（必填: sec_user_id）
  8. 获取单个视频评论数据/Get single video comments data
    • GET /api/v1/tiktok/app/v3/fetch_video_comments（必填: aweme_id）
  9. 获取指定视频的评论回复数据/Get comment replies data of specified video
    • GET /api/v1/tiktok/app/v3/fetch_video_comment_replies（必填: item_id, comment_id）
  10. 获取指定用户的粉丝列表数据/Get follower list of specified user
  • GET /api/v1/tiktok/app/v3/fetch_user_follower_list
  1. 获取指定用户的关注列表数据/Get following list of specified user
  • GET /api/v1/tiktok/app/v3/fetch_user_following_list
  1. 获取商品评论V1/Get product reviews V1
  • GET /api/v1/tiktok/shop/web/fetch_product_reviews_v1（必填: product_id）
  1. 获取商品评论V2/Get product reviews V2
  • GET /api/v1/tiktok/shop/web/fetch_product_reviews_v2（必填: product_id）
  1. 申请使用TikTok交互API权限（Scope）/Apply for TikTok Interaction API permission (Scope)
  • GET /api/v1/tiktok/interaction/apply（必填: api_key, invite_code）
  1. 发送评论/Post comment
  • POST /api/v1/tiktok/interaction/post_comment
  1. 回复评论/Reply to comment
  • POST /api/v1/tiktok/interaction/reply_comment
  1. 点赞/Like
  • POST /api/v1/tiktok/interaction/like
  1. 关注/Follow
  • POST /api/v1/tiktok/interaction/follow
  1. 收藏/Collect
  • POST /api/v1/tiktok/interaction/collect
  1. 转发/Forward
  • POST /api/v1/tiktok/interaction/forward

工具服务

  1. 生成哈希ID/Generate hashed ID
    • GET /api/v1/tiktok/web/generate_hashed_id（必填: email）
  2. 生成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）
  3. 生成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）
  4. 生成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）

内容解析

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

创作者/达人

  1. 获取带货创作者信息/Get shopping creator information
    • GET /api/v1/tiktok/app/v3/fetch_creator_info（必填: creator_uid）
  2. 获取创作者橱窗商品列表/Get creator showcase product list
    • GET /api/v1/tiktok/app/v3/fetch_creator_showcase_product_list（必填: kol_id）
  3. 获取创作者账号健康状态/Get Creator Account Health Status
    • POST /api/v1/tiktok/creator/get_account_health_status
  4. 获取创作者账号违规记录列表/Get Creator Account Violation Record List
    • POST /api/v1/tiktok/creator/get_account_violation_list
  5. 获取创作者账号概览/Get Creator Account Overview
    • POST /api/v1/tiktok/creator/get_account_insights_overview
  6. 获取创作者账号信息/Get Creator Account Info
    • POST /api/v1/tiktok/creator/get_creator_account_info
  7. 获取橱窗商品列表/Get Showcase Product List
    • POST /api/v1/tiktok/creator/get_showcase_product_list
  8. 获取视频关联商品列表/Get Video Associated Product List
    • POST /api/v1/tiktok/creator/get_video_associated_product_list
  9. 获取同款商品关联视频/Get Product Related Videos
    • POST /api/v1/tiktok/creator/get_product_related_videos
  10. 获取标签创作者信息/Get hashtag creator info
  • GET /api/v1/tiktok/ads/get_hashtag_creator（必填: hashtag）
  1. 获取创作者筛选器/Get creator filters
  • GET /api/v1/tiktok/ads/get_creator_filters
  1. 获取创作者列表/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次/分钟）
安全使用建议
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.
功能分析
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.
能力标签
requires-sensitive-credentials
能力评估
⚠ 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.
如何使用
  1. 确保已安装 OpenClaw（本地或 Docker 部署）
  2. 在对话框中输入安装命令：/install maxhub-tiktok
  3. 安装完成后，直接呼叫该 Skill 的名称或使用 /maxhub-tiktok 触发
  4. 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.0
maxhub-tiktok 1.0.0 - 首次发布，提供TikTok平台的数据采集、创作者分析及电商洞察能力。 - 支持194个API，涵盖数据采集、数据分析、搜索、互动、工具、内容解析等7大能力域。 - 所有API通过MaxHub中转站调用，仅需API Key认证，保障数据与环境安全。 - 智能调度API，支持链式调用与参数自动填充。 - 内置调用次数、翻页、批量等使用限制，防止超额消耗与安全隐患。 - 提供详细的API目录和使用指南，支持多样化的TikTok数据服务场景。
元数据
Slug maxhub-tiktok
版本 1.0.0
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 1
常见问题

maxhub-tiktok 是什么？

TikTok/TikTok平台TikTok数据采集、创作者分析与电商洞察。当用户提到tiktok、国际版抖音、海外短视频、creator、analytics等相关需求时激活此Skill。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 23 次。

如何安装 maxhub-tiktok？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install maxhub-tiktok」即可一键安装，无需额外配置。

maxhub-tiktok 是免费的吗？

是的，maxhub-tiktok 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。

maxhub-tiktok 支持哪些平台？

maxhub-tiktok 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 maxhub-tiktok？

由 Xie Hao（@xiewxx）开发并维护，当前版本 v1.0.0。

推荐 Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191115 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 留言讨论