linkfox-shopee-store-product

Shopee store Product

Shopee Open Platform Product module(57 APIs).Depends on linkfox-shopee-store-auth selecting a store; via POST /shopee/developerProxy pass in shopId(or merchantId), and the server parses the token and forwards (path must api/v2/product/...）。

How to call

• API endpoint：POST /shopee/developerProxy(different operations are distinguished by the request body; for complete parameters/responses/error codes see references/api.md）
• Python script：python scripts/<脚本名>.py '<JSON 参数>' [--inline](available scripts are listed in the script overview above)
• Cost constraints: This tool consumes compute; on failure/empty results you must not automatically switch keywords, page through, or repeatedly probe; if you need to continue searching, first explain to the user that it will incur additional cost.

Output strategy (default script behavior)：

• Alwayswrite the full response to <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/<skill-name>-<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, and an error will be reported if the current directory is not writable)
• Response body ≤ 8 KB: after writing to disk, print the complete 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 + first 3 samples)
• Add --inline to force full output to stdout (also written to disk)

Data reading suggestions: first look at the summary to determine 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 the 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 LINKFOX_AGENT_API_KEYis not configured, nor is LINKFOXAGENT_API_KEY。
• Response 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

Product module index:v2.product.get_category

---

Prerequisites (must be read first)

1. Run python scripts/check_auth_dependency.py；exit code 42 → first install linkfox-shopee-store-auth and authorize the store.
2. Do notimplement authorization/token logic within this skill.

---

Core Concepts

• Forwarding chain：developerProxy（shopId/merchantId select a store, server injects token) → ZiNiao shopee-proxy → Shopee API
• Listing process：get_category → get_attribute_tree → add_item(for complex bodies it is recommended to pass the body field)
• Daily operations：get_item_list / get_item_base_info query products;update_price / update_stock change price and inventory;unlist_item list/unlist
• SKU：init_tier_variation / get_model_list / add_model , etc.
• Product selection data(not store listing) → linkfox-youying-shopee-product-search(does not depend on auth)

Available scripts (57 APIs in the Product module)

Group	Script
Categories/Attributes/Brands	get_category.py、get_attribute_tree.py、get_brand_list.py、category_recommend.py、get_recommend_attribute.py、search_attribute_value_list.py
Product CRUD	get_item_list.py、get_item_base_info.py、get_item_extra_info.py、add_item.py、update_item.py、delete_item.py、unlist_item.py、search_item.py
SKU/Price/Stock	get_model_list.py、init_tier_variation.py、update_tier_variation.py、add_model.py、update_model.py、delete_model.py、update_price.py、update_stock.py
Promotion/Reviews	boost_item.py、get_boosted_list.py、get_item_promotion.py、get_comment.py、reply_comment.py
Extensions	Kit/SSP/Direct/Mart/Outlet, size chart, violations, vehicle compatibility, content diagnostics, etc. — see references/api.md full list
General entry	product_api.py(JSON contains api field)

Shared:_shopee_product_common.py、_product_endpoints.py、_product_api_runner.py。

API description (by API)

Request parameters and response details are in references/apis/, SKILL only keeps the index.

API	Documentation
add_item	references/apis/add-item.md
add_kit_item	references/apis/add-kit-item.md
add_model	references/apis/add-model.md
boost_item	references/apis/boost-item.md
category_recommend	references/apis/category-recommend.md
delete_item	references/apis/delete-item.md
delete_model	references/apis/delete-model.md
generate_kit_image	references/apis/generate-kit-image.md
get_aitem_by_pitem_id	references/apis/get-aitem-by-pitem-id.md
get_all_vehicle_list	references/apis/get-all-vehicle-list.md
get_attribute_tree	references/apis/get-attribute-tree.md
get_boosted_list	references/apis/get-boosted-list.md
get_brand_list	references/apis/get-brand-list.md
get_category	references/apis/get-category.md
get_comment	references/apis/get-comment.md
get_direct_item_list	references/apis/get-direct-item-list.md
get_direct_shop_recommended_price	references/apis/get-direct-shop-recommended-price.md
get_item_base_info	references/apis/get-item-base-info.md
get_item_content_diagnosis_result	references/apis/get-item-content-diagnosis-result.md
get_item_extra_info	references/apis/get-item-extra-info.md
get_item_limit	references/apis/get-item-limit.md
get_item_list	references/apis/get-item-list.md
get_item_list_by_content_diagnosis	references/apis/get-item-list-by-content-diagnosis.md
get_item_promotion	references/apis/get-item-promotion.md
get_item_violation_info	references/apis/get-item-violation-info.md
get_kit_item_info	references/apis/get-kit-item-info.md
get_kit_item_limit	references/apis/get-kit-item-limit.md
get_main_item_list	references/apis/get-main-item-list.md
get_mart_item_by_outlet_item_id	references/apis/get-mart-item-by-outlet-item-id.md
get_mart_item_mapping_by_id	references/apis/get-mart-item-mapping-by-id.md
get_model_list	references/apis/get-model-list.md
get_product_certification_rule	references/apis/get-product-certification-rule.md
get_recommend_attribute	references/apis/get-recommend-attribute.md
get_size_chart_detail	references/apis/get-size-chart-detail.md
get_size_chart_list	references/apis/get-size-chart-list.md
get_ssp_info	references/apis/get-ssp-info.md
get_ssp_list	references/apis/get-ssp-list.md
get_variations	references/apis/get-variations.md
get_vehicle_list_by_compatibility_detail	references/apis/get-vehicle-list-by-compatibility-detail.md
get_weight_recommendation	references/apis/get-weight-recommendation.md
init_tier_variation	references/apis/init-tier-variation.md
link_ssp	references/apis/link-ssp.md
publish_item_to_outlet_shop	references/apis/publish-item-to-outlet-shop.md
register_brand	references/apis/register-brand.md
reply_comment	references/apis/reply-comment.md
search_attribute_value_list	references/apis/search-attribute-value-list.md
search_item	references/apis/search-item.md
search_unpackaged_model_list	references/apis/search-unpackaged-model-list.md
unlink_ssp	references/apis/unlink-ssp.md
unlist_item	references/apis/unlist-item.md
update_item	references/apis/update-item.md
update_kit_item	references/apis/update-kit-item.md
update_model	references/apis/update-model.md
update_price	references/apis/update-price.md
update_sip_item_price	references/apis/update-sip-item-price.md
update_stock	references/apis/update-stock.md
update_tier_variation	references/apis/update-tier-variation.md

Module overview / Feedback see references/api.md。

Usage Scenarios

1. Query categories and publish

1. get_category.py Get category tree
2. get_attribute_tree.py pass category_id to get required attributes
3. add_item.py pass complete body(including category_id, item_name, price, image, attribute_list, etc.)

2. Query products and update stock

1. get_item_list.py：offset、page_size、item_status
2. get_item_base_info.py：item_id_list
3. update_stock.py / update_price.py：POST body

3. Listing/delisting and promotion

• unlist_item.py: batch listing/delisting
• boost_item.py: pin to top (max 5)

Calling principles

• First look at developerProxy.httpStatus, then read the *Response field
• GET: business parameters go at the top level of JSON (runner assembles queryString)
• POST: for complex APIs pass body; for simple APIs you can pass top-level body fields or body
• Each script docstring contains the official documentation URL（module=89）

Not Applicable

• Shop authorization → linkfox-shopee-store-auth
• Merchant information → linkfox-shopee-store-merchant
• Orders → linkfox-shopee-store-orders
• Logistics shipping → linkfox-shopee-store-logistics
• Returns and refunds → linkfox-shopee-store-returns
• On-platform ads → linkfox-shopee-store-ads
• Payment settlement → linkfox-shopee-store-payment
• Affiliate marketing AMS → linkfox-shopee-store-ams
• Shop video → linkfox-shopee-store-video
• Shop information → linkfox-shopee-store-shop
• Cross-border global products → linkfox-shopee-store-global-product
• Discount promotions → linkfox-shopee-store-discount
• Bundle Deal → linkfox-shopee-store-bundle-deal
• Add-On Deal → linkfox-shopee-store-add-on-deal
• Shop Voucher → linkfox-shopee-store-voucher
• Shop Flash Sale → linkfox-shopee-store-shop-flash-sale
• Follow Prize → linkfox-shopee-store-follow-prize
• Top Picks → linkfox-shopee-store-top-picks
• Shop Category → linkfox-shopee-store-shop-category
• Account Health → linkfox-shopee-store-account-health
• Cross-site product selection data → linkfox-youying-shopee-product-search
• Image/video upload (MediaSpace api/v2/media_space/...）→ linkfox-shopee-store-media-space
• Image/video upload (Media api/v2/media/...）→ linkfox-shopee-store-media

Compute consumption rules

No compute is consumed.

Feedback:

Auto-detect and report feedback via the Feedback API when any of the following apply:

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

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.