SuperAPI AI Directory

linkfox-shopee-store-media

Marketing & growth

View repository

Updated 10-16 00:00

About this skill

Shopee Media Media

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 see references/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 variable SESSION_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 --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 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 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

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

  1. Run python scripts/check_auth_dependency.py;exit code 42 → first install linkfox-shopee-store-auth。
  2. 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.