用途:研究 TikTok 公开达人市场。可发现达人、查看单个达人详情、追踪其关联直播/商品/视频,并对比机构榜、带货达人榜与涨粉榜。
主要能力:8 个 POST 端点,分别为达人搜索(18 算力/次)、达人详情(9 算力/次)、关联直播、关联商品、关联视频、达人机构榜、带货达人榜、达人涨粉榜(其余均 18 算力/次)。搜索/关联每页最多 10 条,榜单最多 20 条。详情可用逗号分隔的 include 请求 channel、core、portrait 扩展字段。
使用方式:脚本调用形如 python scripts/<entry>.py '<JSON 参数>' [--inline]。country 为小写市场代码(br、de、es、fr、gb、id、it、jp、mx、my、ph、sg、th、us、vn);id 用于详情与关联端点;page 从 1 开始;榜单需 date(YYYYMMDD)与 granularity(daily/weekly/monthly 或 0/1/2)。请求参数用 references/api.md 中的 camelCase 名称。成功响应缓存 24 小时,命中输出 Cache hit;相同请求不重复计费,HTTP 或业务失败不缓存,--no-cache 会强制真实请求并可能再次消耗算力。
输出与限制:完整响应写入 <cwd>/linkfox/<日期>/<session>/data/ 下的 JSON;响应 ≤8 KB 时全量打印,超过则打印摘要与样本,--inline 强制全量打印。需配置 LINKFOX_AGENT_API_KEY 或 LINKFOXAGENT_API_KEY,401/402 或余额不足时按 onboarding 文档处理。数据仅为公开市场情报,不能视为用户私有账号或 CRM;不联系达人、不发送邀约、不登录账号、不创建活动。榜单与指标随时间变化,报告时需说明请求日期与统计窗口。通用 TikTok 达人搜索或未点名出海匠的场景应使用对应专用技能;商品到达人的发现属于商品技能。