用途
本技能用于查询单个 TikTok Shop 店铺（卖家）的完整档案。给定一个 sellerId，即可获取该店铺的详细经营数据，帮助跨境卖家与营销人员对单个店铺做深度分析。
主要能力
返回单个店铺的完整详情对象，包含以下字段类别：
- 基础信息：sellerId（店铺 ID）、sellerName（店铺名称）、sellerLink（店铺链接）、coverUrl（店铺封面图 URL）、region（市场代码）、shopIdentityLabel（店铺身份标签，如 OFFICIAL SHOP）、shopTypeText（品牌店标识，是/否）、fromFlagText（本土/跨境标识）、sourceType（来源类型，如 Tiktok）、sourceTool（来源工具）、userId（达人 UID）。
- 销量与 GMV：totalSaleCnt（总销量）；totalSale1dCnt / 7dCnt / 30dCnt / 90dCnt（1天/7天/30天/90天增量销量）；totalSaleGmvAmt（总 GMV）；totalSaleGmv1dAmt / 7dAmt / 30dAmt / 90dAmt（1天/7天/30天/90天增量 GMV）。
- 店铺健康指标：followersCount（粉丝数）、rating（店铺评分）、reviewCount（评价数）、positiveFeedbackRate（好评率）、responseRate（回复率）、deliveryRate（送达率）。
- 商品与价格：totalProductCnt（历史商品数，含已下架）、totalCrawlProductCnt（当前在店商品数）、spuAvgPrice（店铺平均 SKU 价格）、minPrice / maxPrice（最低/最高价格）、productCategoryList（商品分类，JSON 字符串）、mostProductCategoryList（TOP1 商品分类，JSON 字符串）。
- 带货触达：totalIflCnt（带货达人数）、totalVideoCnt（带货视频数）、totalLiveCnt（直播数）。
- 趋势与渠道：salesFlagText（主要销售渠道：视频带货/直播带货）、salesTrendFlagText（销售趋势：上升/下降/平稳）。
- 分类 ID：categoryId / categoryL2Id / categoryL3Id（一/二/三级分类 ID）。
- 上架时间：firstCrawlDt（预估上架时间，YYYYMMDD 整数格式，如 20240504）。
- 其他：errcode、errmsg、costToken（消耗算力）、columns（渲染列定义）、type（渲染样式，如 tableListWorkbenches）。
使用方式
sellerId 为必填参数，类型 string，默认无，最大长度 1000。sellerId 需从 EchoTik TikTok Shop 店铺搜索技能（linkfox-echotik-list-seller）获取，或来自已知的店铺链接/ID。该搜索技能可按地区、品类、GMV、趋势、店铺类型列出并筛选 TikTok Shop 店铺。
调用途径：
API 端点：POST /echotik/sellerDetail（完整参数/响应/错误码见 references/api.md）
Python 脚本：python scripts/echotik_seller_detail.py '<JSON 参数>' [--inline]
示例调用：
{ "sellerId": "7495514739648989419" }
也可先用店铺搜索列出美国 GMV 前列店铺，再查看其中某店铺（如 sellerId 7495514739648989419）的完整详情。
输出策略（脚本默认行为）：
- 始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-echotik-seller-detail-<timestamp>.json（<cwd> 为脚本执行时的工作目录；<session> 取自环境变量 SESSION_ID；禁止写入 /tmp，当前目录不可写则报错）。
- 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout。
- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如 total/costToken、最大列表字段的长度 + 前 3 条样本）。
- 加 --inline 强制全量打印到 stdout（同样落盘）。
读数据建议：先看摘要判断是否足够；需要具体字段时优先用 jq 或 ConvertFrom-Json 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。
认证与算力
未配置 API Key（环境变量 LINKFOX_AGENT_API_KEY 或 LINKFOXAGENT_API_KEY 未设置）、响应 401 或 402 状态码、或提示算力/余额不足（含“算力余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值”或类似含义）时，采用 references/onboarding.md 引导解决问题。
适用场景
- 用户提到“TikTok店铺详情”“TikTok store detail”时，按 sellerId 获取单个店铺完整档案。
- “查看这个TikTok店铺的数据”，对通过搜索找到的店铺做深度分析。
- “分析某家 TikTok 店”，进行单店铺表现分析。
- “这个 TikTok 店铺的 GMV 和粉丝数”，获取店铺级销售/GMV/粉丝指标。
边界判断：当用户说出“分析这家店铺”或“查看店铺详情”且已给出店铺（sellerId 或店铺链接）时，适用本技能。若用户想按条件发现或列出店铺，应改用店铺搜索技能。
限制
- sellerId 为必填，需从 EchoTik TikTok Shop 店铺搜索技能（linkfox-echotik-list-seller）或已知的店铺链接/ID 获取。
- 仅返回单个店铺详情；列出和筛选店铺需使用店铺搜索技能。
- firstCrawlDt 使用 YYYYMMDD 整数格式。
- categoryId / categoryL2Id / categoryL3Id 为内部 ID，非人类可读名称。
- 返回结果为实时查询，非数据库存储，不提供二次 SQL/数据处理。
- 不适用于：按地区/GMV/趋势列出或筛选 TikTok Shop 店铺（用店铺搜索）；TikTok 商品搜索或商品排行；TikTok 达人/网红分析；TikTok 视频表现分析；Amazon、Shopee 等非 TikTok 平台数据；店铺级运营（订单/物流/广告管理）。
- 本工具会消耗算力：消耗 5 算力，用户会因算力消耗而支付费用。当需要高频调用本技能，或用户对算力消耗量预期不足时，务必提醒用户，由用户决定是否继续。同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。
展示规则
- 呈现清晰的店铺档案：显示店铺名称、地区、店铺链接、封面图和身份标签（如 OFFICIAL SHOP）。
- 销量与 GMV 粒度：显示总销量和总 GMV；呈现多周期（1天/7天/30天/90天）销量与 GMV 拆分，以便用户看到走势。
- 店铺健康指标：一并显示粉丝数、评分、评价数、好评率、回复率和送达率。
- 店铺属性：显示 fromFlagText（本土/跨境）、salesFlagText（视频/直播带货）、salesTrendFlagText（趋势）、shopTypeText（品牌店）以便对标。
- 触达指标：呈现 totalIflCnt（达人数）、totalVideoCnt（视频数）、totalLiveCnt（直播数）和商品数。
- 店铺链接：存在 sellerLink 时呈现，方便用户打开店铺。
- 不做二次处理：结果为实时查询，非数据库存储，不提供二次 SQL/数据处理。
反馈
当出现以下情况时，通过 Feedback API 自动检测并上报反馈：本技能描述的功能或目的与实际行为不符；技能结果与用户意图不符；用户对本技能表达不满或赞赏；任何你认为可改进之处。按 references/api.md 中的说明调用反馈 API，不要打断用户流程。