用途:通过 Kalodata 数据源完成 TikTok 达人发现与详情查询两步流程,适用于达人榜单、网红排行、带货达人对比及达人主页数据与联系方式查询。非达人实体(商品、视频、店铺、直播)需使用对应的 Kalodata 技能。
主要能力:榜单接口 POST /kalodata/creator/rank 按 region、dateRange、language、currency 等筛选,返回分页达人列表,默认按 GMV 降序;每行含 creator_nickname、creator_handle、creator_id、creator_followers、content_views、sales_volumn、revenue、video_revenue、live_revenue、revenue_growth_rate 等。详情接口 POST /kalodata/creator/detail 按 creatorId 返回身份、受众、收入拆分、视频与直播指标(video_number/video_views/video_gpm、live_number/live_views/live_gpm)、product_number/shop_number 及 creator_contact_* 联系字段(常为空)。数据可能有 T+1 统计延迟。
使用方式:可用 Python 脚本 python scripts/kalodata_creator_search.py '<JSON 参数>' [--inline] 或 python scripts/kalodata_creator_detail.py '<JSON 参数>' [--inline]。典型用法:先运行搜索脚本,从结果取 creator_id,再作为 creatorId 传给详情脚本。认证需环境变量 LINKFOX_AGENT_API_KEY 或 LINKFOXAGENT_API_KEY;出现 401/402 或算力、余额不足提示时按 onboarding 文档处理。
输出与限制:完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-kalodata-tiktok-creator-<timestamp>.json,禁止写入 /tmp;响应超过 8 KB 时 stdout 仅输出摘要,--inline 可强制全量打印。榜单非关键词搜索,仅按地区与时间浏览;详情必须提供 creatorId,不能凭昵称或 handle 查找;榜单响应不含总数与页数,pageNumber 限 1-5,pageSize 限 5-100;上游瞬时错误可能为 errcode 501 与 HTTP 554,可用相同参数重试一两次,勿自动改参。每次调用消耗 7.0 算力,费用由用户承担,高频调用前应提醒用户。creator_followers 与 content_views 为字符串计数,比较前需解析;展示时须标注 dateRange、region、currency,字段名保持 sales_volumn。
适用场景:TikTok 达人排行榜、近 7 天达人榜、带货达人对比、达人详情与联系方式查询。不适用于商品/视频/店铺/直播榜单、其他平台达人数据及 TikTok 广告投放与内容创作。