SuperAPI AI Directory
Partner with us中文AI newsFavorites
Skillslinkfox-shopee-store-shop

linkfox-shopee-store-shop

Coding & development

View repository

Updated 10-16 06:23

About this skill

Shopee Store Shop

Shopee Open Platform Shop module(9 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 api/v2/shop/...）。

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](for available scripts see the script list above)
  • Cost constraint: this tool consumes compute; on failure/empty results you must not automatically switch keywords, paginate, or make repeated probes; 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/<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, 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 the entire JSON entering 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

Shop module index:v2.shop.get_shop_info

Prerequisites (must 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 store selection, server injects token) → ZiNiao shopee-proxy → Shopee API
  • Information vs profile：get_shop_info returns region/status/authorization expiration etc.;get_profile returns store name/logo/description
  • Write operations：update_profile(store name can only be changed once every 30 days),set_shop_holiday_mode(after enabling, buyers cannot place orders)
  • Warehouse：get_warehouse_detail optional warehouse_type(1=pickup warehouse, 2=return warehouse)
  • Region restrictions：get_br_shop_onboarding_info Brazil site only

Available scripts (Shop module 9 APIs)

Script API Method
get_shop_info.py get_shop_info GET
get_profile.py get_profile GET
update_profile.py update_profile POST
get_warehouse_detail.py get_warehouse_detail GET
get_shop_notification.py get_shop_notification GET
get_authorised_reseller_brand.py get_authorised_reseller_brand GET
get_br_shop_onboarding_info.py get_br_shop_onboarding_info GET
get_shop_holiday_mode.py get_shop_holiday_mode GET
set_shop_holiday_mode.py set_shop_holiday_mode POST
shop_api.py Generic entry (JSON contains api field) —

Shared:_shopee_shop_common.py、_shop_endpoints.py、_shop_api_runner.py. For input, see references/apis/。

Interface description (by API)

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

API Documentation
get_authorised_reseller_brand references/apis/get-authorised-reseller-brand.md
get_br_shop_onboarding_info references/apis/get-br-shop-onboarding-info.md
get_profile references/apis/get-profile.md
get_shop_holiday_mode references/apis/get-shop-holiday-mode.md
get_shop_info references/apis/get-shop-info.md
get_shop_notification references/apis/get-shop-notification.md
get_warehouse_detail references/apis/get-warehouse-detail.md
set_shop_holiday_mode references/apis/set-shop-holiday-mode.md
update_profile references/apis/update-profile.md

For module overview / Feedback, see references/api.md。

Usage Scenarios

1. View basic shop information

  1. auth skill locates shopId
  2. get_shop_info.py：region、status（NORMAL/BANNED/FROZEN）、expire_time
  3. Optional get_profile.py: shop name, logo, description

2. Update shop profile

update_profile.py pass shop_name / shop_logo / description at least one item (logo must be a Shopee image URL)

3. Holiday mode

  1. get_shop_holiday_mode.py check current status
  2. set_shop_holiday_mode.py pass holiday_mode_on: true/false

4. Warehouse and notifications

  • Warehouse:get_warehouse_detail.py(optional warehouse_type=1|2）
  • Seller notifications:get_shop_notification.py（page_size maximum 50,cursor pagination)
  • Authorized brands:get_authorised_reseller_brand.py(required page_no、page_size ≤30）

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: pass body or top-level body fields
  • Each script docstring contains the official documentation URL（module=92）

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
  • Product listing → linkfox-shopee-store-product
  • Shop Category → linkfox-shopee-store-shop-category
  • Account Health → linkfox-shopee-store-account-health
  • Cross-border global products → linkfox-shopee-store-global-product

Computing power consumption rules

Does not consume computing power.

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.