SuperAPI AI Directory
Partner with us中文AI newsFavorites
Skillslinkfox-shopee-product-detail

linkfox-shopee-product-detail

Data & analytics

View repository

Updated 10-16 00:00

About this skill

Shopee Product Detail Lookup

Fetch the current public detail of one Shopee product from a supported marketplace URL.

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.

Data Fields

Each object in data can contain:

Group Representative 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.

Parameter Guide

Parameter Required Default Description
productUrl Yes - 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.

How to call

  • API endpoint：POST /shopee/product/detail(for full parameters/response/error codes see references/api.md）
  • Python script：python scripts/shopee_product_detail.py '<JSON 参数>' [--inline]
  • Cost constraints: This tool consumes compute; by default the same parameter combination in the same session is called only once, and the script has a 24h local cache. On failure/empty results, do not automatically try different keywords, paginate, or change the postal code to probe repeatedly; if you need to continue searching, first explain to the user that additional consumption will be incurred.

Output strategy (script default behavior)：

  • Alwayswrite the full response to <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-shopee-product-detail-<timestamp>.json（<cwd> is the working directory when the script runs, which in Claude Code is the current project directory;<session> is taken from the environment variable SESSION_ID, automatically aggregated according to the user's task;writing to /tmp is prohibited, if the current directory is not writable, report an error)
  • Response body ≤ 8 KB: after saving to disk, print the full JSON to stdout
  • Response body > 8 KB: after saving to disk, stdout outputs only a summary (top-level fields, common counts such as total/costToken, length of the largest list field + first 3 samples)
  • Add --inline to force full printing to stdout (also saved to disk)

Data reading suggestions: first look at the summary to judge whether it is sufficient; when specific fields are needed, prefer to use jqorConvertFrom-Json to extract on demand from the saved json file, avoiding putting the entire JSON into the context.

Resolve authentication and compute issues

When the following abnormal situations occur, use references/onboarding.md to guide problem resolution:

  • LINKFOX_AGENT_API_KEY and LINKFOXAGENT_API_KEY are both not configured.
  • The response status is 401 or 402.
  • The response indicates insufficient compute, balance, plan, or quota.

Usage Example

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.

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.

User Expression & Scenario Quick Reference

Applicable — one known Shopee listing:

User Says Scenario
"Check this Shopee product link" Listing detail lookup
"Look at the price, sales and stock" Current listing audit
"Extract variants, images and brand" SKU and content extraction
"Is this shop an official store?" 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

Compute consumption rules

Consumes 53 compute.

Users pay fees due to compute consumption. Repeated queries for different products are billed separately; before continuing to call, the user should be informed of the additional consumption.

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.