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

linkfox-shopee-store-shop-flash-sale

Coding & development

View repository

Updated 10-16 00:00

About this skill

Shopee Store Flash Sale

Shopee Open Platform Shop Flash Sale module(11 APIs).Depends on linkfox-shopee-store-auth for store selection; via POST /shopee/developerProxy pass in shopId(or merchantId), the server parses the token and forwards (path must be api/v2/shop_flash_sale/...）。

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, 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 (default script 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, 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 determine whether it is sufficient; when specific fields are needed, prefer using 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 problem resolution:

Abnormal situation

  • 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 Flash Sale module index:v2.shop_flash_sale.get_time_slot_id

Prerequisites

  1. Run python scripts/check_auth_dependency.py；exit code 42 → first install linkfox-shopee-store-auth。
  2. Other promotions: Discount / Bundle Deal / Voucher / Shop Flash Sale / Follow Prize → corresponding promotion skill.

Available scripts (11 APIs)

Script API Method
get_time_slot_id.py get_time_slot_id GET
create_shop_flash_sale.py create_shop_flash_sale POST
get_item_criteria.py get_item_criteria GET
add_shop_flash_sale_items.py add_shop_flash_sale_items POST
get_shop_flash_sale_list.py get_shop_flash_sale_list GET
get_shop_flash_sale.py get_shop_flash_sale GET
get_shop_flash_sale_items.py get_shop_flash_sale_items GET
update_shop_flash_sale.py update_shop_flash_sale POST
update_shop_flash_sale_items.py update_shop_flash_sale_items POST
delete_shop_flash_sale.py delete_shop_flash_sale POST
delete_shop_flash_sale_items.py delete_shop_flash_sale_items POST
shop_flash_sale_api.py General entry point —

Interface description (by API)

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

API Description document
add_shop_flash_sale_items references/apis/add-shop-flash-sale-items.md
create_shop_flash_sale references/apis/create-shop-flash-sale.md
delete_shop_flash_sale references/apis/delete-shop-flash-sale.md
delete_shop_flash_sale_items references/apis/delete-shop-flash-sale-items.md
get_item_criteria references/apis/get-item-criteria.md
get_shop_flash_sale references/apis/get-shop-flash-sale.md
get_shop_flash_sale_items references/apis/get-shop-flash-sale-items.md
get_shop_flash_sale_list references/apis/get-shop-flash-sale-list.md
get_time_slot_id references/apis/get-time-slot-id.md
update_shop_flash_sale references/apis/update-shop-flash-sale.md
update_shop_flash_sale_items references/apis/update-shop-flash-sale-items.md

Module overview / Feedback see references/api.md。

Usage Scenarios

1. Create store flash sale

  1. get_time_slot_id.py Get available time slots
  2. create_shop_flash_sale.py Create campaign
  3. add_shop_flash_sale_items.py Add products
  4. get_shop_flash_sale_list.py Confirm status

Not Applicable

  • Store authorization → linkfox-shopee-store-auth
  • Limited-time discount Discount → linkfox-shopee-store-discount
  • Voucher → linkfox-shopee-store-voucher
  • Product listing → linkfox-shopee-store-product

Compute consumption rules

Does not consume computing power.

Feedback: See references/api.md。

For more high-quality, professional cross-border e-commerce skills, visit LinkFox Skills.