linkfox-shopee-store-merchant

Shopee Merchant

Shopee Open Platform Merchant module(6 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/merchant/...）。

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 see the script list above)
Cost constraint: this tool consumes compute; on failure/empty results do not automatically switch keywords, paginate, or repeatedly probe; if you need to continue searching, first explain to the user that additional consumption will be incurred.

Output strategy (script default behavior)：

Alwayswrite the complete 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, if the current directory is not writable then report an error)
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, length of the largest list field + first 3 samples)
Add --inline to force full printing to stdout (also written 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 bringing the entire JSON into context.

Resolve authentication and compute issues

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

Abnormal situations

API Key not configured: the environment variable is not configured LINKFOX_AGENT_API_KEY, and 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/package expired/recharge required/please recharge", or content with a similar meaning.

Official reference

Merchant module index:v2.merchant.get_merchant_info

Prerequisites (must read first)

Run python scripts/check_auth_dependency.py；exit code 42 → first install linkfox-shopee-store-auth and authorize.
Do notimplement authorization/token logic within this skill.
Merchant is amerchant-level API, must pass merchantId; mainly aimed atcross-border sellers。

Core Concepts

Forwarding chain：developerProxy（shopId/merchantId store selection, server injects token) → ZiNiao shopee-proxy → Shopee API
Merchant vs store: this skill queries merchant information and its subordinate stores; for single-store profile see linkfox-shopee-store-shop
Global products: for global listings under a merchant see linkfox-shopee-store-global-product
Typical usage：get_merchant_info confirm region/currency → get_shop_list_by_merchant list authorized stores

Available scripts (Merchant module 6 APIs)

Script	API	Method
`get_merchant_info.py`	get_merchant_info	GET
`get_shop_list_by_merchant.py`	get_shop_list_by_merchant	GET
`get_merchant_warehouse_location_list.py`	get_merchant_warehouse_location_list	GET
`get_merchant_warehouse_list.py`	get_merchant_warehouse_list	GET
`get_warehouse_eligible_shop_list.py`	get_warehouse_eligible_shop_list	GET
`get_merchant_prepaid_account_list.py`	get_merchant_prepaid_account_list	GET
`merchant_api.py`	Generic entry (JSON contains `api` field)	—

Shared:_shopee_merchant_common.py、_merchant_endpoints.py、_merchant_api_runner.py。

Interface description (by API)

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

API	Documentation
`get_merchant_info`	references/apis/get-merchant-info.md
`get_merchant_prepaid_account_list`	references/apis/get-merchant-prepaid-account-list.md
`get_merchant_warehouse_list`	references/apis/get-merchant-warehouse-list.md
`get_merchant_warehouse_location_list`	references/apis/get-merchant-warehouse-location-list.md
`get_shop_list_by_merchant`	references/apis/get-shop-list-by-merchant.md
`get_warehouse_eligible_shop_list`	references/apis/get-warehouse-eligible-shop-list.md

Module overview / Feedback see references/api.md。

Usage Scenarios

1. Query merchant information and subordinate shops

auth skill locates merchantId
get_merchant_info.py: name, region, currency, authorization expiration
get_shop_list_by_merchant.py：page_no=1、page_size=100

2. Warehouse and prepaid account

get_merchant_warehouse_list.py / get_merchant_warehouse_location_list.py
get_warehouse_eligible_shop_list.py
get_merchant_prepaid_account_list.py

Invocation principles

First look at developerProxy.httpStatus, then read the *Response field
GET: business parameters go at the top level of the JSON (runner assembles queryString)
Each script docstring contains the official documentation URL（module=93）

Not Applicable

Shop authorization → linkfox-shopee-store-auth
single-shop information → linkfox-shopee-store-shop
global products → linkfox-shopee-store-global-product
single-shop listing → linkfox-shopee-store-product
orders → linkfox-shopee-store-orders
Public module (get_merchants_by_partner , etc.) → not this skill

Compute power consumption rules

No compute power 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.