Skip to main content
skill CX Codex

linkfox-echotik-batch-product-detail — Claude Code skill

linkfox-echotik-batch-product-detail — a skill for Claude Code and Codex that pulls EchoTik analytics for batches of TikTok Shop items. Compares revenue, sales volumes, listing status, and livestream performance.

MIT 231 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-batch-product-detail -a claude-code
Open on GitHub

What linkfox-echotik-batch-product-detail does

Runs across Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode. It processes batches of productIds, TikTok Shop URLs, or mixed inputs by invoking scripts/echotik_batch_product_detail.py. The resulting table breaks down USD pricing, lifetime and 30-day sales, estimated GMV, creator counts, commission rates, and live broadcast statistics.

Every run deducts 5 computing credits, which makes the built-in 24-hour local file cache essential for identical query parameters. Output files save directly into <cwd>/linkfox/, and payloads larger than 8 KB print only sample summaries to standard output.

Requests fail immediately with 401 or 402 status codes unless LINKFOX_AGENT_API_KEY or LINKFOXAGENT_API_KEY is present in the environment.

What it helps with

  • compare GMV and sales volume across competing TikTok Shop items
  • identify delisted or fully managed products in candidate lists
  • pull live stream sales figures and creator counts for product URLs

Example prompts for the agent

  • Fetch product metrics for TikTok IDs 1729382310407603945 and 1729382310407603946
  • Pull sales trends and commission rates for https://shop.tiktok.com/us/pdp/phone-case/1729382310407603945
  • Check live broadcast performance and inventory status for these product links

How to install linkfox-echotik-batch-product-detail

1Skills CLI (Vercel)

npx skills add linkfox-ai/linkfox-skills --skill linkfox-echotik-batch-product-detail -a claude-code

2Manually: put the files in place

~/.claude/skills/linkfox-echotik-batch-product-detail/SKILL.md

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

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about linkfox-echotik-batch-product-detail

How to install linkfox-echotik-batch-product-detail in Claude Code?

Run npx skills add linkfox-ai/linkfox-skills --skill linkfox-echotik-batch-product-detail -a claude-code. The file is saved at ~/.claude/skills/linkfox-echotik-batch-product-detail/SKILL.md.

What does linkfox-echotik-batch-product-detail do?

It queries EchoTik endpoints to fetch batch analytics for TikTok Shop listings using product IDs or store URLs.

What credentials does the tool require?

You must configure LINKFOX_AGENT_API_KEY or LINKFOXAGENT_API_KEY with available credit balance before running queries.

Source text

SKILL.md · MIT
---
name: linkfox-echotik-batch-product-detail
description: 根据已知商品 ID 或 TikTok Shop 商品链接批量查询 EchoTik 商品详情,支持多周期销量与 GMV、直播、视频、达人、播放量、价格、评分、评论、佣金和上下架及全托管状态分析。适用于 TikTok 商品对比、销售趋势和带货表现研究,无需明确提及 EchoTik。不适用于关键词找品、新品榜单、商品带货视频列表、视频下载、达人档案或其他平台商品研究。
---

# EchoTik TikTok 商品批量详情

## 适用范围

### 适用

根据已知商品 ID 或商品链接获取销售与营销详情,帮助卖家并排比较候选商品。

**场景速查**

| 用户表达 | 查询场景 |
|----------|----------|
| 查询这批 TikTok 商品的详情 | 按商品 ID 批量查询。 |
| 拉取这些 TikTok 链接的销售数据 | 按商品链接批量查询。 |
| 对比这些商品的 GMV | 展示销售额及相关统计周期。 |
| 哪些商品正在增长 | 展示趋势及近期、累计指标。 |
| 有没有已下架或全托管商品 | 展示商品状态,区分对比对象。 |
| 看这些商品的直播带货表现 | 展示直播数量、直播销量和直播销售额。 |

### 边界

“分析这些 TikTok 商品”需先判断用户是否已有明确商品 ID 或商品链接;“TikTok 卖什么”“找热门产品”等发现需求不属于详情查询。
关键词找品使用 `linkfox-echotik-product-search`,新品榜单使用 `linkfox-echotik-new-product-rank`,商品带货视频列表使用 `linkfox-echotik-product-video`,视频下载链接使用 `linkfox-echotik-get-video-download-url`。达人档案及其他平台商品研究不在本技能范围。

## 前置条件

**先确定待查询商品**:取得用户提供的商品 ID 或 TikTok Shop 商品链接,明确希望比较的指标和统计周期。输入格式与批量限制见 `references/api.md`。

## 查询流程

1. 核对商品列表与研究目标,按 `references/api.md` 组织商品 ID、商品链接或混合输入。
2. 检查同一会话、同一参数是否已有结果,优先复用已有数据和本地缓存。
3. 执行批量详情查询,先读取摘要,再按需从完整响应提取指标。
4. 按用户目标展示对比表、统计周期和状态;逐项列出未返回数据的商品 ID 或链接,便于核对。
5. 查询失败时依据 `errmsg` 或 `error` 解释原因,建议核对商品 ID 或链接;后续查询遵守成本约束。

## 执行方式

- **直接调用接口**:接口端点、完整参数、响应和错误码见 `references/api.md`。
- **脚本调用(推荐)**:`python scripts/echotik_batch_product_detail.py '<JSON 参数>' [--inline]`。
- **成本约束**:本工具每次调用消耗 5 算力。同一会话、同一参数组合默认只调用一次,脚本提供 24 小时本地缓存。失败或空结果时,不得自动更换关键词、翻页或修改邮编连续试探;需要继续检索时,先向用户说明额外消耗。

### 输出策略

- 始终保存完整响应,目标路径为 `<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-echotik-batch-product-detail-<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`。
- 响应提示算力或余额不足、计费不足、配额超限、套餐到期或需要充值。英文错误消息也按其含义判断。

### 约束与建议

- **清晰展示数据**:每个商品一行,默认展示名称、价格、累计销量、近 30 天销量、累计 GMV、评分、评论数、佣金比例及带货达人数;直播研究补充直播销量与直播 GMV。
- **说明统计周期**:销量、GMV、直播、视频、达人和观看指标提供多周期信息,比较增长时同时展示用户关心的近期窗口与累计值;具体字段见 `references/api.md`,不补造缺失的周期或累计数据。
- **标明币种与数据性质**:价格标注 USD;销量、GMV 和归因数据属于分析估算,不能表述为平台精确值。
- **展示佣金与趋势**:佣金比例显示为百分比,例如 `0.05` 显示为 `5%`;销售趋势显示为“稳定”“上升”“下降”,编码见接口定义。
- **展示状态徽章**:按返回值标注全托管、已下架和免运费,避免将已下架商品当作正常在售商品比较。
- **控制展示长度**:存在 `imageUrl` 或 `productImageUrls` 时告知有图片可查看;`descDetail` 可能包含较长 HTML 或文本,应概括或说明可用,不整段输出。
- **解释缺失数据**:请求商品未返回记录时逐项列出原商品 ID 或链接,不把无数据等同于销量为零。
- **按需读取保存文件**:`scripts/response_io.py read` 可从完整响应文件提取字段;选项、依赖与缓存约定见 `references/api.md`。

## 使用示例

### 按商品 ID 批量查询

```json
{"productIds": ["1729382310407603945", "1729382310407603946"]}
```

### 按商品链接批量查询

```json
{"productUrls": ["https://shop.tiktok.com/us/pdp/phone-case/1729382310407603945", "https://shop.tiktok.com/us/pdp/case-for-phone/1729382310407603946"]}
```

### 混合商品 ID 与链接

```json
{"productIds": ["1729382310407603945"], "productUrls": ["https://shop.tiktok.com/us/pdp/phone-case/1729382310407603946"]}
```

## 使用反馈

当技能有BUG,或技能描述有错误/疏漏/歧义/表述模糊,或技能结果与用户预期不符,或用户表达不满/赞扬,或发现其他可改进之处时,按 `references/api.md#Feedback` 的指引反馈,不要打断用户当前流程。

---

更多优质、专业的跨境电商技能,请访问 [LinkFox Skill](https://skill.linkfox.com/)。

© linkfox-ai · MIT · linkfox-ai/linkfox-skills

Similar skills

All skills for Marketing and content →

From the same set74

The whole set →
linkfox-sorftime-amazon-product-query linkfox-sorftime-amazon-product-query — a skill for Claude Code, Codex, and Cursor that queries Amazon products across 14 marketplaces using Sorftime metrics. Discovers items by category, brand, and historical snapshots. CX Codex +1 231installs linkfox-jiimore-get-niche-info-by-keyword linkfox-jiimore-get-niche-info-by-keyword — a skill for Claude Code and Codex analyzes Amazon product niches by search keyword. It inspects customer demand, sales volume, brand concentration, and ad costs. CX Codex +1 231installs linkfox-shopee-store-logistics linkfox-shopee-store-logistics — a skill for Claude Code, Codex, and Cursor. Fulfills Shopee store shipments, generates shipping labels, and queries tracking numbers. CX Codex +1 231installs linkfox-shopee-store-livestream The linkfox-shopee-store-livestream skill for Claude Code and Codex manages Shopee store livestreams. It handles session setup, product lists, comments, and stream metrics. CX Codex +1 231installs linkfox-fastmoss-product-rank-top-selling linkfox-fastmoss-product-rank-top-selling — a skill for Claude Code ranks popular TikTok Shop products by market, period, category, or sales metric. It handles daily, weekly, and monthly product reports. CX Codex +1 231installs linkfox-zhihuiya-abstract-data-translated linkfox-zhihuiya-abstract-data-translated — a skill for Claude Code and Codex that fetches Chinese, English, or Japanese patent title and abstract translations from PatSnap. Accepts single or batch patent IDs and publication numbers. CX Codex +1 231installs linkfox-ruiguan-trademark-graphic-detection linkfox-ruiguan-trademark-graphic-detection — a skill for Claude Code detects graphic trademarks and logos in product photos, then searches for similar registered marks. It runs during pre-listing image risk checks. CX Codex +1 230installs linkfox-zhihuiya-pdf-data The linkfox-zhihuiya-pdf-data Claude Code skill finds full patent PDF links from an ID or publication number. It handles single and batch lookups, with a related-family document as a fallback. CX Codex +1 230installs

Project sponsors

Companies that keep this analytics open