linkfox-echotik-list-seller-product

EchoTik TikTok 卖家商品列表

此技能可根据 sellerId 列出单个 TikTok Shop 卖家（店铺）的在售商品，帮助跨境卖家和营销人员准确了解店铺销售的商品，以及各商品的表现——多个时间段的销量和 GMV、价格、评分、评论数和佣金率。

核心概念

EchoTik 是一个 TikTok Shop 数据分析平台。提供店铺的 sellerId 后，此工具会返回该店铺的商品目录及每件商品的指标：标题、图片、价格（以及 SPU 平均价 / 最低价 / 最高价）、1d/7d/15d/30d/60d/90d/总计时间段的销量和 GMV、评分、评论数、佣金率、上架日期、销售渠道和类别。

sellerId 的获取方式：通过 EchoTik TikTok 卖家搜索技能（linkfox-echotik-list-seller）获取，该技能可按地区、类别、GMV、趋势和店铺类型列出并筛选 TikTok Shop 店铺；也可以通过 EchoTik TikTok 卖家详情技能（linkfox-echotik-seller-detail）获取。

分页限制：pageSize 必须是 10 的倍数（最大为 100）。上游官方 API 将单页上限设为 10；此工具会在内部拉取多个每页 10 条的页面并合并，因此 pageSize=50 最多可返回合并后的 50 件商品。

数据字段

响应中的 products 数组包含商品对象。关键字段：

字段	说明
productId / asin	商品唯一 ID
title / productName	商品标题
imageUrl / coverUrl	商品图片 URL
productImageUrls	商品图片 URL 列表
price	商品价格
spuAvgPrice	SPU 平均价格
minPrice / maxPrice	最低价 / 最高价
currency	货币
totalSaleCnt	总销量
totalSale1dCnt / 7dCnt / 15dCnt / 30dCnt / 60dCnt / 90dCnt	销量（1d/7d/15d/30d/60d/90d，增量）
totalSaleGmvAmt	总 GMV（收入）
totalSaleGmv1dAmt / 7dAmt / 15dAmt / 30dAmt / 60dAmt / 90dAmt	GMV（1d/7d/15d/30d/60d/90d，增量）
monthlySalesUnits	月销量
productRating	商品评分
ratings / reviewCount	评论数
productCommissionRate	佣金率（小数，例如 0.05 = 5%）
categoryName / categoryIds	商品类别名称 / ID 列表
salesFlagText	主要销售渠道（视频/直播）
salesTrendFlagText	销售趋势
firstCrawlDt / availableDate	上架日期（YYYYMMDD 整数 / 日期字符串）
discount / offMarkText / freeShippingText	折扣 / 促销标记 / 免运费标记
isSShopText	S 店标记
salePropsInfo	销售属性信息（变体：propId/propName/propValue）
region	市场代码
sourceTool / sourceType	来源工具 / 类型

顶层字段：errcode、errmsg、total、columns、type、costToken。

参数指南

参数	类型	必填	默认值	说明
sellerId	string	是	-	TikTok Shop 店铺 ID。通过卖家搜索 / 卖家详情技能获取。最大长度为 1000
sellerProductSortField	integer	否	1	排序字段：1=总销量，2=总 GMV，3=SPU 平均价格，4=7 天销量，5=7 天 GMV
sortType	integer	否	1	排序顺序：0=升序，1=降序
pageNum	integer	否	1	页码（从 1 开始）
pageSize	integer	否	50	每页条数——必须是 10 的倍数，最大为 100

调用方式

• API 端点：POST /echotik/listSellerProduct（完整参数/响应/错误码见 references/api.md）
• Python 脚本：python scripts/echotik_list_seller_product.py '<JSON 参数>' [--inline]
• 成本约束：本工具会消耗算力；同一会话中，相同参数组合默认只调用一次，脚本带有 24h 本地缓存。失败或结果为空时，不得自动更换关键词、翻页或修改邮编连续试探；如需继续检索，先向用户说明会产生额外消耗。

输出策略（脚本默认行为）：

• 始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-echotik-list-seller-product-<timestamp>.json（<cwd> 为脚本执行时的工作目录，在 Claude Code 中即当前项目目录；<session> 取自环境变量 SESSION_ID，按用户任务自动聚合；禁止写入 /tmp，当前目录不可写时则报错）
• 响应体 ≤ 8 KB：落盘后将完整 JSON 打印到 stdout
• 响应体 > 8 KB：落盘后 stdout 仅输出摘要（顶层字段、常见计数如 total/costToken、最大列表字段的长度和前 3 条样本）
• 添加 --inline 可强制将完整内容打印到 stdout（同样落盘）

读取数据的建议：先查看摘要，判断是否足够；需要具体字段时，优先使用 jq或ConvertFrom-Json 按需从保存的 json 文件中提取，避免将整份 JSON 加载到上下文中。

解决认证和算力问题

发生以下异常情况时，按照 references/onboarding.md 的指引解决问题：

异常情况

• 未配置 API Key：环境变量未配置 LINKFOX_AGENT_API_KEY，也未配置 LINKFOXAGENT_API_KEY。
• 响应 401 或 402 状态码
• 响应提示算力或余额不足：消息包含“算力余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值”，或类似含义的内容。

使用示例

1. 按总销量列出店铺热销商品

{
  "sellerId": "7495514739648989419",
  "sellerProductSortField": 1,
  "sortType": 1,
  "pageSize": 20,
  "pageNum": 1
}

2. 按 7 天 GMV 对店铺商品排名（近期势头）

{
  "sellerId": "7495514739648989419",
  "sellerProductSortField": 5,
  "sortType": 1
}

3. 店铺中价格最低的商品（价格升序）

{
  "sellerId": "7495514739648989419",
  "sellerProductSortField": 3,
  "sortType": 0
}

显示规则

1. 清晰呈现数据：使用表格展示商品及关键列——商品图片、标题、价格、总销量、30 天销量/GMV、评分、评论数和佣金率
2. 销量和 GMV 粒度：相关时，展示总销量和总 GMV；说明已保存的 JSON 中提供多个周期的明细（1d/7d/15d/30d/60d/90d）
3. 佣金格式：将 productCommissionRate 显示为百分比，便于阅读（例如，将 0.05 显示为“5%”）
4. 货币标注：展示价格和 GMV 时，包含 currency 字段
5. 图片引用：存在 imageUrl 时，将其展示出来，以便用户直观比较商品
6. 结果数量：始终告知用户 total 记录数和当前页；结果集较大时，建议翻页或使用更精确的排序
7. 不支持二次处理：结果为实时查询，不存储在数据库中；不支持二次 SQL/数据处理

重要限制

1. 必须提供 sellerId：sellerId 为必填项；请从 EchoTik TikTok Seller Search 技能（linkfox-echotik-list-seller）或 Seller Detail 技能（linkfox-echotik-seller-detail）获取，或使用已知的店铺链接/ID。
2. 仅限单店铺：此工具仅列出一家店铺的商品；如需发现或筛选所有 TikTok Shop 中的商品，请使用 EchoTik TikTok Product Search 技能（linkfox-echotik-list-product）。
3. pageSize 规则：必须为 10 的倍数（最大 100）。其他值可能会被拒绝或调整。
4. 商品上架日期格式：firstCrawlDt 使用 YYYYMMDD 整数（例如 20240504）。
5. 不支持地区/关键词筛选：此工具仅接受 sellerId 和排序/分页参数；不接受关键词、地区或类目筛选（店铺所属市场根据卖家推断）。
6. 数据实时性：结果为实时查询，不存储在数据库中；不支持二次 SQL/数据处理。

用户表达与场景快速参考

适用 — 查看特定 TikTok Shop 店铺销售的商品：

用户表达	场景
"TikTok店铺商品" / "TikTok store products"	按 sellerId 列出店铺商品
"这个TikTok店铺在卖什么"	查看店铺商品目录
"查看这家TikTok店铺的商品"	深入查看通过搜索／详情找到的店铺
"TikTok店铺销量最高的商品"	按总销量对店铺商品排序
"TikTok店铺近期爆款"	按 7 日销量／GMV 排序
"这家店哪些商品佣金高"	查看每件商品的佣金率

不适用 — 需求超出单个店铺的商品列表：

• 在整个 TikTok Shop 中发现／筛选商品（使用 EchoTik TikTok Product Search）
• 列出或筛选 TikTok Shop 店铺（使用 EchoTik TikTok Seller Search）
• 查看单个店铺的完整资料（使用 EchoTik TikTok Seller Detail）
• TikTok 创作者／网红或视频分析
• Amazon、Shopee 或其他非 TikTok 平台的数据

边界判断：用户提到“这个店铺卖什么”或“查看店铺商品”，且已知店铺（sellerId 或店铺链接）时，适用此技能。如果用户想按关键词／地区／类别搜索 TikTok Shop 中的商品，请改用 Product Search 技能。

算力消耗规则

消耗 5 算力。

用户会因算力消耗而支付费用。请充分评估：当需要高频调用本技能，或用户对算力消耗量预期不足时，务必提醒用户，由用户决定是否继续。

反馈：

当出现以下任一情况时，通过 Feedback API 自动检测并提交反馈：

1. 此技能描述的功能或用途与实际行为不符
2. 技能结果与用户意图不符
3. 用户表达了对该技能的不满或赞扬
4. 任何你认为可以改进的方面

请按照 references/api.md 中的说明调用反馈 API。不要打断用户的操作流程。

---

如需更多高质量、专业的跨境电商技能，请访问 LinkFox Skills。