mcpField
L
linkfox-shopee-store-public

linkfox-shopee-store-public

github.com/linkfox-ai開発113226 回インストール2 週間前に更新
リポジトリ

linkfox-shopee-store-public について

Shopee Open Platformの連携開発者向けスキルです。Partner情報の照会、OAuthトークン操作、IP範囲の取得をdeveloperProxy経由で行います。

主な機能

  1. 01Partner配下のショップとマーチャントの一覧取得
  2. 02アクセストークンの取得と更新
  3. 03再送コードによるトークン取得
  4. 04ShopeeプラットフォームのIP範囲取得
  5. 05PythonスクリプトによるAPI呼び出し

活用シーン

  1. 01Partnerに認証されたショップやマーチャントの一覧化
  2. 02OAuthアクセストークンの交換や更新
  3. 03Shopee Open PlatformのIP許可リスト設定

インストール

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

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

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

同梱ファイル

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

references/
api.md
onboarding.md
references/apis/
get-access-token.md
get-merchants-by-partner.md
get-shopee-ip-ranges.md
get-shops-by-partner.md
get-token-by-resend-code.md
refresh-access-token.md
scripts/
_public_api_runner.py
_public_endpoints.py
_shopee_public_common.py
check_auth_dependency.py
get_access_token.py
get_merchants_by_partner.py
get_shopee_ip_ranges.py
get_shops_by_partner.py
get_token_by_resend_code.py
onboarding.py
public_api.py
refresh_access_token.py

詳細

Shopee Public 公開モジュール

Shopee Open Platform のPublic モジュール（API 6 件）。同シリーズの前提として linkfox-shopee-store-auth に依存します。一部のインターフェースは Partner レベルまたは OAuth レベルで、POST /shopee/developerProxy 経由で転送します（path は api/v2/public/... にする必要があります）。

呼び出し方法

  • 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／プランの期限切れ／チャージが必要／チャージしてください」、または同様の意味の内容が含まれている場合。

公式リファレンス

Public モジュールの索引：v2.public.get_shops_by_partner

前提条件

  1. python scripts/check_auth_dependency.py を実行します。exit code が 42 の場合は、先に linkfox-shopee-store-auth をインストールしてください。
  2. 通常の認可／認可済み店舗／token の読み取りには、優先して linkfox-shopee-store-auth を使用してください（authorize_url.py／authorized_stores.py／store_tokens.py）。

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

スクリプトAPIMethod
get_shops_by_partner.pyget_shops_by_partnerGET
get_merchants_by_partner.pyget_merchants_by_partnerGET
get_access_token.pyget_access_tokenPOST
refresh_access_token.pyrefresh_access_tokenPOST
get_token_by_resend_code.pyget_token_by_resend_codePOST
get_shopee_ip_ranges.pyget_shopee_ip_rangesGET
public_api.py共通エントリーポイント—

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

入力パラメーターとレスポンスの詳細は references/apis/ に記載し、SKILL には索引のみを残しています。

API説明ドキュメント
get_access_tokenreferences/apis/get-access-token.md
get_merchants_by_partnerreferences/apis/get-merchants-by-partner.md
get_shopee_ip_rangesreferences/apis/get-shopee-ip-ranges.md
get_shops_by_partnerreferences/apis/get-shops-by-partner.md
get_token_by_resend_codereferences/apis/get-token-by-resend-code.md
refresh_access_tokenreferences/apis/refresh-access-token.md

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

使用シナリオ

1. Partner に紐づく認可済み店舗を確認する

get_shops_by_partner.py または get_merchants_by_partner.py

2. OAuth Token の交換（基盤となる公開インターフェース）

get_access_token.py／refresh_access_token.py に完全な POST body を渡します

3. IP ホワイトリストの設定

get_shopee_ip_ranges.py で Shopee Open Platform の IP 範囲を取得します

対象外

  • ユーザー側の認可フロー → linkfox-shopee-store-auth
  • 店舗業務 API（注文／商品／物流など）→ 対応する業務 skill
  • Push コールバックの設定 → linkfox-shopee-store-push

計算リソース消費ルール

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

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

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

コメント

Markdown 対応