SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场linkfox-echotik-list-new-product-rank

linkfox-echotik-list-new-product-rank

营销与增长

查看项目

更新于 10-15 12:51

技能介绍

用途

本技能用于通过 EchoTik 数据源查询和分析 TikTok Shop 新品排行榜数据，帮助跨境电商卖家发现 TikTok 各区域市场的热门新品，适用于短视频电商选品、趋势分析和竞争情报。

数据范围

TikTok 新品排行榜追踪近期上架并在 TikTok Shop 上获得关注的新品，揭示哪些新品销售良好及其定价、销量、达人覆盖和直播活动等情况。排行榜覆盖 16 个 TikTok Shop 市场，提供新品的每日快照及其表现指标。

支持的市场及代码：

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

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

参数说明

  • date（字符串，必填）：查询日期，格式为 YYYY-MM-DD
  • region（字符串，可选）：市场区域代码，默认 US
  • pageNum（整数，可选）：页码，从 1 开始（默认 1）
  • pageSize（整数，可选）：每页商品数量（默认 50）

结果分页返回，需使用 pageNum 和 pageSize 浏览完整结果集。

调用方式

  • API 端点：POST /echotik/listNewProductRank（完整参数、响应和错误码见 references/api.md）
  • Python 脚本：python scripts/echotik_list_new_product_rank.py '<JSON 参数>' [--inline]

成本约束：本工具会消耗算力；同一会话同一参数组合默认只调用一次，脚本带 24 小时本地缓存。失败或空结果不得自动换关键词、翻页或改参数连续试探；需要继续检索时先向用户说明会产生额外消耗。

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

  • 始终将完整响应写入 <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. 分页浏览大量结果：检索美国市场第二页共 20 条结果。例：date: "2025-06-15", region: "US", pageNum: 2, pageSize: 20

响应数据字段

  • 商品标题：title
  • 商品 ID：asin
  • 区域：region
  • 均价（SPU）：price
  • 最低价：minPrice
  • 最高价：maxPrice
  • 货币：currency
  • 总销量：totalSaleCnt
  • 近 30 天销量：totalSale30dCnt
  • 总营收（GMV）：totalSaleGmvAmt
  • 近 30 天营收：totalSaleGmv30dAmt
  • 销售趋势：salesTrendFlagText（0 = 稳定，1 = 上升，2 = 下降）
  • 关联视频数：totalVideoCnt
  • 关联直播数：totalLiveCnt
  • 带货达人数：totalIflCnt
  • 商品佣金率：productCommissionRate
  • 商品评分：productRating
  • 评论数：reviewCount
  • 首次追踪日期：availableDate
  • 分类 ID：categoryId
  • 图片 URL：imageUrl
  • 图片 URL 列表：productImageUrls

展示规则

  • 仅呈现数据：以清晰表格展示查询结果，不提供主观商业建议
  • 销售趋势说明：展示销售趋势数据时，将数字标志转换为可读标签：0 = 稳定，1 = 上升，2 = 下降
  • 货币提示：始终将价格与货币代码一并展示，因为不同市场使用不同货币
  • 数量较多提示：结果较多时展示头部商品摘要，并提醒用户可翻页查看更多结果
  • 图片处理：如有商品图片 URL 可提及，但除非环境支持，不尝试内联渲染图片
  • 错误处理：查询失败时说明原因，并建议调整日期或区域参数

重要限制

  • 日期必填：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 算力。用户会因算力消耗而支付费用。当需要高频调用本技能，或用户对算力消耗量预期不足时，务必提醒用户，由用户决定是否继续。