linkfox-shopee-store-media

Shopee メディア Media

Shopee Open Platform のMedia モジュール（6 個の API、api/v2/media/...、module=130）です。linkfox-shopee-store-auth に依存して店舗を選択します。POST /shopee/developerProxy に shopId（または merchantId）を渡すと、サーバーがトークンを解析して転送します。

呼び出し方法

• API エンドポイント：POST /shopee/developerProxy（操作ごとにリクエストボディで区別します。パラメーター／レスポンス／エラーコードの詳細は references/api.md を参照してください）
• Python スクリプト：python scripts/media_api.py '<JSON 参数>' [--inline]（使用可能なスクリプトは上記のスクリプト一覧を参照してください）
• コスト制約：このツールは計算リソースを消費します。失敗や空の結果が返った場合、自動的にキーワードを変更したり、ページをめくったり、連続して試行したりしてはいけません。検索を続ける必要がある場合は、追加の消費が発生することを先にユーザーに説明してください。

出力方針（スクリプトのデフォルト動作）：

• 常に完全なレスポンスを <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/<skill-name>-<timestamp>.json に書き込みます（<cwd> はスクリプト実行時の作業ディレクトリで、Claude Code では現在のプロジェクトディレクトリです。<session> は環境変数 SESSION_ID から取得し、ユーザーのタスクごとに自動でまとめます。/tmp への書き込みは禁止です。現在のディレクトリに書き込めない場合はエラーになります）
• レスポンスボディが 8 KB 以下の場合：ディスクに保存後、完全な JSON を stdout に出力します
• レスポンスボディが 8 KB を超える場合：ディスクに保存後、stdout には概要のみを出力します（トップレベルのフィールド、total／costToken などの一般的な件数、最大のリストフィールドの長さと先頭 3 件のサンプル）
• --inline を指定すると、stdout にすべて出力します（同様にディスクにも保存します）

データの読み取りに関する推奨事項：まず概要を確認して十分かどうかを判断してください。具体的なフィールドが必要な場合は、保存した json ファイルから jq または ConvertFrom-Json を使って必要なデータだけを抽出し、JSON 全体がコンテキストに入るのを避けてください。

認証と計算リソースの問題を解決する

以下の異常が発生した場合は、references/onboarding.md の案内に従って問題を解決してください。

異常の種類

• API Key が未設定：環境変数 LINKFOX_AGENT_API_KEY と LINKFOXAGENT_API_KEY のどちらも設定されていません。
• レスポンスのステータスコードが 401 または 402
• 計算リソースまたは残高不足を示すレスポンス：メッセージに「計算リソース残高不足／課金不足／残高不足／quota exceeded／insufficient balance／プランの有効期限切れ／チャージが必要／チャージしてください」または同様の意味の内容が含まれています。

公式リファレンス

Media モジュールのインデックス：v2.media.upload_image

---

Media と MediaSpace の違い

Skill	path プレフィックス	module
本 skill linkfox-shopee-store-media	api/v2/media/...	130
linkfox-shopee-store-media-space	api/v2/media_space/...	91

インターフェース名（upload_image、init_video_upload など）は同じですが、path プレフィックスが異なります。LinkFox ゲートウェイのホワイトリストに応じて、適切な skill を選択してください。

---

前提条件

1. python scripts/check_auth_dependency.py を実行します。終了コードが 42 の場合は、先に linkfox-shopee-store-auth をインストールしてください。
2. 本 skill 内で認証／トークンのロジックを実装しないでください。

使用可能なスクリプト（6 個の API）

スクリプト	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	汎用エントリーポイント	—

インターフェースの説明（API 別）

パラメーターとレスポンスの詳細は references/apis/ に記載しています。SKILL にはインデックスのみを残しています。

API	説明ドキュメント
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

モジュールの概要／Feedback は references/api.md を参照してください。

使用シナリオ

画像をアップロードする

upload_image.py → Shopee の画像 URL を取得 → linkfox-shopee-store-product の add_item で使用

動画を分割アップロードする

init_video_upload → upload_video_part(×N) → complete_video_upload → get_video_upload_result

対象外

• 店舗認証 → linkfox-shopee-store-auth
• MediaSpace（api/v2/media_space/...）→ linkfox-shopee-store-media-space
• 動画の投稿／効果 → linkfox-shopee-store-video

計算リソースの消費ルール

計算リソースは消費しません。

Feedback: references/api.md を参照してください。

---

高品質でプロフェッショナルな越境 EC スキルについては、LinkFox Skills をご覧ください。