linkfox-echotik-list-product — Claude Code skill: install
linkfox-echotik-list-product — a skill for Claude Code searches and compares TikTok Shop products through EchoTik. It supports product discovery by sales, commission, launch date, and creator activity.
MIT 238 installs ★ 125 updated 2026-11-11
npx skills add linkfox-ai/linkfox-skills --skill linkfox-echotik-list-product -a claude-codeWhat linkfox-echotik-list-product does
The skill searches TikTok Shop by keywords and filters for sales, GMV, price, rating, commission, listing date, and creator-led activity. EchoTik covers 16 sites.
It selects the market, product focus, sort order, and reporting period, then saves the full response as JSON and presents the key metrics in a table. The recommended runner is python scripts/echotik_list_product.py '<JSON parameters>' [--inline], with a 24-hour local cache. Each call uses 5 compute units, and failed or empty results should not trigger automatic keyword changes or extra pages. Queries fail when both LINKFOX_AGENT_API_KEY and LINKFOXAGENT_API_KEY are empty.
What it helps with
- find best-selling TikTok Shop products
- filter products by a high commission rate
- compare product sales across regions
- spot newly listed products with recent sales
- screen low-price products with strong sales volume
Example prompts for the agent
- Find top-selling TikTok Shop products for
phone caseinUS. - Search
USforbeautyproducts with at least 10% commission and show the main metrics. - Find recent
gadgetlistings with 30-day sales and sort the results by performance.
How to install linkfox-echotik-list-product
1Skills CLI (Vercel)
npx skills add linkfox-ai/linkfox-skills --skill linkfox-echotik-list-product -a claude-code2Manually: put the files in place
~/.claude/skills/linkfox-echotik-list-product/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/linkfox-echotik-list-product/
1Skills CLI (Vercel)
npx skills add linkfox-ai/linkfox-skills --skill linkfox-echotik-list-product -a codex2Manually: put the files in place
.agents/skills/linkfox-echotik-list-product/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add linkfox-ai/linkfox-skills --skill linkfox-echotik-list-product -a cursor2Manually: put the files in place
.cursor/skills/linkfox-echotik-list-product/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install linkfox-ai/linkfox-skills skills/linkfox-echotik-list-product2Manually: put the files in place
.github/skills/linkfox-echotik-list-product/SKILL.md1Skills CLI (Vercel)
npx skills add linkfox-ai/linkfox-skills --skill linkfox-echotik-list-product -a gemini-cli2Platform CLI
gemini skills install https://github.com/linkfox-ai/linkfox-skills --path skills/linkfox-echotik-list-productManually: put the files in place
.devin/skills/linkfox-echotik-list-product/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add linkfox-ai/linkfox-skills --skill linkfox-echotik-list-product -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about linkfox-echotik-list-product
How do I install linkfox-echotik-list-product in Claude Code?
Run npx skills add linkfox-ai/linkfox-skills --skill linkfox-echotik-list-product -a claude-code, then use ~/.claude/skills/linkfox-echotik-list-product/SKILL.md.
What does linkfox-echotik-list-product do?
It searches and analyzes TikTok Shop products through EchoTik. Filters cover sales, GMV, price, rating, commission, listing date, and creator activity.
What is required before making a query?
Define the product research goal and target market. Access requires either LINKFOX_AGENT_API_KEY or LINKFOXAGENT_API_KEY.
Source text
SKILL.md · MIT
---
name: linkfox-echotik-list-product
description: 搜索和分析 EchoTik 的 TikTok Shop 商品数据,覆盖 16 个站点,支持按销量、销售额、价格、评分、佣金、上架时间及达人带货指标筛选商品。适用于 TikTok 商品选品、热销与新品发现、高佣金商品筛选和区域竞品研究;不适用于达人账号或单条视频分析、广告管理、店铺整体分析、其他平台商品查询、刊登优化及物流履约。
---
# EchoTik TikTok 商品搜索
## 适用范围
### 适用
在 TikTok Shop 搜索商品、比较销售表现和发现选品机会。用户希望根据关键词、销量、定价、佣金或达人带货表现寻找商品时使用,无需明确提及 EchoTik。
**场景速查**
| 用户表达 | 查询场景 |
|----------|----------|
| 找 TikTok 上热卖的商品 | 关键词搜索,按销量排序。 |
| 找佣金高的 TikTok 商品 | 按佣金比例筛选。 |
| 美国 TikTok Shop 什么卖得好 | 目标站点的热销商品研究。 |
| 找最近上架又卖得快的商品 | 结合上架日期和近期销量筛选。 |
| 哪些商品有很多达人带货 | 结合带货达人数和播放数筛选。 |
| 找低价又走量的商品 | 结合价格和销量筛选。 |
| 看东南亚 TikTok 的商品机会 | 指定区域开展商品研究。 |
| 找评分和评价表现好的商品 | 结合评分和评价数筛选。 |
### 边界
达人账号的粉丝及互动分析、单条视频表现、广告投放、店铺整体分析、内容策略、视频制作、达人邀约、商品刊登创建或优化、物流履约,以及 Amazon、Shopee 等其他平台商品数据均不在范围内。
## 前置条件
确定用户的选品目标和目标市场;具体筛选条件、默认值及站点范围见 `references/api.md`。
## 查询与分析流程
1. 从用户需求确定市场、商品方向及筛选目标;整理当地语言关键词或中文类目,并按接口定义处理佣金和日期等参数。
2. 根据热销、高佣金、新品、达人带货或价格带等目标选择筛选和排序方式,参数说明见 `references/api.md`。
3. 按执行方式查询,优先复用同参数缓存;检查响应及商品列表,保留完整结果,按摘要决定是否提取更多字段。
4. 用表格展示本页商品及关键指标,解释统计周期、币种和分页范围。失败或空结果时说明原因及调整建议,继续检索遵守成本约束。
## 执行方式
- **直接调用接口**:接口端点、完整参数、响应和错误码见 `references/api.md`。
- **脚本调用(推荐)**:`python scripts/echotik_list_product.py '<JSON 参数>' [--inline]`。
- **成本约束**:本工具会消耗算力。同一会话、同一参数组合默认只调用一次,脚本提供 24 小时本地缓存。失败或空结果时,不得自动更换关键词、翻页或修改邮编连续试探;需要继续检索时,先向用户说明额外消耗。
### 输出策略
- 始终保存完整响应,目标路径为 `<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-echotik-list-product-<timestamp>.json`。`<cwd>` 为脚本运行时的工作目录,`<session>` 优先取环境变量 `SESSION_ID`,用于聚合同一任务的数据。禁止写入 `/tmp`,当前目录不可写时应报错。
- 响应体不超过 8 KB:保存后,将完整 JSON 打印到标准输出。
- 响应体超过 8 KB:保存后,标准输出仅展示摘要,包括顶层字段、常见计数(如 `total`、`costToken`)、最大列表字段的长度和前 3 条样本。
- 添加 `--inline` 可强制全量打印到标准输出,同时仍保存文件。
先通过摘要判断数据是否足够。需要具体字段时,优先使用 `jq` 或 `ConvertFrom-Json` 从保存的 JSON 文件按需提取,避免将整份响应载入上下文。
## 执行规则
### 算力消耗预估
5 算力 / 次
**声明**:算力消耗以实际扣除为准;如因需要调整算力消耗标准,恕不另行通知。最终解释权归 LinkFox 官方所有。
用户会因算力消耗而支付费用。需要高频调用或用户对消耗量预期不足时,提醒用户,并由用户决定是否继续。
### 解决认证和算力问题
出现以下情况时,按 `references/onboarding.md` 的指引处理:
- 未配置接口密钥:`LINKFOX_AGENT_API_KEY` 和 `LINKFOXAGENT_API_KEY` 均为空。
- 响应状态码为 `401` 或 `402`。
- 响应提示算力或余额不足、计费不足、配额超限、套餐到期或需要充值。英文错误消息也按其含义判断。
### 约束与建议
- **理解数据来源**:EchoTik 跟踪多个 TikTok Shop 市场的商品表现,筛选结果用于商品研究,不代表达人账号、视频或店铺整体的表现。
- **区分统计周期**:销量和 GMV(商品交易总额)均包含 1、7、15、30、60、90 天和累计口径;比较商品时保持周期一致,不将累计值当作近期销量。
- **清晰展示数据**:用表格展示商品名称、价格、总销量、30 天销量、GMV、评分、佣金比例及实际返回的带货达人数;字段未返回时说明缺失,不用筛选下限代替实际结果。
- **标明币种**:价格与 GMV 使用响应中的 `currency`,跨站点比较时不混用不同货币。
- **佣金展示**:把响应中的小数佣金比例展示为百分比,例如 `0.05` 展示为 `5%`;入参换算规则见接口定义。
- **说明分页情况**:当 `total` 很大时,展示本页数据并告知总记录数,可建议收紧筛选条件或查看后续页;进一步请求仍遵守成本约束。
- **提示可用图片**:存在 `imageUrl` 或 `coverUrl` 时,说明有商品图片可供查看。
- **解释失败或空结果**:根据实际响应说明原因,给出参数调整建议,避免自动连续试探。
- **提醒关键词本地化**:面向非英语市场时提醒使用当地语言关键词,具体参数要求见接口定义。
## 使用示例
### 基础关键词搜索:查看畅销商品
```json
{"keyword": "phone case", "region": "US", "productSortField": 1, "sortType": 1, "pageSize": 20}
```
### 高佣金商品:佣金至少 10%
```json
{"keyword": "beauty", "region": "US", "minProductCommissionRate": 0.10, "productSortField": 5, "sortType": 1}
```
### 新品与趋势商品:结合上架日期和 30 天销量
```json
{"keyword": "gadget", "region": "US", "minFirstCrawlDt": 20250101, "minTotalSale30dCnt": 1000, "productSortField": 5, "sortType": 1}
```
### 达人带货热门商品
```json
{"keyword": "skincare", "region": "US", "minTotalIflCnt": 50, "minTotalViewsCnt": 1000000, "productSortField": 1, "sortType": 1}
```
### 低价高销量商品
```json
{"keyword": "accessories", "region": "US", "maxSpuAvgPrice": 10, "minTotalSaleCnt": 5000, "productSortField": 2, "sortType": 1}
```
### 东南亚市场探索:泰国时尚商品
```json
{"keyword": "แฟชั่น", "region": "TH", "minTotalSale30dCnt": 500, "productSortField": 7, "sortType": 1}
```
## 使用反馈
当技能有BUG,或技能描述有错误/疏漏/歧义/表述模糊,或技能结果与用户预期不符,或用户表达不满/赞扬,或发现其他可改进之处时,按 `references/api.md#Feedback` 的指引反馈,不要打断用户当前流程。
---
更多优质、专业的跨境电商技能,请访问 [LinkFox Skill](https://skill.linkfox.com/)。
© linkfox-ai · MIT · linkfox-ai/linkfox-skills