mcpField
L
linkfox-shopee-store-video

linkfox-shopee-store-video

github.com/linkfox-aiマーケティング・グロース113229 回インストール2 週間前に更新
リポジトリ

linkfox-shopee-store-video について

Shopeeの店舗運営者向けに、動画の公開、管理、パフォーマンス分析を行うスキルです。店舗選択には linkfox-shopee-store-auth が必要で、サーバー側プロキシ経由でShopee APIを呼び出します。

主な機能

  1. 01カバー選択と動画投稿
  2. 02動画の取得、編集、削除
  3. 03動画全体の実績確認
  4. 04個別動画の指標分析
  5. 05視聴者と商品の実績確認

活用シーン

  1. 01カバーを選んで店舗動画を投稿
  2. 02動画の公開結果を確認
  3. 03動画全体の実績と推移を確認
  4. 04個別動画の視聴者と商品指標を分析

MCP 対応

LinkFoxゲートウェイのMCP機能を通じてShopee Video APIにアクセスします。developerProxyが店舗識別子に基づいてリクエストを転送し、サーバー側でトークンを処理します。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/linkfox-ai/linkfox-skills --skill linkfox-shopee-store-video

インストール後、Claude Code で/linkfox-shopee-store-videoを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
api.md
onboarding.md
references/apis/
delete-video.md
edit-video-info.md
get-cover-list.md
get-metric-trend.md
get-overview-performance.md
get-prodcut-performance-list.md
get-user-demographics.md
get-video-detail-audience-distribution.md
get-video-detail-metric-trend.md
get-video-detail-performance.md
get-video-detail-product-performance.md
get-video-detail.md
get-video-list.md
get-video-performance-list.md
post-video.md
scripts/
_shopee_video_common.py
_video_api_runner.py
_video_endpoints.py
check_auth_dependency.py
delete_video.py
edit_video_info.py
get_cover_list.py
get_metric_trend.py
get_overview_performance.py
get_prodcut_performance_list.py
get_user_demographics.py
get_video_detail_audience_distribution.py
get_video_detail_metric_trend.py

詳細

Shopee 店铺 Video

Shopee Open Platform Video 模块（15 个 API）。依赖 linkfox-shopee-store-auth 选店；经 POST /shopee/developerProxy 传入 shopId（或 merchantId），由服务端解析 token 转发（path 须 api/v2/video/...）。

调用方式

  • API 端点：POST /shopee/developerProxy（不同操作通过请求体区分；完整参数/响应/错误码见 references/api.md）
  • Python 脚本：python scripts/<脚本名>.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（同样落盘）

读数据建议：先看摘要判断是否足够；需要具体字段时优先用 jq或ConvertFrom-Json 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。

解决认证和算力问题

发生以下异常情况时，采用 references/onboarding.md 引导解决问题：

异常情况
  • 未配置API Key：环境变量未配置 LINKFOX_AGENT_API_KEY，也未配置 LINKFOXAGENT_API_KEY。
  • 响应401或402状态码
  • 响应提示算力或余额不足：消息含"算力余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值"，或类似含义的内容。

官方参考

Video 模块索引：v2.video.get_cover_list

Prerequisites（必须先读）

  1. 运行 python scripts/check_auth_dependency.py；exit code 42 → 先安装 linkfox-shopee-store-auth 并授权店铺。
  2. 不要在本 skill 内实现授权/令牌逻辑。

Core Concepts

  • 转发链路：developerProxy（shopId/merchantId 选店，服务端注入 token）→ 紫鸟 shopee-proxy → Shopee API
  • 视频管理：get_cover_list → post_video → get_video_list / edit_video_info
  • 效果分析：get_overview_performance、get_video_detail_performance 等
  • 官方拼写：get_prodcut_performance_list（product 为 prodcut）
  • 直播 Livestream（module 不同）→ linkfox-shopee-store-livestream

可用脚本（Video 模块 15 个 API）

分组脚本
视频 CRUDget_cover_list.py、post_video.py、get_video_list.py、get_video_detail.py、edit_video_info.py、delete_video.py
整体效果get_overview_performance.py、get_metric_trend.py、get_user_demographics.py、get_video_performance_list.py、get_prodcut_performance_list.py
单视频效果get_video_detail_performance.py、get_video_detail_metric_trend.py、get_video_detail_audience_distribution.py、get_video_detail_product_performance.py
通用入口video_api.py（JSON 含 api 字段）

共享：_shopee_video_common.py、_video_endpoints.py、_video_api_runner.py。

インターフェース仕様（API 別）

入出力の詳細は references/apis/ にあり、SKILL にはインデックスのみを記載しています。

API説明ドキュメント
delete_videoreferences/apis/delete-video.md
edit_video_inforeferences/apis/edit-video-info.md
get_cover_listreferences/apis/get-cover-list.md
get_metric_trendreferences/apis/get-metric-trend.md
get_overview_performancereferences/apis/get-overview-performance.md
get_prodcut_performance_listreferences/apis/get-prodcut-performance-list.md
get_user_demographicsreferences/apis/get-user-demographics.md
get_video_detailreferences/apis/get-video-detail.md
get_video_detail_audience_distributionreferences/apis/get-video-detail-audience-distribution.md
get_video_detail_metric_trendreferences/apis/get-video-detail-metric-trend.md
get_video_detail_performancereferences/apis/get-video-detail-performance.md
get_video_detail_product_performancereferences/apis/get-video-detail-product-performance.md
get_video_listreferences/apis/get-video-list.md
get_video_performance_listreferences/apis/get-video-performance-list.md
post_videoreferences/apis/post-video.md

モジュールの概要／フィードバックについては references/api.md をご覧ください。

使用シナリオ

1. 動画を公開する
  1. get_cover_list.py でカバーを選択
  2. post_video.py に完全な body を渡す
  3. get_video_list.py で公開を確認
2. 動画のパフォーマンスを確認する
  1. get_video_list.py で video_id を取得
  2. get_video_detail_performance.py で個別動画のパフォーマンスを確認
  3. get_overview_performance.py で全体の概要を確認

呼び出し原則

  • まず developerProxy.httpStatus を確認してから、*Response フィールドを読み取ります
  • GET：ビジネスパラメーターは JSON のトップレベルに設定します
  • POST：複雑なインターフェースには body を渡します
  • 各スクリプトの docstring に 公式ドキュメントの URL が含まれています（module=129）

対象外

  • ショップの認証 → linkfox-shopee-store-auth
  • 商品リスティング → linkfox-shopee-store-product
  • ライブ配信 Livestream → linkfox-shopee-store-livestream
  • 動画ファイルのアップロード（MediaSpace）→ linkfox-shopee-store-media-space
  • 動画ファイルのアップロード（Media）→ linkfox-shopee-store-media

計算リソース消費ルール

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

フィードバック：

以下のいずれかに該当する場合、Feedback API を通じてフィードバックを自動検出し、報告してください。

  1. このスキルで説明されている機能または目的が、実際の動作と一致しない
  2. スキルの結果がユーザーの意図と一致しない
  3. ユーザーがこのスキルへの不満または称賛を表明する
  4. 改善できると思われる点がある

references/api.md に記載されているとおりに Feedback API を呼び出してください。ユーザーの作業を中断しないでください。

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

コメント

Markdown 対応