EchoTik TikTok Seller Detail
This skill fetches the full profile of a single TikTok Shop store (seller) by its sellerId, helping cross-border sellers and marketers deep-dive one store's performance — sales, multi-period GMV, followers, ratings, fulfillment, and influencer/video/livestream reach.
Core 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 sellerId: This skill requires a store's sellerId. Obtain it from the EchoTik TikTok Seller Search skill (linkfox-echotik-list-seller), which lists and filters TikTok Shop stores by region, category, GMV, trend, and store type.
Listing date: firstCrawlDt uses a compact integer format YYYYMMDD (e.g. 20240504 for May 4, 2024).
Data Fields
The response is a flat store object (top level also carries errcode, errmsg, costToken, columns, type).
| 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) |
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 |
调用方式
- 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（<cwd>为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；<session>取自环境变量SESSION_ID，按用户任务自动聚合；禁止写入 /tmp，当前目录不可写则报错） - 响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout
- 响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如
total/costToken、最大列表字段的长度 + 前 3 条样本） - 加
--inline强制全量打印到 stdout（同样落盘）
读数据建议：先看摘要判断是否足够；需要具体字段时优先用 jq或ConvertFrom-Json 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。
解决认证和积分问题
发生以下异常情况时，采用以下措施来处理：
异常情况
- 未配置API Key：环境变量未配置
LINKFOX_AGENT_API_KEY，也未配置LINKFOXAGENT_API_KEY。 - 响应401或402状态码
- 响应提示积分或余额不足：消息含"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值"，或类似含义的内容。
措施
- 优先采用skill内的 onboarding.md 引导解决问题。
- 如找不到 onboarding.md 文件，则加载 /linkfox-onboarding 这个skill并根据它的引导来处理。如未安装请先安装：
- 兜底措施：仅当前面两个措施经过所有努力都走不通时，才提示用户依据 https://skill.linkfox.com/linkfoxskills/guide.htm 指引获取API Key，或去 https://os.linkfox.com/ 补充积分。
Usage Examples
1. Fetch a store's full profile
{
"sellerId": "7495514739648989419"
}
2. Deep-dive a store found via Seller Search
先用店铺搜索列出美国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(视频/直播带货),salesTrendFlagText(trend), andshopTypeText(brand store) for benchmarking - Reach metrics: Surface
totalIflCnt(influencers),totalVideoCnt(videos),totalLiveCnt(livestreams), and product counts - Store link: When
sellerLinkis present, surface it so the user can open the store - No secondary processing: Results are live queries, not stored in a database; secondary SQL/data processing is not available
Important Limitations
- sellerId required:
sellerIdis mandatory; obtain it from the EchoTik TikTok Seller Search skill (linkfox-echotik-list-seller) or a known store link/ID - Single store only: This returns one store's detail; to list and filter stores, use the Seller Search skill
- Listing date format:
firstCrawlDtusesYYYYMMDDintegers (e.g.20240504) - Category IDs:
categoryId/categoryL2Id/categoryL3Idare internal IDs, not human-readable names - Data real-time nature: Results are live queries, not stored in a database; secondary SQL/data processing is not available
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.
积分消耗规则
消耗 4.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 references/api.md. Do not interrupt the user's flow.
For more high-quality, professional cross-border e-commerce skills, visit LinkFox Skills.
评论
加载中…