mcpField
L
linkfox-shopee-store-voucher

linkfox-shopee-store-voucher

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

linkfox-shopee-store-voucher について

Shopee Open PlatformのVoucherモジュールで店舗クーポンを管理するスキルです。店舗選択には`linkfox-shopee-store-auth`が必要で、クーポンの作成、照会、更新、終了に使うスクリプトを提供します。

主な機能

  1. 01クーポンの作成
  2. 02クーポン一覧と詳細の取得
  3. 03クーポンの更新または終了
  4. 04クーポンの削除
  5. 05完全なレスポンスの保存と出力量の調整

活用シーン

  1. 01クーポンを作成しキャンペーン一覧を確認
  2. 02既存クーポンを更新
  3. 03クーポンを終了または削除

MCP 対応

入力にはMCPとの関係について記載がありません。

インストール

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

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

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

同梱ファイル

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

references/
api.md
onboarding.md
references/apis/
add-voucher.md
delete-voucher.md
end-voucher.md
get-voucher-list.md
get-voucher.md
update-voucher.md
scripts/
_shopee_voucher_common.py
_voucher_api_runner.py
_voucher_endpoints.py
add_voucher.py
check_auth_dependency.py
delete_voucher.py
end_voucher.py
get_voucher_list.py
get_voucher.py
onboarding.py
update_voucher.py
voucher_api.py

詳細

Shopee ショップクーポン Voucher

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

呼び出し方法

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

出力ポリシー（スクリプトのデフォルト動作）：

  • 必ず完全なレスポンスを <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-shopee-store-voucher-<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／プランの期限切れ／チャージが必要／チャージしてください」、または同様の意味の内容が含まれています。

公式リファレンス

Voucher モジュールのインデックス：v2.voucher.add_voucher

前提条件

  1. python scripts/check_auth_dependency.py を実行します。exit code が 42 の場合は、先に linkfox-shopee-store-auth をインストールしてください。
  2. その他のプロモーション：Discount → linkfox-shopee-store-discount；Bundle Deal → linkfox-shopee-store-bundle-deal；Add-On Deal → linkfox-shopee-store-add-on-deal；Shop Flash Sale → linkfox-shopee-store-shop-flash-sale。

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

スクリプトAPIMethod
add_voucher.pyadd_voucherPOST
delete_voucher.pydelete_voucherPOST
end_voucher.pyend_voucherPOST
update_voucher.pyupdate_voucherPOST
get_voucher.pyget_voucherGET
get_voucher_list.pyget_voucher_listGET
voucher_api.py汎用エントリーポイント—

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

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

API説明ドキュメント
add_voucherreferences/apis/add-voucher.md
delete_voucherreferences/apis/delete-voucher.md
end_voucherreferences/apis/end-voucher.md
get_voucherreferences/apis/get-voucher.md
get_voucher_listreferences/apis/get-voucher-list.md
update_voucherreferences/apis/update-voucher.md

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

使用シナリオ

1. クーポンの作成と管理
  1. add_voucher.py に完全な body を渡します
  2. get_voucher_list.py でキャンペーン一覧を確認します
  3. update_voucher.py ／ end_voucher.py で更新または終了します

対象外

  • ショップの認証 → linkfox-shopee-store-auth
  • 期間限定割引 Discount → linkfox-shopee-store-discount
  • セット割引 Bundle Deal → linkfox-shopee-store-bundle-deal
  • 追加購入割引 Add-On Deal → linkfox-shopee-store-add-on-deal
  • 商品 listing → linkfox-shopee-store-product

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

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

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

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

コメント

Markdown 対応