linkfox-shopee-store-top-picks

Shopee Selected Products Top Picks

Shopee Open Platform Top Picks module(4 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/top_picks/...）。

How to call

API endpoint：POST /shopee/developerProxy(different operations are distinguished via 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, page, or probe repeatedly; if you need to continue searching, 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/<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 by user 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 only outputs a summary (top-level fields, common counts such as total/costToken, the length of the largest list field + first 3 samples)
Add --inline to force full printing to stdout (also written to disk)

Data reading recommendations: 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 putting the entire JSON into context.

Resolve authentication and compute issues

When the following abnormal situations occur, use references/onboarding.md to guide 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 similar meaning content.

Official reference

Top Picks module index:v2.top_picks.get_top_picks_list

Prerequisites

Run python scripts/check_auth_dependency.py；exit code 42 → first install linkfox-shopee-store-auth。
Promotional activities (Discount / Voucher / Flash Sale etc.) → corresponding promotion skill.

Available scripts (4 APIs)

Script	API	Method
`get_top_picks_list.py`	get_top_picks_list	GET
`add_top_picks.py`	add_top_picks	POST
`update_top_picks.py`	update_top_picks	POST
`delete_top_picks.py`	delete_top_picks	POST
`top_picks_api.py`	General entry point	—

Interface description (by API)

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

API	Description document
`add_top_picks`	references/apis/add-top-picks.md
`delete_top_picks`	references/apis/delete-top-picks.md
`get_top_picks_list`	references/apis/get-top-picks-list.md
`update_top_picks`	references/apis/update-top-picks.md

Module overview / Feedback see references/api.md。

Usage Scenarios

1. Manage selected product collections

get_top_picks_list.py view existing collections
add_top_picks.py create a new collection
update_top_picks.py / delete_top_picks.py update or delete

Not Applicable

Store authorization → linkfox-shopee-store-auth
Product listing → linkfox-shopee-store-product
Store category Shop Category → linkfox-shopee-store-shop-category
Promotions Discount / Voucher / Follow Prize etc. → corresponding promotion skill

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.