linkfox-tiktok-shop-product-detail

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

TikTok Shop Product Detail Lookup

TikTok Shop 商品详情查询

Fetch the current public detail of one TikTok Shop product by product URL or 19-digit product ID, with an optional marketplace region.

通过商品URL或19位商品ID获取TikTok Shop某一商品的当前公开详情，可指定目标站点区域。

Core Concepts

核心概念

One product per call:
```
productInput
```
identifies one product; this is not a search or ranking tool.
Marketplace context:
```
region
```
selects the storefront context and defaults to
```
US
```
.
Readable grouped data: the service returns a stable, readable set of product-detail groups.
Current snapshot: values reflect what the public storefront exposes at request time, not historical analytics.

单次查询单个商品：
```
productInput
```
用于标识单个商品；本工具并非搜索或排名工具。
站点上下文：
```
region
```
用于选择店铺前端环境，默认值为
```
US
```
。
分组可读数据：服务返回一组稳定、易读的商品详情分组数据。
当前快照：返回值反映请求时公开店铺前端显示的信息，而非历史分析数据。

Data Fields

数据字段

Each object in

data

may contain these top-level groups:

Field	Description
productId	TikTok Shop product ID
status	Platform product status code; do not infer availability from this field alone
title	Product title
category	Category name and ID
pricing	Currency, sale price, original price, discount, and source pricing fields
sales	Public sold count and related sales display data
inventory	Total stock, SKUs, variant properties, prices, and default selection
media	Product image URLs and image metadata
seller	Seller ID, shop name, rating, location, and available shop data
reviews	Public review summary when available
shipping	Logistics and shipping modules when available
actions	Purchase-button and favorite-state data
additional	Other readable promotion, rights, review-entry, and product modules

Nested fields vary by product and region. Preserve the returned values rather than inventing missing fields.

data

中的每个对象可能包含以下顶级分组：

字段	描述
productId	TikTok Shop商品ID
status	平台商品状态码；请勿仅通过此字段推断商品是否可用
title	商品标题
category	类目名称及ID
pricing	货币类型、售价、原价、折扣及来源定价字段
sales	公开销量及相关销售展示数据
inventory	总库存、SKU、变体属性、价格及默认选中项
media	商品图片URL及图片元数据
seller	卖家ID、店铺名称、评分、所在地及可用的店铺数据
reviews	公开评论摘要（如有）
shipping	物流及配送模块信息（如有）
actions	购买按钮及收藏状态数据
additional	其他可读的促销、权益、评论入口及商品模块信息

嵌套字段会因商品和区域而异。请保留返回值，不要自行补充缺失字段。

Parameter Guide

参数指南

Parameter	Required	Default	Description
productInput	Yes	-	TikTok HTTPS URL on `tiktok.com` or a subdomain, using the default HTTPS port and a path containing `product/<19-digit-id>` ; or a 19-digit product ID passed as a string
region	No	`US`	Uppercase storefront code: `US` , `GB` , `ID` , `MY` , `TH` , `VN` , `PH` , `SG` , `DE` , `FR` , `IT` , or `ES`

参数	是否必填	默认值	描述
productInput	是	-	TikTok主站或子域名的HTTPS URL，使用默认HTTPS端口，路径包含 `product/<19-digit-id>` ；或作为字符串传入的19位商品ID
region	否	`US`	大写的店铺前端代码： `US` 、 `GB` 、 `ID` 、 `MY` 、 `TH` 、 `VN` 、 `PH` 、 `SG` 、 `DE` 、 `FR` 、 `IT` 或 `ES`

调用方式

API 端点：
```
POST /tiktok/shop/product/detail
```
（完整参数/响应/错误码见
```
references/api.md
```
）

Python 脚本：

python scripts/tiktok_shop_product_detail.py '<JSON 参数>' [--inline]

成本约束：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。

输出策略（脚本默认行为）：

始终将完整响应写入
```
<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-tiktok-shop-product-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 /tiktok/shop/product/detail
```
（完整参数/响应/错误码见
```
references/api.md
```
）

Python 脚本：

python scripts/tiktok_shop_product_detail.py '<JSON 参数>' [--inline]

成本约束：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。

输出策略（脚本默认行为）：

始终将完整响应写入
```
<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-tiktok-shop-product-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 进入上下文。

解决认证和积分问题

发生以下异常情况时，采用

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

使用示例

Product URL

bash

python scripts/tiktok_shop_product_detail.py '{"productInput":"https://shop.tiktok.com/view/product/1729937400435937604","region":"US"}'

Product ID for the UK storefront

bash

python scripts/tiktok_shop_product_detail.py '{"productInput":"1729937400435937604","region":"GB"}'

商品URL

bash

python scripts/tiktok_shop_product_detail.py '{"productInput":"https://shop.tiktok.com/view/product/1729937400435937604","region":"US"}'

针对英国站点的商品ID

bash

python scripts/tiktok_shop_product_detail.py '{"productInput":"1729937400435937604","region":"GB"}'

Display Rules

展示规则

Lead with the product title, product ID, requested region, category, and returned status.
Show sale/original price with the returned currency; never convert currencies unless the user asks separately.
Present SKU variants, variant prices, and stock in a table when available.
Render product images inline when useful, but avoid flooding the response with every image.
Show seller, public sold count, review summary, and shipping information only when present.
Treat
```
status
```
, stock, and purchase-button data together; do not call a product “available” from one field alone.
Report missing, empty, or inconsistent fields as unavailable rather than estimating them.
For large nested sections, summarize first and read exact fields from the saved JSON only as needed.

首先展示商品标题、商品ID、请求区域、类目及返回的状态。
显示售价/原价及返回的货币类型；除非用户单独要求，否则请勿转换货币。
如有可用，以表格形式展示SKU变体、变体价格及库存。
在有用时内嵌展示商品图片，但避免在响应中堆砌所有图片。
仅在有相关数据时展示卖家信息、公开销量、评论摘要及配送信息。
将
```
status
```
、库存及购买按钮数据结合起来判断；请勿仅通过单个字段判定商品“可用”。
对于缺失、为空或不一致的字段，报告为不可用，而非自行估算。
对于大型嵌套部分，先进行摘要说明，仅在需要时从保存的JSON中读取具体字段。

Important Limitations

重要限制

Public fields can vary by product, seller, region, and storefront context.
URL inputs must include a
```
product/<19-digit-id>
```
path segment; use the 19-digit product ID directly when another TikTok URL format is unavailable.
A product may be removed, unavailable, or out of stock and still return structured metadata.
This tool does not provide historical price/stock trends, ranking lists, or guaranteed sales analytics.
This tool does not manage an authorized seller account or edit listings; use the TikTok Shop ERP product skill for seller operations.
The readable response can be large because SKU, media, shipping, and additional modules retain nested source fields.

公开字段会因商品、卖家、区域及店铺前端上下文而异。
URL输入必须包含
```
product/<19-digit-id>
```
路径段；当无法获取其他格式的TikTok URL时，请直接使用19位商品ID。
商品可能已下架、不可用或缺货，但仍可能返回结构化元数据。
本工具不提供历史价格/库存趋势、排名列表或可靠的销售分析数据。
本工具不管理授权卖家账户或编辑商品列表；卖家操作请使用TikTok Shop ERP产品技能。
可读响应可能较大，因为SKU、媒体、配送及附加模块保留了嵌套的源字段。

User Expression & Scenario Quick Reference

用户表述与场景速查

Applicable — one known TikTok Shop product:

User Says	Scenario
“查这个 TikTok Shop 链接的商品详情”	URL detail lookup
“这个 19 位 TikTok 商品 ID 卖什么？”	Product ID lookup
“看看这个商品的价格、SKU 和库存”	Current listing audit
“提取这个 TikTok 商品的图片和店铺信息”	Media and seller extraction

Not applicable:

TikTok product search, bestseller rankings, or multi-product screening
Historical GMV, creator, livestream, or video-attribution analytics
Authorized shop listing creation, editing, price changes, or stock changes
TikTok video-page or creator-profile analysis

适用场景 — 查询单个已知TikTok Shop商品：

用户表述	场景
“查这个 TikTok Shop 链接的商品详情”	URL详情查询
“这个 19 位 TikTok 商品 ID 卖什么？”	商品ID查询
“看看这个商品的价格、SKU 和库存”	当前商品列表审核
“提取这个 TikTok 商品的图片和店铺信息”	媒体及卖家信息提取

不适用场景：

TikTok商品搜索、畅销榜排名或多商品筛选
历史GMV、创作者、直播或视频归因分析
授权店铺商品列表创建、编辑、价格调整或库存变更
TikTok视频页面或创作者主页分析

积分消耗规则

消耗 63 积分。

用户会因积分消耗而支付费用。重复查询不同地区或不同商品会分别计费；继续调用前应让用户知晓额外消耗。

Feedback:

Auto-detect and report feedback via the Feedback API when the described capability differs from actual behavior, results miss the user's intent, the user expresses praise or dissatisfaction, or the skill can be improved. Follow

references/api.md

without interrupting the user's flow.

For more high-quality, professional cross-border e-commerce skills, visit LinkFox Skills.

消耗 63 积分。

用户会因积分消耗而支付费用。重复查询不同地区或不同商品会分别计费；继续调用前应让用户知晓额外消耗。

反馈:

当描述的功能与实际行为不符、结果未满足用户意图、用户表达赞扬或不满，或技能可优化时，通过Feedback API自动检测并提交反馈。遵循

references/api.md

中的指引，且不打断用户流程。

如需更多高质量、专业的跨境电商技能，请访问 LinkFox Skills。