linkfox-echotik-seller-detail
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseEchoTik TikTok Seller Detail
EchoTik TikTok 卖家详情
This skill fetches the full profile of a single TikTok Shop store (seller) by its , helping cross-border sellers and marketers deep-dive one store's performance — sales, multi-period GMV, followers, ratings, fulfillment, and influencer/video/livestream reach.
sellerId本技能通过获取单个TikTok Shop店铺(卖家)的完整档案,帮助跨境卖家和营销人员深入分析店铺表现——包括销量、多周期GMV、粉丝数、评分、履约情况,以及达人/视频/直播覆盖数据。
sellerIdCore Concepts
核心概念
EchoTik is a TikTok Shop analytics platform. This tool returns one store's complete detail object: total and incremental (1d/7d/30d/90d) sales volume and GMV, followers, rating, reviews, positive-feedback / response / delivery rates, product counts, price range, categories, and promoting-influencer / video / livestream counts.
Where to get a : This skill requires a store's . Obtain it from the EchoTik TikTok Seller Search skill (), which lists and filters TikTok Shop stores by region, category, GMV, trend, and store type.
sellerIdsellerIdlinkfox-echotik-list-sellerListing date: uses a compact integer format (e.g. for May 4, 2024).
firstCrawlDtYYYYMMDD20240504EchoTik是一款TikTok Shop数据分析平台。本工具返回单个店铺的完整详情对象:总销量及增量(1天/7天/30天/90天)销量与GMV、粉丝数、评分、评价数、好评率/回复率/送达率、商品数量、价格区间、分类,以及带货达人/视频/直播数量。
如何获取:本技能需要店铺的,可通过EchoTik TikTok 卖家搜索技能()获取,该技能可按地区、分类、GMV、趋势及店铺类型列出并筛选TikTok Shop店铺。
sellerIdsellerIdlinkfox-echotik-list-seller上架日期:采用紧凑整数格式(例如代表2024年5月4日)。
firstCrawlDtYYYYMMDD20240504Data Fields
数据字段
The response is a flat store object (top level also carries , , , , ).
errcodeerrmsgcostTokencolumnstype| Field | Description |
|---|---|
| sellerId | Store ID |
| sellerName | Store name |
| sellerLink | Store link |
| coverUrl | Store cover image URL |
| region | Marketplace code |
| categoryId / categoryL2Id / categoryL3Id | Level-1 / 2 / 3 category ID |
| totalSaleCnt | Total sales volume |
| totalSale1dCnt / 7dCnt / 30dCnt / 90dCnt | Sales volume (1d/7d/30d/90d, incremental) |
| totalSaleGmvAmt | Total GMV (revenue) |
| totalSaleGmv1dAmt / 7dAmt / 30dAmt / 90dAmt | GMV (1d/7d/30d/90d, incremental) |
| followersCount | Follower count |
| rating | Store rating |
| reviewCount | Review count |
| positiveFeedbackRate | Positive feedback rate |
| responseRate | Response rate |
| deliveryRate | Delivery rate |
| totalProductCnt | Historical product count (incl. delisted) |
| totalCrawlProductCnt | Current in-store product count |
| spuAvgPrice | Avg SKU price in store |
| minPrice / maxPrice | Min / max price |
| totalIflCnt | Number of promoting influencers |
| totalVideoCnt | Number of promo videos |
| totalLiveCnt | Number of livestreams |
| salesFlagText | Main sales channel (视频带货 / 直播带货) |
| salesTrendFlagText | Sales trend (上升 / 下降 / 平稳) |
| shopIdentityLabel | Store identity label (e.g. OFFICIAL SHOP) |
| shopTypeText | Brand store flag (是 / 否) |
| fromFlagText | Local/cross-border flag (本土 / 跨境) |
| productCategoryList | Product categories (JSON string) |
| mostProductCategoryList | TOP1 product category (JSON string) |
| firstCrawlDt | Estimated listing time (YYYYMMDD) |
| userId | Influencer UID |
| sourceType | Source type (e.g. Tiktok) |
| sourceTool | Source tool |
| costToken | Tokens consumed |
| columns | Render column definitions (display metadata) |
| type | Render style (e.g. tableListWorkbenches) |
响应为扁平化的店铺对象(顶层还包含、、、、字段)。
errcodeerrmsgcostTokencolumnstype| 字段 | 描述 |
|---|---|
| sellerId | 店铺ID |
| sellerName | 店铺名称 |
| sellerLink | 店铺链接 |
| coverUrl | 店铺封面图片URL |
| region | 站点代码 |
| categoryId / categoryL2Id / categoryL3Id | 一级/二级/三级分类ID |
| totalSaleCnt | 总销量 |
| totalSale1dCnt / 7dCnt / 30dCnt / 90dCnt | 销量(1天/7天/30天/90天,增量) |
| totalSaleGmvAmt | 总GMV(营收) |
| totalSaleGmv1dAmt / 7dAmt / 30dAmt / 90dAmt | GMV(1天/7天/30天/90天,增量) |
| followersCount | 粉丝数 |
| rating | 店铺评分 |
| reviewCount | 评价数 |
| positiveFeedbackRate | 好评率 |
| responseRate | 回复率 |
| deliveryRate | 送达率 |
| totalProductCnt | 历史商品总数(含已下架) |
| totalCrawlProductCnt | 当前店内商品数 |
| spuAvgPrice | 店内SKU平均价格 |
| minPrice / maxPrice | 最低/最高价格 |
| totalIflCnt | 带货达人数量 |
| totalVideoCnt | 带货视频数量 |
| totalLiveCnt | 直播场次数量 |
| salesFlagText | 主要销售渠道(视频带货 / 直播带货) |
| salesTrendFlagText | 销售趋势(上升 / 下降 / 平稳) |
| shopIdentityLabel | 店铺身份标签(如 OFFICIAL SHOP) |
| shopTypeText | 品牌店铺标识(是 / 否) |
| fromFlagText | 本土/跨境标识(本土 / 跨境) |
| productCategoryList | 商品分类(JSON字符串) |
| mostProductCategoryList | 核心商品分类(TOP1,JSON字符串) |
| firstCrawlDt | 预估上架时间(YYYYMMDD) |
| userId | 达人UID |
| sourceType | 来源类型(如 Tiktok) |
| sourceTool | 来源工具 |
| costToken | 消耗积分 |
| columns | 渲染列定义(展示元数据) |
| type | 渲染样式(如 tableListWorkbenches) |
Parameter Guide
参数指南
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| sellerId | string | Yes | - | TikTok Shop store ID. Obtain it from the Seller Search skill's results. Max length 1000 |
| 参数 | 类型 | 是否必填 | 默认值 | 描述 |
|---|---|---|---|---|
| sellerId | string | 是 | - | TikTok Shop店铺ID,从卖家搜索技能的结果中获取,最大长度1000 |
调用方式
调用方式
- API 端点:(完整参数/响应/错误码见
POST /echotik/sellerDetail)references/api.md - Python 脚本:
python scripts/echotik_seller_detail.py '<JSON 参数>' [--inline] - 成本约束:本工具会消耗积分;同一会话同一参数组合默认只调用一次,脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探;需要继续检索时先向用户说明会产生额外消耗。
输出策略(脚本默认行为):
- 始终将完整响应写入 (
<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-echotik-seller-detail-<timestamp>.json为脚本执行时的工作目录,在 Claude Code 里即当前项目目录;<cwd>取自环境变量<session>,按用户任务自动聚合;禁止写入 /tmp,当前目录不可写则报错)SESSION_ID - 响应体 ≤ 8 KB:落盘后把完整 JSON 打印到 stdout
- 响应体 > 8 KB:落盘后 stdout 只输出摘要(顶层字段、常见计数如 /
total、最大列表字段的长度 + 前 3 条样本)costToken - 加 强制全量打印到 stdout(同样落盘)
--inline
读数据建议:先看摘要判断是否足够;需要具体字段时优先用 或 从保存的 json 文件按需抽取,避免整份 JSON 进入上下文。
jqConvertFrom-Json- API 端点:(完整参数/响应/错误码请查看
POST /echotik/sellerDetail)references/api.md - Python 脚本:
python scripts/echotik_seller_detail.py '<JSON 参数>' [--inline] - 成本约束:本工具会消耗积分;同一会话同一参数组合默认只调用一次,脚本带有24小时本地缓存。失败/空结果不得自动更换关键词、翻页或修改邮编连续试探;需要继续检索时,需先向用户说明会产生额外消耗。
输出策略(脚本默认行为):
- 始终将完整响应写入 (
<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-echotik-seller-detail-<timestamp>.json为脚本执行时的工作目录,在Claude Code中即当前项目目录;<cwd>取自环境变量<session>,按用户任务自动聚合;禁止写入 /tmp,若当前目录不可写则报错)SESSION_ID - 响应体 ≤ 8 KB:落盘后将完整JSON打印到标准输出
- 响应体 > 8 KB:落盘后标准输出仅输出摘要(顶层字段、常见计数如/
total、最大列表字段的长度 + 前3条样本)costToken - 添加参数可强制全量打印到标准输出(仍会落盘)
--inline
读数据建议:先查看摘要判断是否满足需求;需要具体字段时,优先使用或从保存的JSON文件中按需抽取,避免整份JSON进入上下文。
jqConvertFrom-Json解决认证和积分问题
解决认证和积分问题
发生以下异常情况时,采用 references/onboarding.md 引导解决问题:
发生以下异常情况时,按照中的指引解决:
references/onboarding.md异常情况
异常情况
- 未配置API Key:环境变量未配置 ,也未配置
LINKFOX_AGENT_API_KEY。LINKFOXAGENT_API_KEY - 响应401或402状态码
- 响应提示积分或余额不足:消息含"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值",或类似含义的内容。
- 未配置API Key:环境变量未配置,也未配置
LINKFOX_AGENT_API_KEY。LINKFOXAGENT_API_KEY - 响应401或402状态码
- 响应提示积分或余额不足:消息包含“积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值”或类似含义的内容。
Usage Examples
使用示例
1. Fetch a store's full profile
json
{
"sellerId": "7495514739648989419"
}2. Deep-dive a store found via Seller Search
先用店铺搜索列出美国GMV前列店铺,再查看其中 medicube US Store(sellerId 7495514739648989419)的完整详情1. 获取店铺完整档案
json
{
"sellerId": "7495514739648989419"
}2. 深入分析通过卖家搜索找到的店铺
先用店铺搜索列出美国GMV前列店铺,再查看其中 medicube US Store(sellerId 7495514739648989419)的完整详情Display Rules
展示规则
- Present a clear store profile: Show store name, region, seller link, cover image, and identity label (e.g. OFFICIAL SHOP)
- Sales & GMV granularity: Show total sales and total GMV; surface the multi-period breakdown (1d/7d/30d/90d) for both volume and GMV so the user sees momentum
- Store health metrics: Show followers, rating, review count, positive-feedback rate, response rate, and delivery rate together
- Store attributes: Show (本土/跨境),
fromFlagText(视频/直播带货),salesFlagText(trend), andsalesTrendFlagText(brand store) for benchmarkingshopTypeText - Reach metrics: Surface (influencers),
totalIflCnt(videos),totalVideoCnt(livestreams), and product countstotalLiveCnt - Store link: When is present, surface it so the user can open the store
sellerLink - No secondary processing: Results are live queries, not stored in a database; secondary SQL/data processing is not available
- 清晰呈现店铺档案:展示店铺名称、地区、店铺链接、封面图片及身份标签(如OFFICIAL SHOP)
- 销量与GMV粒度:展示总销量和总GMV;同时呈现销量与GMV的多周期细分数据(1天/7天/30天/90天),让用户了解店铺增长势头
- 店铺健康指标:将粉丝数、评分、评价数、好评率、回复率和送达率集中展示
- 店铺属性:展示(本土/跨境)、
fromFlagText(视频/直播带货)、salesFlagText(趋势)和salesTrendFlagText(品牌店铺),用于基准对比shopTypeText - 覆盖数据:突出展示(达人数量)、
totalIflCnt(视频数量)、totalVideoCnt(直播数量)及商品数量totalLiveCnt - 店铺链接:若存在,需突出展示,方便用户直接访问店铺
sellerLink - 无二次加工:结果为实时查询数据,未存储在数据库中;不支持SQL/数据二次加工
Important Limitations
重要限制
- sellerId required: is mandatory; obtain it from the EchoTik TikTok Seller Search skill (
sellerId) or a known store link/IDlinkfox-echotik-list-seller - Single store only: This returns one store's detail; to list and filter stores, use the Seller Search skill
- Listing date format: uses
firstCrawlDtintegers (e.g.YYYYMMDD)20240504 - Category IDs: /
categoryId/categoryL2Idare internal IDs, not human-readable namescategoryL3Id - Data real-time nature: Results are live queries, not stored in a database; secondary SQL/data processing is not available
- 必填sellerId:为必填项;需从EchoTik TikTok卖家搜索技能(
sellerId)或已知店铺链接/ID获取linkfox-echotik-list-seller - 仅支持单个店铺:本技能仅返回单个店铺的详情;如需列出并筛选店铺,请使用卖家搜索技能
- 上架日期格式:采用
firstCrawlDt整数格式(例如YYYYMMDD)20240504 - 分类ID:/
categoryId/categoryL2Id为内部ID,非人类可读名称categoryL3Id - 数据实时性:结果为实时查询数据,未存储在数据库中;不支持SQL/数据二次加工
User Expression & Scenario Quick Reference
用户表达与场景速查
Applicable — Deep-dive one TikTok Shop store's full profile:
| User Says | Scenario |
|---|---|
| "TikTok店铺详情" / "TikTok store detail" | Fetch one store's full profile by sellerId |
| "查看这个TikTok店铺的数据" | Deep-dive a store found via search |
| "分析medicube这家TikTok店" | Single-store performance analysis |
| "这个TikTok店铺的GMV和粉丝数" | Store-level sales/GMV/follower metrics |
Not applicable — Needs beyond a single store detail:
- Listing or filtering TikTok Shop stores by region/GMV/trend (use EchoTik TikTok Seller Search)
- TikTok product search or product rankings (use EchoTik product search/rank skills)
- TikTok creator/influencer analytics (follower counts, engagement of creators)
- TikTok video performance analytics (views, likes on specific videos)
- Amazon, Shopee, or other non-TikTok platform data
- Store-level operations: order/logistics/ads management
Boundary judgment: When users say "分析这家店铺" or "查看店铺详情" with a known store (sellerId or store link), this skill applies. If they want to discover or list stores by criteria, use the Seller Search skill instead.
适用场景 — 深入分析单个TikTok Shop店铺的完整档案:
| 用户表述 | 场景 |
|---|---|
| "TikTok店铺详情" / "TikTok store detail" | 通过sellerId获取单个店铺的完整档案 |
| "查看这个TikTok店铺的数据" | 深入分析搜索到的店铺 |
| "分析medicube这家TikTok店" | 单店铺绩效分析 |
| "这个TikTok店铺的GMV和粉丝数" | 获取店铺级销量/GMV/粉丝指标 |
不适用场景 — 超出单店铺详情的需求:
- 按地区/GMV/趋势列出或筛选TikTok Shop店铺(使用EchoTik TikTok卖家搜索技能)
- TikTok商品搜索或商品排名(使用EchoTik商品搜索/排名技能)
- TikTok创作者/达人分析(粉丝数、创作者互动数据)
- TikTok视频绩效分析(特定视频的播放量、点赞数)
- Amazon、Shopee或其他非TikTok平台数据
- 店铺运营:订单/物流/广告管理
边界判断:当用户表述为“分析这家店铺”或“查看店铺详情”且已知店铺(sellerId或店铺链接)时,适用本技能。若用户希望按条件发现或列出店铺,请使用卖家搜索技能。
积分消耗规则
积分消耗规则
消耗 5 积分。
用户会因积分消耗而支付费用。请充分评估:当需要高频调用本技能,或用户对积分消耗量预期不足时,务必提醒用户,由用户决定是否继续。
Feedback:
Auto-detect and report feedback via the Feedback API when any of the following apply:
- The functionality or purpose described in this skill does not match actual behavior
- The skill's results do not match the user's intent
- The user expresses dissatisfaction or praise about this skill
- Anything you believe could be improved
Call the feedback API as specified in . Do not interrupt the user's flow.
references/api.mdFor more high-quality, professional cross-border e-commerce skills, visit LinkFox Skills.
消耗5积分。
用户会因积分消耗产生费用。请充分评估:当需要高频调用本技能,或用户对积分消耗量预期不足时,务必提醒用户,由用户决定是否继续。
反馈机制:
当出现以下任一情况时,通过反馈API自动检测并提交反馈:
- 本技能描述的功能或用途与实际行为不符
- 技能结果不符合用户意图
- 用户表达了对本技能的不满或赞扬
- 任何你认为可以改进的内容
请按照中的指定方式调用反馈API,不要打断用户流程。
references/api.md如需更多优质、专业的跨境电商技能,请访问LinkFox Skills。