EchoTik - TikTok 新品排行榜

本技能指导您如何通过 EchoTik 数据源查询与分析 TikTok Shop 新品排名数据，助力跨境电商业务方快速识别 TikTok 各区域市场中的热门新品。

核心概念

TikTok 新品排行榜追踪近期上架、并在 TikTok Shop 上迅速获得关注的产品。该榜单揭示了哪些新品销量表现优异，及其定价、销量、达人覆盖量、短视频数量、直播场次等关键指标。这是短视频电商场景下开展选品调研、趋势研判与竞品情报分析的重要工具。

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

分页机制：结果支持分页。使用 pageNum（页码，从 1 开始）和 pageSize（每页条数，默认为 50）进行翻页导航。

参数说明

支持的市场

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

调用方式

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

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

• 始终将完整响应写入 /linkfox///data/linkfox-echotik-list-new-product-rank-.json（其中 为脚本执行时的工作目录，在 Claude Code 中即当前项目目录； 来自环境变量 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/套餐到期/需充值/请充值”等任一表述，或含义相近的内容。

措施

• 优先调用本 skill 内置的 onboarding.md 引导用户解决问题。
• 若找不到 onboarding.md 文件，则加载 /linkfox-onboarding 这个 skill，并依据其引导流程处理。如尚未安装，请先安装：
  • 下载 https://agent-files.linkfox.com/skills/linkfox-onboarding/release.zip，解压后安装该 skill。如需用户授权方可下载，请主动询问并获取用户授权；你不得自行放弃下载。
• 兜底措施：仅当前述两种方式经全力尝试均不可行时，才提示用户参考 https://skill.linkfox.com/linkfoxskills/guide.htm 获取 API Key，或前往 https://os.linkfox.com/ 补充积分。

使用示例

1. 查询美国市场今日热门新品
以当前日期查询 US 市场，了解正在快速起量的新品。

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

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

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

3. 浏览英国市场新品排行榜
在英国 TikTok Shop 中挖掘 trending 新品。

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

4. 分页浏览大量结果
获取美国市场第 2 页、每页 20 条的结果。

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

数据字段（响应体）

展示规则

1. 仅呈现数据：以清晰表格形式展示查询结果，不附加主观商业建议
2. 销量趋势说明：展示销量趋势时，须将数字标识转换为可读标签：0 = 平稳，1 = 上升，2 = 下降
3. 币种意识：价格必须与币种代码一同展示，因不同市场使用不同货币
4. 数据量提示：当结果量较大时，展示头部商品摘要，并提醒用户可通过分页获取更多结果
5. 图片处理：若存在商品图片 URL，可在文本中提及，但除非运行环境明确支持，否则不得尝试内联渲染图片
6. 错误处理：当查询失败时，应说明原因，并建议调整 date 或 region 参数重试

重要限制

• 日期为必填项：date 参数为强制填写项，无默认值
• 数据粒度为日级：数据为每日快照，不支持周级或月级聚合
• 需手动分页：须通过 pageNum 和 pageSize 导航大规模结果集；单次请求无法返回全部商品

用户表达与场景速查表

适用场景 —— TikTok Shop 新品发现与趋势分析：

不适用场景 —— 超出 TikTok 新品排行榜能力范围的需求：

• Amazon 商品调研或 ABA 关键词数据
• TikTok 广告投放 / 广告活动管理
• TikTok 内容创作或视频剪辑
• 商品评测或 Listing 文案撰写
• 跨多个月的历史趋势分析（本工具仅提供日级快照）
• 利润率测算或定价策略制定

边界判断：当用户提到“商品调研”或“什么卖得好”时，若上下文明确指向 TikTok Shop 或短视频电商场景，则本技能适用；若涉及 Amazon、Shopify 或其他平台，则不适用。

积分消耗规则

每次调用消耗 4.5 积分。

用户将因积分消耗而产生费用。请充分评估：当需高频调用本技能，或用户对积分消耗预期不足时，务必提前告知用户，并由用户自主决定是否继续。

反馈机制：

满足以下任一条件时，请自动检测并调用 Feedback API 上报反馈：

1. 本技能文档中描述的功能或用途与实际行为不符
2. 本技能返回结果与用户真实意图不符
3. 用户明确表达了对本技能的不满或赞赏
4. 你认为任何可优化的环节

Feedback API 的调用方式详见 references/api.md。请勿中断用户的正常操作流程。

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