Shopee Open Platform GlobalProduct module(34 APIs).Depends on linkfox-shopee-store-auth store selection; via POST /shopee/developerProxy pass in shopId(or merchantId), the server parses the token and forwards (path must be api/v2/global_product/...）。
How to call
- API endpoint：
POST /shopee/developerProxy(different operations are distinguished by the request body; for full parameters/responses/error codes seereferences/api.md） - Python script：
python scripts/global_product_api.py '<JSON 参数>' [--inline](available scripts are listed in the script overview above) - Cost constraint: This tool consumes compute; on failure/empty results you must not automatically switch keywords, turn pages, or repeatedly probe; if you need to continue searching, first explain to the user that it will incur extra consumption.
Output strategy (default script behavior)：
- Alwayswrite the full response to
<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-shopee-store-global-product-<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 variableSESSION_ID, aggregated automatically according to the user's task;Writing to /tmp is prohibited, if the current directory is not writable then report an error) - Response body ≤ 8 KB: after writing to disk, print the full JSON to stdout
- Response body > 8 KB: after writing to disk, stdout outputs only a summary (top-level fields, common counts such as
total/costToken, the length of the largest list field + the first 3 samples) - Add
--inlineto force full printing to stdout (also written to disk)
Data reading advice: First look at the summary to judge whether it is sufficient; when specific fields are needed, prefer jqorConvertFrom-Json to extract as needed from the saved json file, avoiding putting the entire JSON into context.
Resolving authentication and compute issues
When the following abnormal situations occur, use references/onboarding.md to guide resolution:
Abnormal situations
- API Key not configured: the environment variable is not configured with
LINKFOX_AGENT_API_KEY, nor is it configured withLINKFOXAGENT_API_KEY。 - Response has 401 or 402 status code
- Response indicates insufficient compute or balance: the message contains "insufficient compute balance/insufficient billing/insufficient balance/quota exceeded/insufficient balance/plan expired/recharge required/please recharge", or content with a similar meaning.
Official reference
GlobalProduct module index:v2.global_product.get_category
Prerequisites (must read first)
- Run
python scripts/check_auth_dependency.py；exit code 42 → first installlinkfox-shopee-store-authand authorize. - Do notimplement authorization/token logic within this skill.
- GlobalProduct is amerchant-level API, usually passing
merchantId; publish/mapping-type interfaces may also requireshopId。
Core Concepts
- Forwarding chain：
developerProxy（shopId/merchantIdstore selection, the server injects the token) → ZiNiaoshopee-proxy→ Shopee API - Product vs GlobalProduct：
linkfox-shopee-store-productmanages single-store listing; this skill managescross-border global productsand publishing to each site - Typical flow：
get_category→get_attribute_tree→add_global_item→create_publish_task→get_publish_task_result - SKU：
init_tier_variation/get_global_model_list/add_global_modeletc. - Local store products(non-global) →
linkfox-shopee-store-product
Available scripts (GlobalProduct module 34 APIs)
| Group | Script |
|---|---|
| Category/Attribute | get_category.py、get_attribute_tree.py、get_brand_list.py、category_recommend.py、get_recommend_attribute.py、search_global_attribute_value_list.py |
| Global Product CRUD | get_global_item_list.py、get_global_item_info.py、add_global_item.py、update_global_item.py、delete_global_item.py、get_global_item_limit.py |
| Global SKU | get_global_model_list.py、init_tier_variation.py、update_tier_variation.py、add_global_model.py、update_global_model.py、delete_global_model.py |
| Price/Inventory/Sync | update_price.py、update_stock.py、set_sync_field.py、get_local_adjustment_rate.py、update_local_adjustment_rate.py |
| Publish to Site | create_publish_task.py、get_publishable_shop.py、get_publish_task_result.py、get_published_list.py、get_shop_publishable_status.py、get_global_item_id.py |
| Size Chart/Specifications | support_size_chart.py、update_size_chart.py、get_size_chart_list.py、get_size_chart_detail.py、get_variations.py |
| General Entry | global_product_api.py(JSON includes api field) |
Shared:_shopee_global_product_common.py、_global_product_endpoints.py、_global_product_api_runner.py。
API Description (by API)
Request parameters and response details are placed in references/apis/. The SKILL only keeps the index.
Module overview / Feedback see references/api.md。
Usage Scenarios
1. Create a global product and publish
get_category.py+get_attribute_tree.py（merchantId）add_global_item.pypass the completebodycreate_publish_task.pypublish to the target siteget_publish_task_result.pycheck the publish result
2. Query global products and modify inventory
get_global_item_list.py：offset、page_sizeget_global_item_info.py：global_item_id_listupdate_stock.py/update_price.py：POSTbody
Calling Principles
- First check
developerProxy.httpStatus, then read the*Responsefield - GET: business parameters go at the top level of the JSON (runner constructs the queryString)
- POST: for complex APIs pass
body; for simple APIs you can pass top-level body fields - Each script docstring contains official documentation URL（
module=90）
Not Applicable
- Shop authorization →
linkfox-shopee-store-auth - Merchant information →
linkfox-shopee-store-merchant - Single-shop listing →
linkfox-shopee-store-product - Orders →
linkfox-shopee-store-orders - Shop information →
linkfox-shopee-store-shop - Image/Video upload → MediaSpace module
Computing Power Consumption Rules
No computing power is consumed.
Feedback:
Auto-detect and report feedback via the Feedback API when any of the following apply:
- The functionality or purpose described in this skill does not match actual behavior
- The skill's results do not match the user's intent
- The user expresses dissatisfaction or praise about this skill
- 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.