Shopee Open Platform Media module(6 APIs,api/v2/media/...,module=130)。Depends on linkfox-shopee-store-auth store selection; via POST /shopee/developerProxy passed in shopId(or merchantId), the server parses the token and forwards.
How to call
- API endpoint:
POST /shopee/developerProxy(different operations are distinguished by the request body; for complete parameters/responses/error codes seereferences/api.md) - Python script:
python scripts/media_api.py '<JSON 参数>' [--inline](available scripts see the script list above) - Cost constraints: This tool consumes compute; on failure/empty results do not automatically change keywords, paginate, or repeatedly probe; if you need to continue searching, first explain to the user that it will incur additional consumption.
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 variableSESSION_ID, automatically aggregated by user task;Do not write to /tmp, 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, length of the largest list field + first 3 samples) - Add
--inlineto 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 putting 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 configuredLINKFOXAGENT_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
Media module index:v2.media.upload_image
Media vs MediaSpace
| Skill | path prefix | module |
|---|---|---|
This skill linkfox-shopee-store-media |
api/v2/media/... |
130 |
linkfox-shopee-store-media-space |
api/v2/media_space/... |
91 |
The interface names are the same (upload_image、init_video_upload etc.), but the path prefix is different. Please select the corresponding skill according to the LinkFox gateway whitelist.
Prerequisites
- Run
python scripts/check_auth_dependency.py;exit code 42 → first installlinkfox-shopee-store-auth。 - Do notimplement authorization/token logic within this skill.
Available scripts (6 APIs)
| Script | API | Method |
|---|---|---|
upload_image.py |
upload_image | POST |
init_video_upload.py |
init_video_upload | POST |
upload_video_part.py |
upload_video_part | POST |
complete_video_upload.py |
complete_video_upload | POST |
get_video_upload_result.py |
get_video_upload_result | GET |
cancel_video_upload.py |
cancel_video_upload | POST |
media_api.py |
General entry point | — |
Interface description (by API)
Input parameters and response details are placed in references/apis/, the SKILL only keeps the index.
| API | Description document |
|---|---|
cancel_video_upload |
references/apis/cancel-video-upload.md |
complete_video_upload |
references/apis/complete-video-upload.md |
get_video_upload_result |
references/apis/get-video-upload-result.md |
init_video_upload |
references/apis/init-video-upload.md |
upload_image |
references/apis/upload-image.md |
upload_video_part |
references/apis/upload-video-part.md |
For module overview / Feedback see references/api.md。
Usage Scenarios
Upload image
upload_image.py → get Shopee image URL → used for linkfox-shopee-store-product the add_item
Chunked video upload
init_video_upload → upload_video_part(×N) → complete_video_upload → get_video_upload_result
Not Applicable
- Store authorization →
linkfox-shopee-store-auth - MediaSpace(
api/v2/media_space/...)→linkfox-shopee-store-media-space - Video publishing/performance →
linkfox-shopee-store-video
Compute power consumption rules
Does not consume compute power.
Feedback: See references/api.md。
For more high-quality, professional cross-border e-commerce skills, visit LinkFox Skills.