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

linkfox-shopee-store-bundle-deal

Marketing & growth

View repository

Updated 10-16 09:58

About this skill

Shopee Bundle Deal

Shopee Open Platform Bundle Deal module(10 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/bundle_deal/...）。

How to call

  • API endpoint：POST /shopee/developerProxy(different operations are distinguished via the request body; for full 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 change keywords, paginate, or repeatedly probe; when further retrieval is needed, first explain to the user that it will incur additional consumption.

Output strategy (default script behavior)：

  • Alwayswrite the full response to <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-shopee-store-bundle-deal-<timestamp>.json（<cwd> is the working directory when the script runs, in Claude Code that is the current project directory;<session> is taken from the environment variable SESSION_ID, automatically aggregated by user 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 full JSON to stdout
  • Response body > 8 KB: after writing to disk, stdout only outputs 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 judge 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 resolving the issue:

Abnormal situation

  • API Key not configured: environment variable not configured LINKFOX_AGENT_API_KEY, and also not configured 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 similar meaning.

Official reference

Bundle Deal module index:v2.bundle_deal.add_bundle_deal

Prerequisites

  1. Run python scripts/check_auth_dependency.py；exit code 42 → first install linkfox-shopee-store-auth。
  2. Limited-time discount → linkfox-shopee-store-discount；Add-On Deal → linkfox-shopee-store-add-on-deal；Voucher → linkfox-shopee-store-voucher。

Available scripts (10 APIs)

Script API Method
add_bundle_deal.py add_bundle_deal POST
add_bundle_deal_item.py add_bundle_deal_item POST
get_bundle_deal_list.py get_bundle_deal_list GET
get_bundle_deal.py get_bundle_deal GET
get_bundle_deal_item.py get_bundle_deal_item GET
update_bundle_deal.py update_bundle_deal POST
update_bundle_deal_item.py update_bundle_deal_item POST
end_bundle_deal.py end_bundle_deal POST
delete_bundle_deal.py delete_bundle_deal POST
delete_bundle_deal_item.py delete_bundle_deal_item POST
bundle_deal_api.py Generic entry —

Interface description (by API)

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

API Documentation
add_bundle_deal references/apis/add-bundle-deal.md
add_bundle_deal_item references/apis/add-bundle-deal-item.md
delete_bundle_deal references/apis/delete-bundle-deal.md
delete_bundle_deal_item references/apis/delete-bundle-deal-item.md
end_bundle_deal references/apis/end-bundle-deal.md
get_bundle_deal references/apis/get-bundle-deal.md
get_bundle_deal_item references/apis/get-bundle-deal-item.md
get_bundle_deal_list references/apis/get-bundle-deal-list.md
update_bundle_deal references/apis/update-bundle-deal.md
update_bundle_deal_item references/apis/update-bundle-deal-item.md

Module overview / Feedback see references/api.md。

Usage Scenarios

1. Create bundle deal

  1. add_bundle_deal.py pass the full body
  2. add_bundle_deal_item.py add items
  3. get_bundle_deal_list.py confirm status

Not Applicable

  • Store authorization → linkfox-shopee-store-auth
  • Limited-time discount Discount → linkfox-shopee-store-discount
  • 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.