mcpField
L
linkfox-shopee-store-shop-category

linkfox-shopee-store-shop-category

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

linkfox-shopee-store-shop-category について

Shopee Open Platformのショップカテゴリを管理するスキルです。ショップ運営者向けにカテゴリと商品を操作でき、ショップ認証には `linkfox-shopee-store-auth` を利用し、APIリクエストをサーバー側プロキシ経由で転送します。

主な機能

  1. 01ショップカテゴリの作成と更新
  2. 02カテゴリ一覧の取得と削除
  3. 03カテゴリへの商品追加
  4. 04カテゴリ商品の取得と削除
  5. 057つのShop Category APIに対応

活用シーン

  1. 01Shopeeショップの商品カテゴリを整備
  2. 02既存カテゴリへの商品の追加
  3. 03カテゴリと商品一覧の確認
  4. 04ショップカテゴリの更新や削除

MCP 対応

入力にはMCP機能についての記載がありません。

インストール

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

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

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

同梱ファイル

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

references/
api.md
onboarding.md
references/apis/
add-item-list.md
add-shop-category.md
delete-item-list.md
delete-shop-category.md
get-item-list.md
get-shop-category-list.md
update-shop-category.md
scripts/
_shop_category_api_runner.py
_shop_category_endpoints.py
_shopee_shop_category_common.py
add_item_list.py
add_shop_category.py
check_auth_dependency.py
delete_item_list.py
delete_shop_category.py
get_item_list.py
get_shop_category_list.py
onboarding.py
shop_category_api.py
update_shop_category.py

詳細

Shopee ショップカテゴリ

Shopee Open Platform のショップカテゴリモジュール（7 個の API）です。linkfox-shopee-store-auth に依存してショップを選択します。POST /shopee/developerProxy を介して shopId（または merchantId）を渡すと、サーバー側でトークンを解析して転送します（path は api/v2/shop_category/... である必要があります）。

呼び出し方法

  • 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 全体をコンテキストに読み込むのを避けるため、保存した json ファイルから jq または ConvertFrom-Json を使って必要な部分を抽出してください。

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

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

異常な状況
  • API Key が未設定：環境変数 LINKFOX_AGENT_API_KEY も LINKFOXAGENT_API_KEY も設定されていません。
  • レスポンスのステータスコードが 401 または 402
  • 計算リソースまたは残高不足を示すレスポンス：メッセージに「算力余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值」または同様の意味の内容が含まれている場合。

公式リファレンス

ショップカテゴリモジュールのインデックス：v2.shop_category.add_shop_category

前提条件

  1. python scripts/check_auth_dependency.py を実行します。exit code が 42 の場合は、先に linkfox-shopee-store-auth をインストールしてください。
  2. 商品 listing → linkfox-shopee-store-product、精选 Top Picks → linkfox-shopee-store-top-picks。

利用可能なスクリプト（7 個の API）

スクリプトAPIMethod
add_shop_category.pyadd_shop_categoryPOST
get_shop_category_list.pyget_shop_category_listGET
delete_shop_category.pydelete_shop_categoryPOST
update_shop_category.pyupdate_shop_categoryPOST
add_item_list.pyadd_item_listPOST
get_item_list.pyget_item_listGET
delete_item_list.pydelete_item_listPOST
shop_category_api.py共通エントリーポイント—

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

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

API説明ドキュメント
add_item_listreferences/apis/add-item-list.md
add_shop_categoryreferences/apis/add-shop-category.md
delete_item_listreferences/apis/delete-item-list.md
delete_shop_categoryreferences/apis/delete-shop-category.md
get_item_listreferences/apis/get-item-list.md
get_shop_category_listreferences/apis/get-shop-category-list.md
update_shop_categoryreferences/apis/update-shop-category.md

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

使用シナリオ

1. ショップカテゴリを管理する
  1. add_shop_category.py でカテゴリを作成します
  2. add_item_list.py で商品を追加します
  3. get_shop_category_list.py ／ get_item_list.py でカテゴリと商品を確認します

対象外

  • ショップ認証 → linkfox-shopee-store-auth
  • 商品 listing CRUD → linkfox-shopee-store-product
  • 精选 Top Picks → linkfox-shopee-store-top-picks
  • ショップの基本情報 → linkfox-shopee-store-shop

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

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

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

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

コメント

Markdown 対応