用途:研究 TikTok Shop 公开商品市场,包括发现商品、查看单个商品、追溯其关联达人/直播/视频/评论、浏览三类榜单,以及按图找同款。
主要能力与端点(均通过 LinkFox 网关 POST 调用):商品搜索 /chuhaijiang/products/search、商品详情 /chuhaijiang/products/detail、关联达人 /chuhaijiang/products/related-creators、关联直播 /chuhaijiang/products/related-lives、商品评论 /chuhaijiang/products/reviews、关联视频 /chuhaijiang/products/related-videos、热推榜 /rankings/most-promoted、新品榜 /rankings/new-arrivals、销量榜 /rankings/top-selling、图片搜索 /chuhaijiang/products/image-search、上传预签名 /chuhaijiang/upload/presigned-url。
使用方式:Python 脚本调用格式为 python scripts/<entry>.py '<JSON 参数>' [--inline]。country 使用小写市场代码(如 us、gb、jp),图片搜索用大写两位代码,默认 US。id 为详情和关联端点必填,可复用搜索或榜单结果中的商品 ID。搜索与关联端点每页最多 10 条,榜单每页最多 20 条。榜单需 date(YYYYMMDD)与 granularity(daily/weekly/monthly、0、1、2)。本地图片需先用 python scripts/upload_image.py /path/to/product.jpg 上传获取 osKey,再调用图片搜索;已有 osKey 可跳过上传。
成本与缓存:上传预签名 0 算力/次,商品详情 9 算力/次,搜索、关联达人/直播/评论/视频及榜单 18 算力/次,图片搜索 30 算力/次。10 个商品业务脚本仅缓存成功响应 24 小时,命中输出 Cache hit;--no-cache 强制真实请求并可能再次消耗算力,仅在用户明确同意或调试时使用。只调用当前问题所需端点,未请求的付费钻取调用需先询问。
输出:完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-chuhaijiang-tiktok-product-<timestamp>.json,≤8 KB 全量打印,>8 KB 打印摘要,--inline 强制全量打印。
限制:数据为实时公开市场情报,并非用户 TikTok Shop 账户私有数据;不管理订单、库存、刊登、履约、联盟邀约或广告投放;不支持下载视频、生成或编辑图片;搜索与榜单随时间变化,需随结果报告请求日期/窗口;图片搜索必须使用已上传的有效对象键,不能直接传本地路径;不得泄露 API Key、签名上传 URL 或原始图片字节。未提及的收费、价格或平台细节暂未提供。