linkfox-echotik-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 用法

此工具调用 LinkFox 工具网关 API。有关调用约定、请求参数和响应结构，请参阅 references/api.md。你也可以直接运行 scripts/echotik_list_new_product_rank.py 来执行查询。

使用示例

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 UK 上卖得好？”	特定区域排名
“TikTok 选品”“短视频电商趋势”	通用选品发现
“给我看看 TikTok 上正在崛起的新品”	按趋势筛选排名
“TikTok 达人选品”“TikTok 创作者在推广什么？”	达人驱动的选品发现

不适用场景 -- 需求超出 TikTok 新品排名范围：

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

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

反馈：

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

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

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

处理大型响应

为避免 Agent 上下文溢出，请将响应保存到磁盘，并仅提取所需字段：

python scripts/response_io.py run --script scripts/echotik_list_new_product_rank.py --out-dir <DIR> '<params>'
python scripts/response_io.py read <file> --fields "<paths>"   # or --path "<JMESPath>"

将 --out-dir 设在任何 git 工作树之外（例如，Unix 上的 /tmp/...，Windows 上的 %TEMP%/...）。保存的响应可能包含个人身份信息、价格或身份验证敏感数据——请勿提交这些文件。文件不会自动删除；任务完成后请清理。

run 会将完整响应写入文件，并仅输出架构预览和文件路径。read 会筛选指定字段，并支持使用 --limit/--offset 进行切片，以及使用 --format json|jsonl|csv|table 指定输出格式。

优先采用此模式的情况 — 请根据响应特征自行判断，例如：

• 每条记录的字段很多，或包含不需要的字段
• 批量 / 分页结果（每次调用返回多个条目）
• 长文本字段（描述、评论、HTML、时间序列）
• 输出会在后续步骤中重复使用，而非立即消费

对于小型、仅使用一次的响应，直接调用主脚本即可。

⚠️ 预览是截断后的架构和样例，并非完整数据。任何字段级判断都必须通过 read 从已保存的文件中读取。

---

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