Back to Details

linkfox-shopee-product-detail

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Shopee Product Detail Lookup

Shopee 商品详情查询

Fetch the current public detail of one Shopee product from a supported marketplace URL.
从支持的平台链接获取单个Shopee商品的当前公开详情。

Core Concepts

核心概念

  • One product per call: 
    productUrl
    identifies one listing; this is not a keyword-search tool.
  • Market from URL: the storefront, currency, and locale are inferred from the URL.
  • Direct-listing mode: the tool auto-detects the supplied product URL and requests exactly one matching listing row.
  • Current snapshot: available price, inventory, sales, rating, and shop values reflect the public page at request time.
  • 单次查询单个商品：
    productUrl
    用于标识单个商品Listing；本工具并非关键词搜索工具。
  • 从链接识别站点：店铺页面、货币和区域信息将从链接中自动推断。
  • 直接Listing模式：工具会自动检测提供的商品链接，并请求对应唯一匹配的Listing数据。
  • 实时快照：返回的价格、库存、销量、评分和店铺信息均为请求时公开页面的实时数据。

Data Fields

数据字段

Each object in 
data
can contain:
GroupRepresentative fields
Identity
itemId
, 
shopId
, 
url
, 
name
, 
brand
, 
categoryId
, 
categoryBreadcrumb
Media
image
, 
images
, 
videos
Pricing
price
, 
priceBeforeDiscount
, 
priceMin
, 
priceMax
, 
discountPercent
, 
currency
Demand
sold
, 
soldDisplayed
, 
rating
, 
ratingCount
, 
ratingDistribution
, 
likedCount
Inventory
stock
, 
tierVariations
, 
models
Shop
shopName
, 
shopRating
, 
shopLocation
, 
isMall
, official and verification signals, nested 
shop
data
Content
description
, 
attributes
, category data, availability and condition when supplied
Less-common and newly introduced top-level fields are preserved in the returned product object. Fields may be absent or 
null
.
data
中的每个对象可包含以下内容：
分类代表性字段
基础信息
itemId
、
shopId
、
url
、
name
、
brand
、
categoryId
、
categoryBreadcrumb
媒体信息
image
、
images
、
videos
定价信息
price
、
priceBeforeDiscount
、
priceMin
、
priceMax
、
discountPercent
、
currency
需求信息
sold
、
soldDisplayed
、
rating
、
ratingCount
、
ratingDistribution
、
likedCount
库存信息
stock
、
tierVariations
、
models
店铺信息
shopName
、
shopRating
、
shopLocation
、
isMall
、官方认证标识、嵌套的
shop
数据
内容信息
description
、
attributes
、类目数据、商品可用性及状态（若提供）
返回的商品对象中会保留不常见及新增的顶级字段。部分字段可能不存在或为
null
。

Parameter Guide

参数指南

ParameterRequiredDefaultDescription
productUrlYes-Shopee HTTPS product URL whose path ends with 
-i.<numeric shopId>.<numeric itemId>
Supported hosts: 
shopee.sg
, 
shopee.co.id
, 
shopee.com.my
, 
shopee.ph
, 
shopee.co.th
, 
shopee.tw
, 
shopee.vn
, and 
shopee.com.br
.
参数是否必填默认值说明
productUrl是-Shopee HTTPS商品链接，路径需以
-i.<数字店铺ID>.<数字商品ID>
结尾
支持的站点域名：
shopee.sg
、
shopee.co.id
、
shopee.com.my
、
shopee.ph
、
shopee.co.th
、
shopee.tw
、
shopee.vn
和
shopee.com.br
。

调用方式

调用方式

  • API 端点：
    POST /shopee/product/detail
    （完整参数/响应/错误码见 
    references/api.md
    ）
  • Python 脚本：
    python scripts/shopee_product_detail.py '<JSON 参数>' [--inline]
  • 成本约束：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。
输出策略（脚本默认行为）：
  • 始终将完整响应写入 
    <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-shopee-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 /shopee/product/detail
    （完整参数/响应/错误码见 
    references/api.md
    ）
  • Python 脚本：
    python scripts/shopee_product_detail.py '<JSON 参数>' [--inline]
  • 成本约束：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。
输出策略（脚本默认行为）：
  • 始终将完整响应写入 
    <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-shopee-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
引导解决问题：
  • LINKFOX_AGENT_API_KEY
    与 
    LINKFOXAGENT_API_KEY
    均未配置。
  • 响应状态为 401 或 402。
  • 响应提示积分、余额、套餐或配额不足。
发生以下异常情况时，采用 
references/onboarding.md
引导解决问题：
  • LINKFOX_AGENT_API_KEY
    与 
    LINKFOXAGENT_API_KEY
    均未配置。
  • 响应状态为 401 或 402。
  • 响应提示积分、余额、套餐或配额不足。

Usage Example

使用示例

bash
python scripts/shopee_product_detail.py '{"productUrl":"https://shopee.sg/%28LENECT-OFFICIAL-STORE%29-Flash-I-Aurora-Dual-Highlighter-7.2g-COCOMO-i.9641401.29691169956"}'
bash
python scripts/shopee_product_detail.py '{"productUrl":"https://shopee.sg/%28LENECT-OFFICIAL-STORE%29-Flash-I-Aurora-Dual-Highlighter-7.2g-COCOMO-i.9641401.29691169956"}'

Display Rules

展示规则

  1. Lead with the listing name, item ID, shop, marketplace, current price, currency, stock, and public sold count.
  2. Show current/original price and discount exactly as returned; do not convert currencies unless requested.
  3. Present SKU models and per-variant stock in a compact table when available.
  4. Render a small selection of images inline when useful instead of flooding the response.
  5. Treat Shopee Mall, official-shop, and verified-seller flags independently.
  6. State when descriptions, models, inventory, sold count, or other enrichment fields are unavailable.
  7. Read exact large nested sections from the saved JSON only when the user needs them.
  1. 优先展示商品Listing名称、商品ID、店铺、站点、当前价格、货币、库存及公开销量。
  2. 严格按照返回结果展示当前价格/原价及折扣；除非用户要求，否则不转换货币。
  3. 若有SKU型号及各变体库存信息，以简洁表格形式展示。
  4. 仅在有帮助时内嵌展示少量图片，避免大量图片淹没响应内容。
  5. 独立区分Shopee Mall、官方店铺及认证卖家标识。
  6. 若描述、型号、库存、销量或其他增强字段不可用，需明确说明。
  7. 仅当用户需要时，从保存的JSON文件中读取具体的大型嵌套内容。

Important Limitations

重要限制

  1. The URL must use a documented 
    -i.<shopId>.<itemId>
    path; canonical 
    /product/<shopId>/<itemId>
    URLs are not accepted by this tool.
  2. Customer review rows are not returned. 
    ratingCount
    and 
    ratingDistribution
    are only aggregate signals when the source supplies them.
  3. Public fields vary by market, listing state, seller, and source-page completeness. Indonesia, Singapore, Malaysia, Thailand, and the Philippines usually expose richer detail on the cloud source; Vietnam, Brazil, and Taiwan may return a lighter record.
  4. models
    provides variant stock, while a separate price for every individual variant may be unavailable.
  5. Invalid, removed, or market-mismatched listings return an error rather than a successful empty list.
  6. This tool does not search Shopee, provide historical trends, or manage an authorized seller account.
  1. 链接必须使用指定的
    -i.<shopId>.<itemId>
    路径；标准的
    /product/<shopId>/<itemId>
    格式链接不被本工具支持。
  2. 不返回用户评论内容。
    ratingCount
    和
    ratingDistribution
    仅为源数据提供的聚合统计信息。
  3. 公开字段会因站点、Listing状态、卖家及源页面完整性而有所不同。印度尼西亚、新加坡、马来西亚、泰国和菲律宾站点通常能从云端源获取更丰富的详情；越南、巴西和台湾站点可能返回较精简的数据记录。
  4. models
    字段提供变体库存信息，但可能无法获取每个独立变体的单独价格。
  5. 无效、已移除或站点不匹配的Listing会返回错误，而非成功的空列表。
  6. 本工具不提供Shopee搜索、历史趋势查询或授权卖家账户管理功能。

User Expression & Scenario Quick Reference

用户表述与场景速查

Applicable — one known Shopee listing:
User SaysScenario
“查这个虾皮商品链接”Listing detail lookup
“看一下价格、销量和库存”Current listing audit
“提取变体、图片和品牌”SKU and content extraction
“这个店铺是不是官方店？”Public shop-signal check
Not applicable:
  • Keyword search, rankings, or bulk product screening
  • Full customer-review collection or sentiment mining
  • Historical price and inventory monitoring
  • Authorized seller listing, order, promotion, or account operations
适用场景 — 单个已知Shopee Listing：
用户表述场景
“查这个虾皮商品链接”Listing详情查询
“看一下价格、销量和库存”当前Listing信息核查
“提取变体、图片和品牌”SKU及内容提取
“这个店铺是不是官方店？”公开店铺标识核查
不适用场景：
  • 关键词搜索、排名查询或批量商品筛选
  • 完整用户评论收集或情感分析
  • 历史价格及库存监控
  • 授权卖家的Listing、订单、促销或账户操作

积分消耗规则

积分消耗规则

消耗 53 积分。
用户会因积分消耗而支付费用。重复查询不同商品会分别计费；继续调用前应让用户知晓额外消耗。
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.
消耗 53 积分。
用户会因积分消耗而支付费用。重复查询不同商品会分别计费；继续调用前应让用户知晓额外消耗。
反馈机制：
当描述的功能与实际行为不符、结果未满足用户需求、用户表达赞扬或不满，或技能可优化时，需通过Feedback API自动检测并提交反馈。遵循
references/api.md
的要求，且不打断用户的操作流程。
如需更多高质量、专业的跨境电商技能，请访问 LinkFox Skills。