mcpField
L
linkfox-shopee-store-follow-prize

linkfox-shopee-store-follow-prize

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

linkfox-shopee-store-follow-prize について

Shopee Open Platform でフォロー特典キャンペーンを作成、照会、更新、終了、削除するマーケティングスキルです。店舗選択には linkfox-shopee-store-auth が必要です。

主な機能

  1. 01フォロー特典キャンペーンの作成
  2. 02キャンペーン一覧と詳細の確認
  3. 03キャンペーンの更新・終了
  4. 04キャンペーンの削除

活用シーン

  1. 01店舗のフォロー特典キャンペーンを作成
  2. 02既存キャンペーンを確認
  3. 03内容を変更またはキャンペーンを終了

MCP 対応

エージェント向けのスキルであり、MCP インターフェースについての記載はありません。

インストール

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

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

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

同梱ファイル

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

references/
api.md
onboarding.md
references/apis/
add-follow-prize.md
delete-follow-prize.md
end-follow-prize.md
get-follow-prize-detail.md
get-follow-prize-list.md
update-follow-prize.md
scripts/
_follow_prize_api_runner.py
_follow_prize_endpoints.py
_shopee_follow_prize_common.py
add_follow_prize.py
check_auth_dependency.py
delete_follow_prize.py
end_follow_prize.py
follow_prize_api.py
get_follow_prize_detail.py
get_follow_prize_list.py
onboarding.py
update_follow_prize.py

詳細

Shopee フォロー特典 Follow Prize

Shopee Open Platform のフォロー特典モジュール（6 個の API）。店舗の選択には linkfox-shopee-store-auth が必要です。POST /shopee/developerProxy 経由で shopId（または merchantId）を渡すと、サーバー側でトークンを解析して転送します（path は api/v2/follow_prize/... である必要があります）。

呼び出し方法

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

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

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

公式リファレンス

Follow Prize モジュールのインデックス：v2.follow_prize.add_follow_prize

前提条件

  1. python scripts/check_auth_dependency.py を実行してください。exit code が 42 の場合は、先に linkfox-shopee-store-auth をインストールしてください。
  2. その他のプロモーション：Discount／Bundle Deal／Voucher／Shop Flash Sale → 対応するプロモーションスキルを使用してください。

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

スクリプトAPIMethod
add_follow_prize.pyadd_follow_prizePOST
delete_follow_prize.pydelete_follow_prizePOST
end_follow_prize.pyend_follow_prizePOST
update_follow_prize.pyupdate_follow_prizePOST
get_follow_prize_detail.pyget_follow_prize_detailGET
get_follow_prize_list.pyget_follow_prize_listGET
follow_prize_api.py汎用エントリーポイント—

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

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

API説明ドキュメント
add_follow_prizereferences/apis/add-follow-prize.md
delete_follow_prizereferences/apis/delete-follow-prize.md
end_follow_prizereferences/apis/end-follow-prize.md
get_follow_prize_detailreferences/apis/get-follow-prize-detail.md
get_follow_prize_listreferences/apis/get-follow-prize-list.md
update_follow_prizereferences/apis/update-follow-prize.md

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

利用シナリオ

1. フォロー特典キャンペーンを作成する
  1. add_follow_prize.py に完全な body を渡します
  2. get_follow_prize_list.py でキャンペーン一覧を確認します
  3. update_follow_prize.py／end_follow_prize.py で更新または終了します

対象外

  • 店舗の認証 → linkfox-shopee-store-auth
  • 期間限定割引 Discount → linkfox-shopee-store-discount
  • クーポン Voucher → linkfox-shopee-store-voucher
  • 店舗フラッシュセール Shop Flash Sale → linkfox-shopee-store-shop-flash-sale
  • 商品 listing → linkfox-shopee-store-product

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

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

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

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

コメント

Markdown 対応