Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add linkfox-ai/linkfox-skills --skill linkfox-echotik-list-product -a claude-code
Open on GitHub

What 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 case in US.
  • Search US for beauty products with at least 10% commission and show the main metrics.
  • Find recent gadget listings 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-code

2Manually: put the files in place

~/.claude/skills/linkfox-echotik-list-product/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/linkfox-echotik-list-product/

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

Similar skills

All skills for Data and databases →

From the same set74

The whole set →
linkfox-amazon-opportunity-report-by-keyword linkfox-amazon-opportunity-report-by-keyword — a skill for Claude Code generates market analysis reports for Amazon US search queries. Runs during product research to evaluate demand, buyer personas, and competitive pricing. CX Codex +1 243installs linkfox-amazon-opportunity-search-by-metrics linkfox-amazon-opportunity-search-by-metrics is a Claude Code skill that screens Amazon US niches by business metrics, including growth, competition, pricing, and buyer demographics. CX Codex +1 243installs linkfox-sellersprite-competitor-lookup linkfox-sellersprite-competitor-lookup — a skill for Claude Code and Codex finds and compares Amazon competitor products by ASIN, keyword, seller, brand, or category. It returns sales, BSR, prices, and trend data. CX Codex +1 241installs linkfox-seerfar-ozon-keyword-mining linkfox-seerfar-ozon-keyword-mining — a skill for Claude Code, Codex, and Cursor extracts Ozon and Wildberries search queries around a seed term via Seerfar. Discovers long-tail phrases and low-competition terms with metric filters. CX Codex +1 238installs linkfox-amazon-alexa-search The linkfox-amazon-alexa-search Claude Code skill asks Amazon’s Alexa shopping assistant for product recommendations and follow-up suggestions. It handles budget-based picks, comparisons, and questions tied to a specific page. CX Codex +1 237installs linkfox-shopee-store-product linkfox-shopee-store-product — a skill for Claude Code that handles catalog management for authorized Shopee stores. Adjusts SKU details, updates prices, tracks inventory levels, and pulls customer reviews. CX Codex +1 237installs linkfox-google-trend-get-trend-by-time linkfox-google-trend-get-trend-by-time — a skill for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode. Fetches rising Google Trends queries and relative search volume by region. CX Codex +1 237installs linkfox-ruiguan-text-trademark-detection linkfox-ruiguan-text-trademark-detection — a skill for Claude Code and Codex that screens product titles, descriptions, and keywords for text trademark matches. It checks target sales regions before a listing goes live. CX Codex +1 235installs

Project sponsors

Companies that keep this analytics open