SuperAPI AI Directory

linkfox-shopee-store-fbs

Coding & development

View repository

Updated 10-16 00:00

About this skill

Shopee FBS Brazil warehousing

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 see references/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 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, the length of the largest list field + the 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 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, 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

FBS module index:v2.fbs.query_br_shop_enrollment_status


Prerequisites

  1. Run python scripts/check_auth_dependency.py;exit code 42 → first install linkfox-shopee-store-auth。
  2. 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

  1. query_br_shop_enrollment_status.py onboarding status
  2. query_br_shop_block_status.py store ban
  3. query_br_sku_block_status.py SKU 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.