mcpField
L
linkfox-shopee-store-top-picks

linkfox-shopee-store-top-picks

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

linkfox-shopee-store-top-picks について

Shopee の店舗運営者向けに、Top Picks の商品セットを管理する LinkFox スキルです。一覧取得、作成、更新、削除に対応し、店舗選択には `linkfox-shopee-store-auth` が必要です。

主な機能

  1. 01Top Picks セットの取得
  2. 02Top Picks セットの作成
  3. 03セットの更新・削除
  4. 04Python スクリプトによる API 呼び出し

活用シーン

  1. 01店舗の既存 Top Picks セットの確認
  2. 02Top Picks セットの作成・調整

インストール

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

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

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

同梱ファイル

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

references/
api.md
onboarding.md
references/apis/
add-top-picks.md
delete-top-picks.md
get-top-picks-list.md
update-top-picks.md
scripts/
_shopee_top_picks_common.py
_top_picks_api_runner.py
_top_picks_endpoints.py
add_top_picks.py
check_auth_dependency.py
delete_top_picks.py
get_top_picks_list.py
onboarding.py
top_picks_api.py
update_top_picks.py

詳細

Shopee おすすめ商品 Top Picks

Shopee Open Platform の Top Picks モジュール（4 個の API）です。linkfox-shopee-store-auth に依存して店舗を選択します。POST /shopee/developerProxy 経由で shopId（または merchantId）を渡すと、サーバーがトークンを解決して転送します（path は api/v2/top_picks/... を指定する必要があります）。

呼び出し方法

  • 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 に全量を強制出力します（同様にファイルにも保存します）

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

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

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

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

公式リファレンス

Top Picks モジュールのインデックス：v2.top_picks.get_top_picks_list

前提条件

  1. python scripts/check_auth_dependency.py を実行します。exit code が 42 の場合は、先に linkfox-shopee-store-auth をインストールしてください。
  2. プロモーション関連のキャンペーン（Discount / Voucher / Flash Sale など）には、対応するプロモーション skill が必要です。

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

スクリプトAPIMethod
get_top_picks_list.pyget_top_picks_listGET
add_top_picks.pyadd_top_picksPOST
update_top_picks.pyupdate_top_picksPOST
delete_top_picks.pydelete_top_picksPOST
top_picks_api.py汎用エントリーポイント—

API ごとのインターフェース説明

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

API説明ドキュメント
add_top_picksreferences/apis/add-top-picks.md
delete_top_picksreferences/apis/delete-top-picks.md
get_top_picks_listreferences/apis/get-top-picks-list.md
update_top_picksreferences/apis/update-top-picks.md

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

使用シナリオ

1. おすすめ商品セットを管理する
  1. get_top_picks_list.py で既存のセットを確認します
  2. add_top_picks.py で新しいセットを作成します
  3. update_top_picks.py / delete_top_picks.py で更新または削除します

対象外

  • 店舗の認証 → linkfox-shopee-store-auth
  • 商品 listing → linkfox-shopee-store-product
  • 店舗カテゴリ Shop Category → linkfox-shopee-store-shop-category
  • プロモーション Discount / Voucher / Follow Prize など → 対応するプロモーション skill

計算リソース消費ルール

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

フィードバック： references/api.md を参照してください。

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

コメント

Markdown 対応