Shopee Open Platform Video module(15 APIs).Depends on linkfox-shopee-store-auth store selection; via POST /shopee/developerProxy pass in shopId(or merchantId), the server parses the token and forwards (path must be api/v2/video/...)。
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/<脚本名>.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, paginate, or repeatedly probe; if you need to continue searching, first explain to the user that it will incur additional consumption.
Output strategy (default script 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 according to the user's 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 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, the length of the largest list field + the 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 to use 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 situations
- API Key not configured: the environment variable is not configured with
LINKFOX_AGENT_API_KEY, andLINKFOXAGENT_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 a similar meaning.
Official reference
Video module index:v2.video.get_cover_list
Prerequisites (must read first)
- Run
python scripts/check_auth_dependency.py;exit code 42 → first installlinkfox-shopee-store-authand authorize the store. - Do notimplement authorization/token logic within this skill.
Core Concepts
- Forwarding chain:
developerProxy(shopId/merchantIdstore selection, server injects token) → Ziniaoshopee-proxy→ Shopee API - Video management:
get_cover_list→post_video→get_video_list/edit_video_info - Performance analysis:
get_overview_performance、get_video_detail_performanceetc. - Official spelling:
get_prodcut_performance_list(product is prodcut) - Livestream Livestream(module differs) →
linkfox-shopee-store-livestream
Available scripts (Video module 15 APIs)
| Group | Script |
|---|---|
| Video CRUD | get_cover_list.py、post_video.py、get_video_list.py、get_video_detail.py、edit_video_info.py、delete_video.py |
| Overall performance | get_overview_performance.py、get_metric_trend.py、get_user_demographics.py、get_video_performance_list.py、get_prodcut_performance_list.py |
| Single video performance | get_video_detail_performance.py、get_video_detail_metric_trend.py、get_video_detail_audience_distribution.py、get_video_detail_product_performance.py |
| Generic entry | video_api.py(JSON contains api field) |
Shared:_shopee_video_common.py、_video_endpoints.py、_video_api_runner.py。
API Description (by API)
Request parameters and response details are placed in references/apis/, the SKILL only keeps the index.
| API | Documentation |
|---|---|
delete_video |
references/apis/delete-video.md |
edit_video_info |
references/apis/edit-video-info.md |
get_cover_list |
references/apis/get-cover-list.md |
get_metric_trend |
references/apis/get-metric-trend.md |
get_overview_performance |
references/apis/get-overview-performance.md |
get_prodcut_performance_list |
references/apis/get-prodcut-performance-list.md |
get_user_demographics |
references/apis/get-user-demographics.md |
get_video_detail |
references/apis/get-video-detail.md |
get_video_detail_audience_distribution |
references/apis/get-video-detail-audience-distribution.md |
get_video_detail_metric_trend |
references/apis/get-video-detail-metric-trend.md |
get_video_detail_performance |
references/apis/get-video-detail-performance.md |
get_video_detail_product_performance |
references/apis/get-video-detail-product-performance.md |
get_video_list |
references/apis/get-video-list.md |
get_video_performance_list |
references/apis/get-video-performance-list.md |
post_video |
references/apis/post-video.md |
Module overview / Feedback see references/api.md。
Usage Scenarios
1. Publish video
get_cover_list.pySelect coverpost_video.pyUpload completebodyget_video_list.pyConfirm publish
2. Check video performance
get_video_list.pyGetvideo_idget_video_detail_performance.pyCheck single video performanceget_overview_performance.pyCheck overall overview
Invocation principles
- First look at
developerProxy.httpStatus, then read the*Responsefields - GET: business parameters go at the top level of JSON
- POST: complex interfaces pass
body - Each script docstring contains official documentation URL(
module=129)
Not Applicable
- Shop authorization →
linkfox-shopee-store-auth - Product listing →
linkfox-shopee-store-product - Livestream →
linkfox-shopee-store-livestream - Video file upload (MediaSpace) →
linkfox-shopee-store-media-space - Video file upload (Media) →
linkfox-shopee-store-media
Compute power consumption rules
No compute power is consumed.
Feedback:
Auto-detect and report feedback via the Feedback API when any of the following apply:
- The functionality or purpose described in this skill does not match actual behavior
- The skill's results do not match the user's intent
- The user expresses dissatisfaction or praise about this skill
- Anything you believe could be improved
Call the feedback API as specified in references/api.md. Do not interrupt the user's flow.
For more high-quality, professional cross-border e-commerce skills, visit LinkFox Skills.