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

linkfox-shopee-store-shop-category

Coding & development

View repository

Updated 10-16 00:00

About this skill

Shopee Shop Category

Shopee Open Platform Shop Category module(7 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/shop_category/...）。

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, 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 problem resolution:

Abnormal situation

  • API Key not configured: the environment variable is not configured with 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 Category module index:v2.shop_category.add_shop_category

Prerequisites

  1. Run python scripts/check_auth_dependency.py；exit code 42 → first install linkfox-shopee-store-auth。
  2. Product listing → linkfox-shopee-store-product; Top Picks → linkfox-shopee-store-top-picks。

Available scripts (7 APIs)

Script API Method
add_shop_category.py add_shop_category POST
get_shop_category_list.py get_shop_category_list GET
delete_shop_category.py delete_shop_category POST
update_shop_category.py update_shop_category POST
add_item_list.py add_item_list POST
get_item_list.py get_item_list GET
delete_item_list.py delete_item_list POST
shop_category_api.py General entry —

Interface description (by API)

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

API Documentation
add_item_list references/apis/add-item-list.md
add_shop_category references/apis/add-shop-category.md
delete_item_list references/apis/delete-item-list.md
delete_shop_category references/apis/delete-shop-category.md
get_item_list references/apis/get-item-list.md
get_shop_category_list references/apis/get-shop-category-list.md
update_shop_category references/apis/update-shop-category.md

Module overview / Feedback see references/api.md。

Usage Scenarios

1. Manage shop categories

  1. add_shop_category.py Create category
  2. add_item_list.py Add product
  3. get_shop_category_list.py / get_item_list.py View categories and products

Not Applicable

  • Shop authorization → linkfox-shopee-store-auth
  • Product listing CRUD → linkfox-shopee-store-product
  • Top Picks → linkfox-shopee-store-top-picks
  • Shop basic information → linkfox-shopee-store-shop

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.