Shopee Open Platform FBS module(4 APIs, all GET, for Brazil BR).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/fbs/...)。
How to call
- API endpoint:
POST /shopee/developerProxy(different operations are distinguished by the request body; for complete parameters/responses/error codes seereferences/api.md) - Python script:
python scripts/<脚本名>.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, paginate, or repeatedly probe; if you need to continue searching, first explain to the user that it will incur additional consumption.
Output strategy (script default behavior):
- Alwayswrite the complete response to
<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-shopee-store-fbs-<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, 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, the length of the largest list field + the first 3 samples) - Add
--inlineto 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 the 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, andLINKFOXAGENT_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
FBS module index:v2.fbs.query_br_shop_enrollment_status
Prerequisites
- Run
python scripts/check_auth_dependency.py;exit code 42 → first installlinkfox-shopee-store-auth。 - General SBS warehousing →
linkfox-shopee-store-sbs; logistics →linkfox-shopee-store-logistics。
Available scripts (4 APIs)
| Script | API | Method |
|---|---|---|
query_br_shop_enrollment_status.py |
query_br_shop_enrollment_status | GET |
query_br_shop_invoice_error.py |
query_br_shop_invoice_error | GET |
query_br_shop_block_status.py |
query_br_shop_block_status | GET |
query_br_sku_block_status.py |
query_br_sku_block_status | GET |
fbs_api.py |
General entry point | — |
Interface description (by API)
Input parameters and response details are placed in references/apis/, the SKILL keeps only the index.
| API | Documentation |
|---|---|
query_br_shop_block_status |
references/apis/query-br-shop-block-status.md |
query_br_shop_enrollment_status |
references/apis/query-br-shop-enrollment-status.md |
query_br_shop_invoice_error |
references/apis/query-br-shop-invoice-error.md |
query_br_sku_block_status |
references/apis/query-br-sku-block-status.md |
For module overview / Feedback see references/api.md。
Usage Scenarios
1. Check Brazil FBS store status
query_br_shop_enrollment_status.pyonboarding statusquery_br_shop_block_status.pystore banquery_br_sku_block_status.pySKU ban
2. Troubleshoot invoice issues
query_br_shop_invoice_error.py Check invoice errors
Not Applicable
- Store authorization →
linkfox-shopee-store-auth - SBS general warehousing inventory →
linkfox-shopee-store-sbs - Logistics shipping →
linkfox-shopee-store-logistics - Product listing →
linkfox-shopee-store-product
Compute consumption rules
Does not consume compute.
Feedback: see references/api.md。
For more high-quality, professional cross-border e-commerce skills, visit LinkFox Skills.