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
npx skills add linkfox-ai/linkfox-skills --skill linkfox-echotik-batch-product-detail -a claude-codeWhat 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-code2Manually: put the files in place
~/.claude/skills/linkfox-echotik-batch-product-detail/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/linkfox-echotik-batch-product-detail/
1Skills CLI (Vercel)
npx skills add linkfox-ai/linkfox-skills --skill linkfox-echotik-batch-product-detail -a codex2Manually: put the files in place
.agents/skills/linkfox-echotik-batch-product-detail/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add linkfox-ai/linkfox-skills --skill linkfox-echotik-batch-product-detail -a cursor2Manually: put the files in place
.cursor/skills/linkfox-echotik-batch-product-detail/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install linkfox-ai/linkfox-skills skills/linkfox-echotik-batch-product-detail2Manually: put the files in place
.github/skills/linkfox-echotik-batch-product-detail/SKILL.md1Skills CLI (Vercel)
npx skills add linkfox-ai/linkfox-skills --skill linkfox-echotik-batch-product-detail -a gemini-cli2Platform CLI
gemini skills install https://github.com/linkfox-ai/linkfox-skills --path skills/linkfox-echotik-batch-product-detailManually: put the files in place
.devin/skills/linkfox-echotik-batch-product-detail/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add linkfox-ai/linkfox-skills --skill linkfox-echotik-batch-product-detail -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-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