linkfox-echotik-list-new-product-rank

EchoTik - TikTok 新品榜

本技能将指导你如何通过 EchoTik 数据源查询和分析 TikTok Shop 新品榜数据，帮助跨境电商卖家发现 TikTok 各区域市场的热门新品。

核心概念

TikTok 新品榜追踪近期上架且在 TikTok Shop 上逐渐走红的商品。榜单展示哪些新品销量良好，以及它们的定价、销量、达人覆盖范围和直播活动情况。这是短视频电商领域开展选品、趋势分析和竞品情报研究的重要工具。

数据范围：榜单涵盖 16 个 TikTok Shop 市场，并提供新品的每日快照及其表现指标（销量、收入、达人数量、视频数量、直播数量、佣金率、评分等）。

分页：结果采用分页形式。使用 pageNum（页码，从 1 开始）和 pageSize（每页条数，默认 50）浏览结果集。

参数指南

参数	类型	必填	说明
date	string	是	查询日期，格式为 YYYY-MM-DD
region	string	否	市场区域代码。默认值：US。请参阅下方的支持市场
pageNum	integer	否	页码，从 1 开始（默认值：1）
pageSize	integer	否	每页商品数量（默认值：50）

支持的市场

代码	市场
US	美国
GB	英国
ID	印度尼西亚
TH	泰国
PH	菲律宾
MY	马来西亚
VN	越南
MX	墨西哥
SG	新加坡
SA	沙特阿拉伯
BR	巴西
ES	西班牙
JP	日本
DE	德国
IT	意大利
FR	法国

默认市场为 US。用户未指定市场时使用 US。

调用方式

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

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

• 始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-echotik-list-new-product-rank-<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. 美国今日热门新品 查询当前日期的美国市场，了解哪些新品正在走红。

date: "2025-06-15", region: "US"

2. 发掘东南亚热门新品 查看印度尼西亚或泰国市场的新品机会。

date: "2025-06-15", region: "ID"

3. 浏览英国市场新品榜 在英国 TikTok Shop 上寻找热门新品。

date: "2025-06-15", region: "GB"

4. 浏览大型结果集的分页内容 获取美国市场的第 2 页结果，共 20 条。

date: "2025-06-15", region: "US", pageNum: 2, pageSize: 20

数据字段（响应）

字段	API 名称	描述
商品标题	title	商品名称
商品 ID	asin	唯一商品标识符
地区	region	市场地区代码
价格（平均）	price	SPU 平均价格
最低价格	minPrice	最低价格
最高价格	maxPrice	最高价格
货币	currency	货币代码
总销量	totalSaleCnt	售出商品总数
30 天销量	totalSale30dCnt	最近 30 天售出的商品数量
总收入	totalSaleGmvAmt	商品交易总额
30 天收入	totalSaleGmv30dAmt	最近 30 天的收入
销量趋势	salesTrendFlagText	销量趋势指标（0 = 稳定，1 = 上升，2 = 下降）
视频总数	totalVideoCnt	关联视频数量
直播总数	totalLiveCnt	关联直播数量
达人总数	totalIflCnt	推广该商品的达人数量
佣金率	productCommissionRate	商品佣金率
评分	productRating	商品平均评分
评论数	reviewCount	商品评论数量
首次发现日期	availableDate	首次追踪该商品的日期
类别 ID	categoryId	商品类别标识符
图片 URL	imageUrl	商品图片 URL
图片 URL 列表	productImageUrls	商品图片 URL 列表

显示规则

1. 仅呈现数据：以清晰的表格展示查询结果，不提供主观的商业建议
2. 说明销量趋势：展示销量趋势数据时，将数字标记转换为易读标签：0 = 稳定，1 = 上升，2 = 下降
3. 注意货币：价格旁始终显示其货币代码，因为不同市场使用不同的货币
4. 数据量提示：结果较多时，展示排名靠前商品的摘要，并提醒用户可以分页查看更多结果
5. 图片处理：如果有商品图片 URL，请提及，但除非环境支持，否则不要尝试内嵌显示图片
6. 错误处理：查询失败时，说明原因并建议调整日期或地区参数

重要限制

• 必须提供日期：date 参数为必填项；没有默认日期
• 每日粒度：数据是每日快照，而非每周或每月数据
• 分页：使用 pageNum 和 pageSize 浏览大量结果；单次调用不会返回所有商品

用户表达与场景速查

适用 -- TikTok Shop 新品发现与趋势分析：

用户说法	场景
“TikTok 上有哪些新品正在走红？”	新品榜单查询
“TikTok 今日畅销商品”“TikTok Shop 热门商品”	每日榜单查询
“东南亚 TikTok 新品机会”	区域市场调研
“TikTok 英国站哪些新品卖得好？”	特定地区榜单
“TikTok 商品调研”“短视频电商趋势”	一般商品发现
“展示 TikTok 上销量上升的新品”	按趋势筛选榜单
“TikTok 达人选品”“TikTok 创作者在推广什么？”	达人驱动的商品发现

不适用 -- 需求超出 TikTok 新品榜单范围：

• Amazon 商品调研或 ABA 关键词数据
• TikTok 广告或广告活动管理
• TikTok 内容创作或视频编辑
• 商品评论或商品详情文案撰写
• 跨多个月的历史趋势分析（此工具提供每日快照）
• 利润率计算或定价策略

边界判断：用户提到“商品调研”或“什么商品卖得好”时，如果上下文明确涉及 TikTok Shop 或短视频电商，则适用此技能。如果用户询问的是 Amazon、Shopify 或其他平台，则不适用。

算力消耗规则

消耗 5 算力。

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

反馈：

在以下任一情况发生时，通过 Feedback API 自动检测并报告反馈：

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

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

---

如需获取更多高品质、专业的跨境电商技能，请设置 LinkFox Skills。