linkfox-echotik-seller-detail

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

EchoTik TikTok Seller Detail

EchoTik TikTok 卖家详情

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.
本技能通过
sellerId
获取单个TikTok Shop店铺(卖家)的完整档案,帮助跨境卖家和营销人员深入分析店铺表现——包括销量、多周期GMV、粉丝数、评分、履约情况,以及达人/视频/直播覆盖数据。

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).
EchoTik是一款TikTok Shop数据分析平台。本工具返回单个店铺的完整详情对象:总销量及增量(1天/7天/30天/90天)销量与GMV、粉丝数、评分、评价数、好评率/回复率/送达率、商品数量、价格区间、分类,以及带货达人/视频/直播数量。
如何获取
sellerId
:本技能需要店铺的
sellerId
,可通过EchoTik TikTok 卖家搜索技能(
linkfox-echotik-list-seller
)获取,该技能可按地区、分类、GMV、趋势及店铺类型列出并筛选TikTok Shop店铺。
上架日期
firstCrawlDt
采用紧凑整数格式
YYYYMMDD
(例如
20240504
代表2024年5月4日)。

Data Fields

数据字段

The response is a flat store object (top level also carries
errcode
,
errmsg
,
costToken
,
columns
,
type
).
FieldDescription
sellerIdStore ID
sellerNameStore name
sellerLinkStore link
coverUrlStore cover image URL
regionMarketplace code
categoryId / categoryL2Id / categoryL3IdLevel-1 / 2 / 3 category ID
totalSaleCntTotal sales volume
totalSale1dCnt / 7dCnt / 30dCnt / 90dCntSales volume (1d/7d/30d/90d, incremental)
totalSaleGmvAmtTotal GMV (revenue)
totalSaleGmv1dAmt / 7dAmt / 30dAmt / 90dAmtGMV (1d/7d/30d/90d, incremental)
followersCountFollower count
ratingStore rating
reviewCountReview count
positiveFeedbackRatePositive feedback rate
responseRateResponse rate
deliveryRateDelivery rate
totalProductCntHistorical product count (incl. delisted)
totalCrawlProductCntCurrent in-store product count
spuAvgPriceAvg SKU price in store
minPrice / maxPriceMin / max price
totalIflCntNumber of promoting influencers
totalVideoCntNumber of promo videos
totalLiveCntNumber of livestreams
salesFlagTextMain sales channel (视频带货 / 直播带货)
salesTrendFlagTextSales trend (上升 / 下降 / 平稳)
shopIdentityLabelStore identity label (e.g. OFFICIAL SHOP)
shopTypeTextBrand store flag (是 / 否)
fromFlagTextLocal/cross-border flag (本土 / 跨境)
productCategoryListProduct categories (JSON string)
mostProductCategoryListTOP1 product category (JSON string)
firstCrawlDtEstimated listing time (YYYYMMDD)
userIdInfluencer UID
sourceTypeSource type (e.g. Tiktok)
sourceToolSource tool
costTokenTokens consumed
columnsRender column definitions (display metadata)
typeRender style (e.g. tableListWorkbenches)
响应为扁平化的店铺对象(顶层还包含
errcode
errmsg
costToken
columns
type
字段)。
字段描述
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 / 90dAmtGMV(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

参数指南

ParameterTypeRequiredDefaultDescription
sellerIdstringYes-TikTok Shop store ID. Obtain it from the Seller Search skill's results. Max length 1000
参数类型是否必填默认值描述
sellerIdstring-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
    <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 端点
    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
    <cwd>
    为脚本执行时的工作目录,在Claude Code中即当前项目目录;
    <session>
    取自环境变量
    SESSION_ID
    ,按用户任务自动聚合;禁止写入 /tmp,若当前目录不可写则报错)
  • 响应体 ≤ 8 KB:落盘后将完整JSON打印到标准输出
  • 响应体 > 8 KB:落盘后标准输出仅输出摘要(顶层字段、常见计数如
    total
    /
    costToken
    、最大列表字段的长度 + 前3条样本)
  • 添加
    --inline
    参数可强制全量打印到标准输出(仍会落盘)
读数据建议:先查看摘要判断是否满足需求;需要具体字段时,优先使用
jq
ConvertFrom-Json
从保存的JSON文件中按需抽取,避免整份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

展示规则

  1. Present a clear store profile: Show store name, region, seller link, cover image, and identity label (e.g. OFFICIAL SHOP)
  2. 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
  3. Store health metrics: Show followers, rating, review count, positive-feedback rate, response rate, and delivery rate together
  4. Store attributes: Show
    fromFlagText
    (本土/跨境),
    salesFlagText
    (视频/直播带货),
    salesTrendFlagText
    (trend), and
    shopTypeText
    (brand store) for benchmarking
  5. Reach metrics: Surface
    totalIflCnt
    (influencers),
    totalVideoCnt
    (videos),
    totalLiveCnt
    (livestreams), and product counts
  6. Store link: When
    sellerLink
    is present, surface it so the user can open the store
  7. No secondary processing: Results are live queries, not stored in a database; secondary SQL/data processing is not available
  1. 清晰呈现店铺档案:展示店铺名称、地区、店铺链接、封面图片及身份标签(如OFFICIAL SHOP)
  2. 销量与GMV粒度:展示总销量和总GMV;同时呈现销量与GMV的多周期细分数据(1天/7天/30天/90天),让用户了解店铺增长势头
  3. 店铺健康指标:将粉丝数、评分、评价数、好评率、回复率和送达率集中展示
  4. 店铺属性:展示
    fromFlagText
    (本土/跨境)、
    salesFlagText
    (视频/直播带货)、
    salesTrendFlagText
    (趋势)和
    shopTypeText
    (品牌店铺),用于基准对比
  5. 覆盖数据:突出展示
    totalIflCnt
    (达人数量)、
    totalVideoCnt
    (视频数量)、
    totalLiveCnt
    (直播数量)及商品数量
  6. 店铺链接:若存在
    sellerLink
    ,需突出展示,方便用户直接访问店铺
  7. 无二次加工:结果为实时查询数据,未存储在数据库中;不支持SQL/数据二次加工

Important Limitations

重要限制

  1. sellerId required:
    sellerId
    is mandatory; obtain it from the EchoTik TikTok Seller Search skill (
    linkfox-echotik-list-seller
    ) or a known store link/ID
  2. Single store only: This returns one store's detail; to list and filter stores, use the Seller Search skill
  3. Listing date format:
    firstCrawlDt
    uses
    YYYYMMDD
    integers (e.g.
    20240504
    )
  4. Category IDs:
    categoryId
    /
    categoryL2Id
    /
    categoryL3Id
    are internal IDs, not human-readable names
  5. Data real-time nature: Results are live queries, not stored in a database; secondary SQL/data processing is not available
  1. 必填sellerId
    sellerId
    为必填项;需从EchoTik TikTok卖家搜索技能(
    linkfox-echotik-list-seller
    )或已知店铺链接/ID获取
  2. 仅支持单个店铺:本技能仅返回单个店铺的详情;如需列出并筛选店铺,请使用卖家搜索技能
  3. 上架日期格式
    firstCrawlDt
    采用
    YYYYMMDD
    整数格式(例如
    20240504
  4. 分类ID
    categoryId
    /
    categoryL2Id
    /
    categoryL3Id
    为内部ID,非人类可读名称
  5. 数据实时性:结果为实时查询数据,未存储在数据库中;不支持SQL/数据二次加工

User Expression & Scenario Quick Reference

用户表达与场景速查

Applicable — Deep-dive one TikTok Shop store's full profile:
User SaysScenario
"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:
  1. The functionality or purpose described in this skill does not match actual behavior
  2. The skill's results do not match the user's intent
  3. The user expresses dissatisfaction or praise about this skill
  4. 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.
消耗5积分。
用户会因积分消耗产生费用。请充分评估:当需要高频调用本技能,或用户对积分消耗量预期不足时,务必提醒用户,由用户决定是否继续。
反馈机制
当出现以下任一情况时,通过反馈API自动检测并提交反馈:
  1. 本技能描述的功能或用途与实际行为不符
  2. 技能结果不符合用户意图
  3. 用户表达了对本技能的不满或赞扬
  4. 任何你认为可以改进的内容
请按照
references/api.md
中的指定方式调用反馈API,不要打断用户流程。

如需更多优质、专业的跨境电商技能,请访问LinkFox Skills