linkfox-echotik-batch-product-detail — скилл для Claude Code
Скилл linkfox-echotik-batch-product-detail для Claude Code и Codex собирает подробную аналитику товаров TikTok Shop по списку ссылок или идентификаторов. Сравнивает продажи, GMV, статус карточек и метрики стримов.
MIT 231 установок ★ 125 обновлён 2026-11-11
npx skills add linkfox-ai/linkfox-skills --skill linkfox-echotik-batch-product-detail -a claude-codeЧто делает linkfox-echotik-batch-product-detail
Принимает список productIds, ссылок productUrls или их комбинацию, после чего запрашивает данные EchoTik через скрипт scripts/echotik_batch_product_detail.py. Показывает цену в USD, общий и 30-дневный объём продаж, расчётный GMV, комиссии, оценки, охват инфлюенсеров и параметры прямых трансляций.
Каждый вызов списывает 5 единиц расчётной мощности LinkFox, поэтому скрипт использует локальный кэш на 24 часа для идентичных запросов. Ответы сохраняются в файл JSON внутри рабочей папки, а при размере свыше 8 KB в консоль выводится только краткая сводка.
Без ключа в переменных LINKFOX_AGENT_API_KEY или LINKFOXAGENT_API_KEY запросы завершаются ошибками 401 или 402.
Какие задачи решает
- сравнить показатели GMV и динамику продаж нескольких товаров TikTok Shop
- выявить товары со статусом полного托管 или снятые с продажи
- собрать статистику стримов и привязанных инфлюенсеров по списку ссылок
Примеры запросов агенту
- Сравни продажи и выручку для товаров 1729382310407603945 и 1729382310407603946
- Запроси детализацию по ссылке https://shop.tiktok.com/us/pdp/phone-case/1729382310407603945 и покажи долю комиссионных
- Проверь статус карточек и метрики стримов для списка ссылок из файла
Как установить linkfox-echotik-batch-product-detail
1Через Skills CLI (Vercel)
npx skills add linkfox-ai/linkfox-skills --skill linkfox-echotik-batch-product-detail -a claude-code2Вручную: положить файлы
~/.claude/skills/linkfox-echotik-batch-product-detail/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/linkfox-echotik-batch-product-detail/
1Через Skills CLI (Vercel)
npx skills add linkfox-ai/linkfox-skills --skill linkfox-echotik-batch-product-detail -a codex2Вручную: положить файлы
.agents/skills/linkfox-echotik-batch-product-detail/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add linkfox-ai/linkfox-skills --skill linkfox-echotik-batch-product-detail -a cursor2Вручную: положить файлы
.cursor/skills/linkfox-echotik-batch-product-detail/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install linkfox-ai/linkfox-skills skills/linkfox-echotik-batch-product-detail2Вручную: положить файлы
.github/skills/linkfox-echotik-batch-product-detail/SKILL.md1Через Skills CLI (Vercel)
npx skills add linkfox-ai/linkfox-skills --skill linkfox-echotik-batch-product-detail -a gemini-cli2Командой платформы
gemini skills install https://github.com/linkfox-ai/linkfox-skills --path skills/linkfox-echotik-batch-product-detailВручную: положить файлы
.devin/skills/linkfox-echotik-batch-product-detail/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add linkfox-ai/linkfox-skills --skill linkfox-echotik-batch-product-detail -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о linkfox-echotik-batch-product-detail
Как установить linkfox-echotik-batch-product-detail в Claude Code?
Выполните команду npx skills add linkfox-ai/linkfox-skills --skill linkfox-echotik-batch-product-detail -a claude-code. Конфигурация запишется по пути ~/.claude/skills/linkfox-echotik-batch-product-detail/SKILL.md.
Что делает этот скилл?
Пакетно выгружает аналитику EchoTik по переданным идентификаторам или URL товаров TikTok Shop, отображая динамику выручки, стримы и комиссии.
Какие ключи требуются для запуска запросов?
Необходимо задать переменную окружения LINKFOX_AGENT_API_KEY или LINKFOXAGENT_API_KEY с положительным балансом вычислительных единиц.
Исходный текст
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