mcpField
L
linkfox-shopee-store-push

linkfox-shopee-store-push

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

linkfox-shopee-store-push について

Shopee Open Platformの連携開発者向けに、Pushコールバック設定と未受信メッセージの取得・確認を行うスキルです。

主な機能

  1. 01Push設定の登録と確認
  2. 02未受信Pushメッセージの取得
  3. 03未受信メッセージの消費確認
  4. 04PythonスクリプトによるAPI呼び出し

活用シーン

  1. 01コールバックURLの設定とPush設定の確認
  2. 02後続処理のための未受信メッセージ取得
  3. 03処理後の未受信メッセージ消費の確認

インストール

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

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

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

同梱ファイル

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

references/
api.md
onboarding.md
references/apis/
confirm-consumed-lost-push-message.md
get-app-push-config.md
get-lost-push-message.md
set-app-push-config.md
scripts/
_push_api_runner.py
_push_endpoints.py
_shopee_push_common.py
check_auth_dependency.py
confirm_consumed_lost_push_message.py
get_app_push_config.py
get_lost_push_message.py
onboarding.py
push_api.py
set_app_push_config.py

詳細

Shopee Push プッシュメカニズム

Shopee Open Platform の Push モジュール（4 つの API）です。同シリーズの前提条件として linkfox-shopee-store-auth に依存します。POST /shopee/developerProxy 経由で転送されます（path は api/v2/push/... である必要があります）。

呼び出し方法

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

公式リファレンス

Push モジュールのインデックス：v2.push.set_app_push_config

前提条件

  1. python scripts/check_auth_dependency.py を実行します。exit code が 42 の場合は、先に linkfox-shopee-store-auth をインストールしてください。
  2. OAuth／Partner 共通 API → linkfox-shopee-store-public。

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

スクリプトAPIMethod
set_app_push_config.pyset_app_push_configPOST
get_app_push_config.pyget_app_push_configGET
get_lost_push_message.pyget_lost_push_messageGET
confirm_consumed_lost_push_message.pyconfirm_consumed_lost_push_messagePOST
push_api.py共通エントリーポイント—

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

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

API説明ドキュメント
confirm_consumed_lost_push_messagereferences/apis/confirm-consumed-lost-push-message.md
get_app_push_configreferences/apis/get-app-push-config.md
get_lost_push_messagereferences/apis/get-lost-push-message.md
set_app_push_configreferences/apis/set-app-push-config.md

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

使用シナリオ

1. Push コールバックの設定
  1. set_app_push_config.py に完全な POST body（コールバック URL など）を渡します
  2. get_app_push_config.py で設定を確認します
2. 失われたメッセージの再プッシュ
  1. get_lost_push_message.py で失われたメッセージを取得します
  2. confirm_consumed_lost_push_message.py で消費済みであることを確認します

対象外

  • ユーザー側の認可フロー → linkfox-shopee-store-auth
  • Public OAuth／Partner の照会 → linkfox-shopee-store-public
  • 注文／商品などのビジネス API → 該当するビジネス skill

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

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

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

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

コメント

Markdown 対応