用途：研究 TikTok Shop 公开店铺市场，包括店铺发现与筛选、单店铺详情、店铺关联达人/商品/视频钻取，以及热推榜、销量榜。属于公开市场情报，不是卖家中心私有数据。
主要能力与端点：店铺搜索 /chuhaijiang/sellers/search；店铺详情 /chuhaijiang/sellers/detail；关联达人 /chuhaijiang/sellers/related-creators；关联商品 /chuhaijiang/sellers/related-products；关联视频 /chuhaijiang/sellers/related-videos；热推榜 /chuhaijiang/sellers/rankings/most-promoted；销量榜 /chuhaijiang/sellers/rankings/top-selling。均通过 POST 调用，对应 scripts 目录下同名 Python 脚本。
参数要点：country 必填，使用小写市场代码（br,de,es,fr,gb,id,it,jp,mx,my,ph,sg,th,us,vn）。详情与关系端点需传 id，以字符串发送。搜索与关系端点单页最多 10 条，榜单支持 1–20。搜索支持 keyword、category、sellerType、评分/7日销量/7日GMV区间与排序。详情支持 include=core、include=channel（可组合）。榜单需 date(YYYYMMDD) 与 granularity(daily/weekly/monthly 或 0/1/2)，可选 shopType(1,2,3,4)。参数名使用 references/api.md 中的 camelCase，勿传 snake_case 别名。
用法示例：python scripts/chuhaijiang_seller_search.py '{"country":"us","keyword":"beauty","minRating":4,"page":1,"pageSize":3,"sort":"gmv_7d:desc"}'。详情、关联、榜单脚本参数结构类似。
计费与缓存：店铺详情 9 算力/次，其余六个端点 18 算力/次。成功响应本地缓存 24 小时（按工作目录、调用身份、网关、端点与完整参数隔离），命中输出 Cache hit。--no-cache 强制真实请求并可能重复扣费，仅在用户明确同意或调试时使用。
输出：完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/…json；≤8KB 全量打印，>8KB 只输出摘要，--inline 强制全量打印。建议用 jq 从落盘文件按需抽取。Windows 控制台需设 PYTHONIOENCODING=utf-8 以免 emoji 乱码。
认证：需配置 LINKFOX_AGENT_API_KEY 或 LINKFOXAGENT_API_KEY；401/402 或算力不足时按 references/onboarding.md 处理。
限制：不管理订单、库存、刊登、履约、联盟、广告或店铺授权；部分字段可能缺失或为 null，金额字段通常为 {unit,value}，需保留单位与时间窗口；搜索与榜单随时间变化，应报告请求日期与榜单窗口；sellerType 属搜索、shopType 属榜单，不可混用。缺失信息以实际响应为准。