linkfox-shopee-store-top-picks

Original：🇨🇳 Chinese

Translated

10 scriptsChecked / no sensitive code detected

Shopee Top Picks (part of the same series as linkfox-shopee-store-auth), which forwards all 4 interfaces of the Shopee Open API Top Picks module via /shopee/developerProxy: get_top_picks_list, add_top_picks, update_top_picks, delete_top_picks. Triggered when the user mentions Shopee Top Picks, Top Picks, store featured items, add_top_picks, top_picks_id, or hot recommendations. It should also be triggered even if "featured" is not explicitly mentioned, as long as it involves the management of Top Picks collections for authorized Shopee stores.

4installs

Sourcelinkfox-ai/linkfox-skills

Added on2026-08-15

NPX Install

npx skill4agent add linkfox-ai/linkfox-skills linkfox-shopee-store-top-picks

SKILL.md Content (Chinese)

View Translation Comparison →

Shopee Top Picks

Shopee Open Platform Top Picks Module (4 APIs). Depends on
linkfox-shopee-store-auth
for store selection; pass

shopId

(or

merchantId

) via POST /shopee/developerProxy
, and the server parses the token to forward the request (the

path

must be

api/v2/top_picks/...

).

Calling Methods

API Endpoint:
```
POST /shopee/developerProxy
```
(Different operations are distinguished by request body; see
```
references/api.md
```
for complete parameters/responses/error codes)
Python Script:
```
python scripts/<script-name>.py '<JSON parameters>' [--inline]
```
(Available scripts are listed in the script overview above)
Cost Constraints: This tool consumes points; do not automatically switch keywords, paginate, or continuously retry for failed/empty results; inform the user that additional costs will be incurred before continuing the retrieval.

Output Strategy (Default Script Behavior):

Always write the complete response to
```
<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/<skill-name>-<timestamp>.json
```
(
```
<cwd>
```
is the working directory where the script is executed, which is the current project directory in Claude Code;
```
<session>
```
is retrieved from the environment variable
```
SESSION_ID
```
and automatically aggregated by user tasks; Writing to /tmp is prohibited, report an error if the current directory is not writable)
Response body ≤ 8 KB: Print the complete JSON to stdout after saving to disk
Response body > 8 KB: Print only a summary to stdout after saving to disk (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 (still saves to disk)

Data Reading Suggestion: Check the summary first to see if it is sufficient; when specific fields are needed, use

jq

or

ConvertFrom-Json

to extract from the saved JSON file on demand, avoiding loading the entire JSON into the context.

Resolving Authentication and Point Issues

For the following abnormal situations, guide users to resolve them by following references/onboarding.md:

Abnormal Situations

API Key Not Configured: The environment variables
```
LINKFOX_AGENT_API_KEY
```
and
```
LINKFOXAGENT_API_KEY
```
are not configured.
Response returns 401 or 402 status code
Response indicates insufficient points or balance: The message contains "insufficient points balance/insufficient billing/insufficient balance/quota exceeded/insufficient balance/package expired/need to recharge/please recharge" or similar meanings.

Official References

Top Picks Module Index: v2.top_picks.get_top_picks_list

Prerequisites

Run

python scripts/check_auth_dependency.py

; if the exit code is 42 → install linkfox-shopee-store-auth
first.

Promotional activities (Discount / Voucher / Flash Sale, etc.) → use the 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	—

Interface Description (By API)

Details of input parameters and responses are stored in

references/apis/

, only the index is retained in the SKILL.

API	Documentation
`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 can be found in references/api.md.

Usage Scenarios

1. Manage Top Picks Collections

Use
```
get_top_picks_list.py
```
to view existing collections
Use
```
add_top_picks.py
```
to create new collections
Use
```
update_top_picks.py
```
/
```
delete_top_picks.py
```
to update or delete collections

Not Applicable

Store authorization →
```
linkfox-shopee-store-auth
```
Product listing →
```
linkfox-shopee-store-product
```
Shop Category →
```
linkfox-shopee-store-shop-category
```
Promotions such as Discount / Voucher / Follow Prize → use the corresponding promotion skill

Point Consumption Rules

No points are consumed.

Feedback: See

references/api.md

.

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