• Sales Volume Data: Sales in the last 30 days (sold), estimated sales in the last 30 days (estimateSold), total historical sales (historicalSold), sales revenue in the last 30 days (payment)
• Price Data: Default price (price), minimum price (minPrice), maximum price (maxPrice)
• Store Data: Store name, official store status, Shopee Verified status, local/overseas, cross-border/local
• Product Attributes: Rating, number of ratings, number of favorites, number of views, number of SKUs, listing time, category structure

• API Endpoint:

  POST /youying/shopee/getProductInfos

  (complete parameters/responses/error codes can be found in

  references/api.md

  )
• Python Script:

  python scripts/youying_shopee_search.py '<JSON parameters>' [--inline]

• Cost Constraints: This tool consumes points; by default, the same parameter combination in the same session is only called once, and the script has a 24-hour local cache. Do not automatically try different keywords, pagination, or zip codes continuously for failed/empty results; explain to the user that additional consumption will occur before continuing the search.

• Always write the complete response to

  <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-youying-shopee-get-product-infos-<timestamp>.json

  (

  <cwd>

  is the working directory where the script is executed, which is the current project directory in Claude Code;

  <session>

  is obtained from the environment variable

  SESSION_ID

  and is automatically aggregated by user tasks; prohibited from writing to /tmp, report an error if the current directory is not writable)
• Response body ≤ 8 KB: After saving to disk, print the complete JSON to stdout
• Response body > 8 KB: After saving to disk, only output a summary to stdout (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 saves to disk)

jq

ConvertFrom-Json

• API Key Not Configured: The environment variable

  LINKFOX_AGENT_API_KEY

  is not configured, nor is

  LINKFOXAGENT_API_KEY

  .
• Response with 401 or 402 Status Code
• Insufficient Points or Balance: The message contains content such as "insufficient point balance/insufficient billing/insufficient balance/quota exceeded/insufficient balance/package expired/need to recharge/please recharge" or similar meanings.

1. Required Marketplace: The

   station

   parameter must be specified for each call. If the user says "Malaysia" →

   malaysia

   ; "Taiwan (China)" →

   taiwan_china

   ; "Indonesia" →

   indonesia

   , etc.
2. Keyword Search:

   keyword

   is the title keyword, paired with

   keywordType

   to control the matching mode (1=Exact phrase match, 2=Multi-word AND, 3=Multi-word OR)
3. Numeric Ranges: Most filtering conditions use Start/End or Min/Max paired parameters; set one-sided or two-sided as needed
4. Sorting:

   orderBy

   specifies the sorting field,

   orderByType

   specifies ascending/descending order (default DESC descending order)
5. Pagination:

   page

   starts from 1,

   pageSize

   ranges from 1-1000, default is 1000
6. Exclusion Logic:

   notExistKeyword

   can exclude products containing specific words,

   notExistShopIdList

   can exclude specific stores

1. Present data only: Show query results in clear tables without subjective business advice
2. Currency notice: Different marketplaces use different currencies (MYR, TWD, IDR, THB, PHP, SGD, VND, BRL, MXN, CLP, COP). Always remind users of the currency context when showing price/payment data
3. Volume notice: When results are large, show core data (title, price, sold (sales volume in last 30 days), payment (sales revenue in last 30 days), rating) and remind users they can view more via pagination
4. Key metrics highlight: Prioritize showing

   sold

   (sales volume in last 30 days),

   payment

   (sales revenue in last 30 days),

   price

   ,

   rating

   as these are the most decision-relevant metrics
5. Error handling: When a query fails, explain the reason based on the error response and suggest adjusting query criteria
6. Image display: When

   imageUrl

   is available, include product images to help users make visual assessments

• Result cap:

  pageSize

  maximum is 1000 records per request
• Required field:

  station

  is always required — if missing, ask the user which marketplace to query
• Price currency: Prices are in local currency of the selected marketplace, not USD
• Data freshness: Data depends on YouYing's crawling schedule, see

  lastModiTime

  for last update time

• Product search on other platforms such as Amazon, TikTok, eBay, 1688, etc.
• Shopee advertising strategy
• Shopee store operation suggestions
• Shopee logistics/warehousing solutions
• Processing of existing local Shopee data files

Users will pay fees based on point consumption. Please fully evaluate: when this skill needs to be called frequently, or when users have insufficient expectations about point consumption, be sure to remind users and let them decide whether to continue.

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

references/api.md