linkfox-echotik-list-product

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

EchoTik TikTok Product Search

EchoTik TikTok 商品搜索

This skill guides you on how to search and analyze TikTok Shop product data, helping sellers and marketers discover product opportunities, evaluate sales performance, and identify influencer-driven products on TikTok.

本技能将指导您如何搜索和分析TikTok Shop商品数据，帮助卖家和营销人员发掘产品机会、评估销售表现，并找出TikTok上由达人带火的产品。

Core Concepts

核心概念

EchoTik is a TikTok Shop analytics platform that tracks product performance across multiple TikTok marketplaces. This tool provides keyword-based product search with rich filtering capabilities, returning detailed product data including sales volumes (1d/7d/15d/30d/60d/90d/total), GMV (revenue), pricing, ratings, review counts, commission rates, and influencer promotion statistics.

Sales metrics: Products include multi-period sales data — 1-day, 7-day, 15-day, 30-day, 60-day, 90-day, and total sales. The same granularity applies to GMV (Gross Merchandise Value) amounts.

Commission rate: Stored as a decimal (e.g., 0.05 means 5%). When a user specifies a percentage, convert it to decimal before passing to the API.

Listing date: The

firstCrawlDt

field uses a compact integer format

YYYYMMDD

(e.g.,

20240101

for January 1, 2024).

EchoTik是一款TikTok Shop数据分析平台，可追踪多个TikTok站点的商品表现。该工具支持基于关键词的商品搜索，并具备丰富的筛选功能，返回的详细商品数据包括销量（1天/7天/15天/30天/60天/90天/累计）、GMV（销售额）、定价、评分、评论数、佣金比例以及达人推广统计数据。

销量指标：商品包含多周期销量数据——1天、7天、15天、30天、60天、90天及累计销量。GMV（商品交易总额）数据也采用相同的时间粒度。

佣金比例：以小数形式存储（例如，0.05代表5%）。当用户指定百分比时，需先转换为小数再传入API。

上架日期：

firstCrawlDt

字段采用紧凑整数格式

YYYYMMDD

（例如，

20240101

代表2024年1月1日）。

Parameter Guide

参数指南

Search & Filtering

搜索与筛选

Parameter	Type	Description	Default
keyword	string	Product keyword (translate to the local language of the target marketplace)	-
region	string	Marketplace code	US
categoryKeywordCN	string	Product category (must be in Chinese)	-

参数	类型	描述	默认值
keyword	string	商品关键词（需转换为目标站点的本地语言）	-
region	string	站点代码	US
categoryKeywordCN	string	商品分类（必须为中文）	-

Sales Filters

销量筛选

Parameter	Type	Description
minTotalSaleCnt / maxTotalSaleCnt	integer	Total sales volume range
minTotalSale30dCnt / maxTotalSale30dCnt	integer	30-day sales volume range
minTotalSaleGmvAmt / maxTotalSaleGmvAmt	string	Total GMV range
minTotalSaleGmv30dAmt / maxTotalSaleGmv30dAmt	string	30-day GMV range

参数	类型	描述
minTotalSaleCnt / maxTotalSaleCnt	integer	累计销量范围
minTotalSale30dCnt / maxTotalSale30dCnt	integer	30天销量范围
minTotalSaleGmvAmt / maxTotalSaleGmvAmt	string	累计GMV范围
minTotalSaleGmv30dAmt / maxTotalSaleGmv30dAmt	string	30天GMV范围

Product Attribute Filters

商品属性筛选

Parameter	Type	Description
minSpuAvgPrice / maxSpuAvgPrice	number	SPU average price range
minProductRating / maxProductRating	number	Product rating range
minReviewCount / maxReviewCount	integer	Review count range
minProductCommissionRate / maxProductCommissionRate	number	Commission rate range (decimal, e.g., 0.05 = 5%)

参数	类型	描述
minSpuAvgPrice / maxSpuAvgPrice	number	SPU平均价格范围
minProductRating / maxProductRating	number	商品评分范围
minReviewCount / maxReviewCount	integer	评论数范围
minProductCommissionRate / maxProductCommissionRate	number	佣金比例范围（小数形式，例如0.05=5%）

Influencer & Video Filters

达人与视频筛选

Parameter	Type	Description
minTotalIflCnt / maxTotalIflCnt	integer	Number of influencers promoting the product
minTotalVideoCnt / maxTotalVideoCnt	integer	Number of promotion videos
minTotalViewsCnt / maxTotalViewsCnt	integer	Total views on promotion videos

参数	类型	描述
minTotalIflCnt / maxTotalIflCnt	integer	推广该商品的达人数量范围
minTotalVideoCnt / maxTotalVideoCnt	integer	推广视频数量范围
minTotalViewsCnt / maxTotalViewsCnt	integer	推广视频总播放量范围

Listing Date & Duration

上架日期与时长

Parameter	Type	Description
minFirstCrawlDt / maxFirstCrawlDt	integer	Listing date range (YYYYMMDD format, e.g., 20240101)
saleDays	integer	Days since listing

参数	类型	描述
minFirstCrawlDt / maxFirstCrawlDt	integer	上架日期范围（YYYYMMDD格式，例如20240101）
saleDays	integer	上架天数

Sorting & Pagination

排序与分页

Parameter	Type	Description	Default
productSortField	integer	Sort field: 1=total sales, 2=total GMV, 3=avg price, 4=7d sales, 5=30d sales, 6=7d GMV, 7=30d GMV	1
sortType	integer	Sort order: 0=ascending, 1=descending	1
pageNum	integer	Page number	1
pageSize	integer	Results per page	50

参数	类型	描述	默认值
productSortField	integer	排序字段：1=累计销量，2=累计GMV，3=平均价格，4=7天销量，5=30天销量，6=7天GMV，7=30天GMV	1
sortType	integer	排序顺序：0=升序，1=降序	1
pageNum	integer	页码	1
pageSize	integer	每页结果数	50

Supported Marketplaces

支持的站点

US (United States), ID (Indonesia), TH (Thailand), PH (Philippines), MY (Malaysia), VN (Vietnam), GB (United Kingdom), MX (Mexico), SG (Singapore), SA (Saudi Arabia), BR (Brazil), ES (Spain), JP (Japan), DE (Germany), IT (Italy), FR (France)

Default marketplace is US. Use US when the user doesn't specify a marketplace.

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

默认站点为US。当用户未指定站点时，使用US站点。

调用方式

API 端点：
```
POST /echotik/listProduct
```
（完整参数/响应/错误码见
```
references/api.md
```
）

Python 脚本：

python scripts/echotik_list_product.py '<JSON 参数>' [--inline]

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

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

始终将完整响应写入
```
<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-echotik-list-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 进入上下文。

API 端点：
```
POST /echotik/listProduct
```
（完整参数/响应/错误码见
```
references/api.md
```
）

Python 脚本：

python scripts/echotik_list_product.py '<JSON 参数>' [--inline]

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

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

始终将完整响应写入
```
<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-echotik-list-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 引导解决问题：

发生以下异常情况时，采用references/onboarding.md引导解决问题：

异常情况

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

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

Usage Examples

使用示例

1. Basic Keyword Search — Find top-selling products for a keyword

json

{
  "keyword": "phone case",
  "region": "US",
  "productSortField": 1,
  "sortType": 1,
  "pageSize": 20
}

2. High-Commission Product Discovery — Products with commission >= 10%

json

{
  "keyword": "beauty",
  "region": "US",
  "minProductCommissionRate": 0.10,
  "productSortField": 5,
  "sortType": 1
}

3. New & Trending Products — Recently listed with strong 30-day sales

json

{
  "keyword": "gadget",
  "region": "US",
  "minFirstCrawlDt": 20250101,
  "minTotalSale30dCnt": 1000,
  "productSortField": 5,
  "sortType": 1
}

4. Influencer-Hot Products — Products promoted by many influencers

json

{
  "keyword": "skincare",
  "region": "US",
  "minTotalIflCnt": 50,
  "minTotalViewsCnt": 1000000,
  "productSortField": 1,
  "sortType": 1
}

5. Budget-Friendly High-Sellers — Low price + high volume

json

{
  "keyword": "accessories",
  "region": "US",
  "maxSpuAvgPrice": 10,
  "minTotalSaleCnt": 5000,
  "productSortField": 2,
  "sortType": 1
}

6. Southeast Asia Market Exploration

json

{
  "keyword": "fashion",
  "region": "TH",
  "minTotalSale30dCnt": 500,
  "productSortField": 7,
  "sortType": 1
}

1. 基础关键词搜索——查找关键词对应的热销商品

json

{
  "keyword": "phone case",
  "region": "US",
  "productSortField": 1,
  "sortType": 1,
  "pageSize": 20
}

2. 高佣金商品发掘——佣金≥10%的商品

json

{
  "keyword": "beauty",
  "region": "US",
  "minProductCommissionRate": 0.10,
  "productSortField": 5,
  "sortType": 1
}

3. 新品爆款——近期上架且30天销量表现强劲的商品

json

{
  "keyword": "gadget",
  "region": "US",
  "minFirstCrawlDt": 20250101,
  "minTotalSale30dCnt": 1000,
  "productSortField": 5,
  "sortType": 1
}

4. 达人热门商品——众多达人推广的商品

json

{
  "keyword": "skincare",
  "region": "US",
  "minTotalIflCnt": 50,
  "minTotalViewsCnt": 1000000,
  "productSortField": 1,
  "sortType": 1
}

5. 高性价比热销品——低价+高销量

json

{
  "keyword": "accessories",
  "region": "US",
  "maxSpuAvgPrice": 10,
  "minTotalSaleCnt": 5000,
  "productSortField": 2,
  "sortType": 1
}

6. 东南亚市场探索

json

{
  "keyword": "fashion",
  "region": "TH",
  "minTotalSale30dCnt": 500,
  "productSortField": 7,
  "sortType": 1
}

Display Rules

展示规则

Present data clearly: Show query results in organized tables with key columns — product name, price, total sales, 30-day sales, GMV, rating, commission rate, and number of promoting influencers
Currency awareness: Include the currency field from the response when displaying prices and GMV
Commission formatting: Display commission rates as percentages for readability (e.g., show 0.05 as "5%")
Volume notice: When results have a large
```
total
```
count, show the current page data and inform the user of total available records; suggest adjusting filters or pagination to explore more
Image reference: If
```
imageUrl
```
or
```
coverUrl
```
is present, mention it so the user knows product images are available
Error handling: When a query fails, explain the reason based on the response and suggest adjusting parameters
Keyword translation reminder: When the user targets a non-English marketplace, remind them that the keyword should be in the local language of that marketplace for best results

清晰呈现数据：将查询结果整理为结构化表格，包含核心列——商品名称、价格、累计销量、30天销量、GMV、评分、佣金比例以及推广达人数量
货币标识：展示价格和GMV时，需包含响应中的货币字段
佣金格式：将佣金比例以百分比形式展示以提升可读性（例如，将0.05显示为“5%”）
数量提示：当结果的
```
total
```
计数较大时，展示当前页数据并告知用户总可用记录数；建议用户调整筛选条件或分页以探索更多内容
图片参考：若存在
```
imageUrl
```
或
```
coverUrl
```
字段，需告知用户可查看商品图片
错误处理：查询失败时，根据响应信息说明原因，并建议调整参数
关键词翻译提醒：当用户针对非英语站点时，提醒用户关键词需使用该站点的本地语言以获得最佳结果

Applicable Scenarios

适用场景

User Says	Scenario
"Find trending products on TikTok"	Keyword search sorted by sales
"TikTok products with high commission"	Filter by commission rate
"What's selling well on TikTok Shop US"	Regional product search by sales
"New products blowing up on TikTok"	Filter by listing date + sales
"Which products have many influencers promoting them"	Filter by influencer count
"Cheap but high-volume TikTok products"	Filter by price + sales
"TikTok product research for Southeast Asia"	Search specific SE Asian regions
"Products with good reviews on TikTok"	Filter by rating + review count

用户表述	场景
"在TikTok上查找热门商品"	按销量排序的关键词搜索
"TikTok上高佣金的商品"	按佣金比例筛选
"TikTok Shop美国站哪些商品卖得好"	按销量进行区域商品搜索
"TikTok上爆红的新品"	按上架日期+销量筛选
"哪些商品有很多达人推广"	按达人数量筛选
"TikTok上便宜但销量高的商品"	按价格+销量筛选
"东南亚TikTok商品调研"	搜索特定东南亚区域
"TikTok上好评多的商品"	按评分+评论数筛选

Not Applicable Scenarios

不适用场景

TikTok influencer/creator analytics (follower counts, engagement rates of creators)
TikTok video performance analytics (views, likes, shares on specific videos)
TikTok advertising / ad campaign management
Amazon, Shopee, or other non-TikTok platform product data
TikTok Shop store-level analytics
Product listing creation or optimization advice
Logistics, fulfillment, or shipping analysis

Boundary judgment: When users say "product research" or "what should I sell on TikTok", if it involves searching and filtering products by sales data, pricing, or commission rates on TikTok Shop, then this skill applies. If they're asking about content strategy, video creation, or influencer outreach, it does not apply.

TikTok达人/创作者分析（粉丝数、创作者互动率）
TikTok视频表现分析（特定视频的播放量、点赞数、分享数）
TikTok广告/广告活动管理
Amazon、Shopee或其他非TikTok平台的商品数据
TikTok Shop店铺级分析
商品上架创建或优化建议
物流、履约或配送分析

边界判断：当用户提及“商品调研”或“我应该在TikTok上卖什么”时，若需求涉及在TikTok Shop上按销量数据、定价或佣金比例搜索和筛选商品，则适用本技能。若用户询问内容策略、视频创作或达人合作，则不适用。

积分消耗规则

消耗 5 积分。

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

Feedback:

Auto-detect and report feedback via the Feedback API when any of the following apply:

The functionality or purpose described in this skill does not match actual behavior
The skill's results do not match the user's intent
The user expresses dissatisfaction or praise about this skill
Anything you believe could be improved

Call the feedback API as specified in

references/api.md

. Do not interrupt the user's flow.

For more high-quality, professional cross-border e-commerce skills, set LinkFox Skills.

消耗 5 积分。

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

反馈机制：

当出现以下任意情况时，自动通过Feedback API检测并上报反馈：

本技能描述的功能或用途与实际行为不符
技能结果与用户意图不符
用户表达对本技能的不满或赞扬
任何您认为可以改进的内容

请按照

references/api.md

中的说明调用反馈API，请勿打断用户的操作流程。

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