mcpField
L
linkfox-shopee-store-payment

linkfox-shopee-store-payment

github.com/linkfox-aiその他113228 回インストール2 週間前に更新
リポジトリ

linkfox-shopee-store-payment について

Shopee Open PlatformのPayment APIを扱うスクリプトを提供するエージェントスキルです。店舗のエスクロー、振込、ウォレット、収入レポートを照会できます。店舗認証用スキルに依存し、developerProxy経由でリクエストを転送します。

主な機能

  1. 01注文のエスクローと精算明細を照会
  2. 02振込とウォレット取引を確認
  3. 03収入レポートを生成して取得
  4. 04分割払い状態を照会または設定
  5. 05支払い方法を一覧表示
  6. 06完全なレスポンスをJSONに保存

活用シーン

  1. 01注文の精算明細を確認
  2. 02振込情報とウォレット取引を照合
  3. 03収入レポートを生成して取得

インストール

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

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

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

同梱ファイル

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

references/
api.md
onboarding.md
references/apis/
generate-income-report.md
generate-income-statement.md
get-billing-transaction-info.md
get-escrow-detail-batch.md
get-escrow-detail.md
get-escrow-list.md
get-income-detail.md
get-income-overview.md
get-income-report.md
get-income-statement.md
get-item-installment-status.md
get-payment-method-list.md
get-payout-detail.md
get-payout-info.md
get-shop-installment-status.md
get-wallet-transaction-list.md
set-item-installment-status.md
set-shop-installment-status.md
scripts/
_payment_api_runner.py
_payment_endpoints.py
_shopee_payment_common.py
check_auth_dependency.py
generate_income_report.py
generate_income_statement.py
get_billing_transaction_info.py
get_escrow_detail_batch.py
get_escrow_detail.py
get_escrow_list.py

詳細

Shopee 店铺 Payment

Shopee Open Platform Payment 模块（18 个 API）。依赖 linkfox-shopee-store-auth 选店；经 POST /shopee/developerProxy 传入 shopId（或 merchantId），由服务端解析 token 转发（path 须 api/v2/payment/...）。

调用方式

  • 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（同样落盘）

读数据建议：先看摘要判断是否足够；需要具体字段时优先用 jq或ConvertFrom-Json 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。

解决认证和算力问题

发生以下异常情况时，采用 references/onboarding.md 引导解决问题：

异常情况
  • 未配置API Key：环境变量未配置 LINKFOX_AGENT_API_KEY，也未配置 LINKFOXAGENT_API_KEY。
  • 响应401或402状态码
  • 响应提示算力或余额不足：消息含"算力余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值"，或类似含义的内容。

官方参考

Payment 模块索引：v2.payment.get_escrow_detail

Prerequisites（必须先读）

  1. 运行 python scripts/check_auth_dependency.py；exit code 42 → 先安装 linkfox-shopee-store-auth 并授权店铺。
  2. 不要在本 skill 内实现授权/令牌逻辑。

Core Concepts

  • 转发链路：developerProxy（shopId/merchantId 选店，服务端注入 token）→ 紫鸟 shopee-proxy → Shopee API
  • Escrow：订单托管/结算明细 → get_escrow_detail（需 order_sn）
  • Payout：打款 → get_payout_detail、get_payout_info
  • 钱包：get_wallet_transaction_list
  • 收入报表：generate_income_* 异步生成 → get_income_* 获取结果
  • 订单查询 → linkfox-shopee-store-orders；本 skill 负责资金/结算

可用脚本（Payment 模块 18 个 API）

分组脚本
托管/结算get_escrow_detail.py、get_escrow_list.py、get_escrow_detail_batch.py
打款/钱包get_payout_detail.py、get_payout_info.py、get_wallet_transaction_list.py、get_billing_transaction_info.py
分期get_shop_installment_status.py、set_shop_installment_status.py、get_item_installment_status.py、set_item_installment_status.py
收入报表generate_income_statement.py、get_income_statement.py、generate_income_report.py、get_income_report.py、get_income_overview.py、get_income_detail.py
其他get_payment_method_list.py
通用入口payment_api.py（JSON 含 api 字段）

共享：_shopee_payment_common.py、_payment_endpoints.py、_payment_api_runner.py。

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

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

API説明ドキュメント
generate_income_reportreferences/apis/generate-income-report.md
generate_income_statementreferences/apis/generate-income-statement.md
get_billing_transaction_inforeferences/apis/get-billing-transaction-info.md
get_escrow_detailreferences/apis/get-escrow-detail.md
get_escrow_detail_batchreferences/apis/get-escrow-detail-batch.md
get_escrow_listreferences/apis/get-escrow-list.md
get_income_detailreferences/apis/get-income-detail.md
get_income_overviewreferences/apis/get-income-overview.md
get_income_reportreferences/apis/get-income-report.md
get_income_statementreferences/apis/get-income-statement.md
get_item_installment_statusreferences/apis/get-item-installment-status.md
get_payment_method_listreferences/apis/get-payment-method-list.md
get_payout_detailreferences/apis/get-payout-detail.md
get_payout_inforeferences/apis/get-payout-info.md
get_shop_installment_statusreferences/apis/get-shop-installment-status.md
get_wallet_transaction_listreferences/apis/get-wallet-transaction-list.md
set_item_installment_statusreferences/apis/set-item-installment-status.md
set_shop_installment_statusreferences/apis/set-shop-installment-status.md

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

使用シナリオ

1. 注文の精算明細を確認する
  1. orders スキルで order_sn を取得します
  2. get_escrow_detail.py：order_sn
2. 入金とウォレットを確認する
  • get_payout_detail.py / get_payout_info.py
  • get_wallet_transaction_list.py
3. 収入レポート
  1. generate_income_report.py または generate_income_statement.py
  2. get_income_report.py / get_income_statement.py で結果を取得します

呼び出しの原則

  • 先に developerProxy.httpStatus を確認し、その後 *Response フィールドを読み取ります
  • GET：業務パラメーターは JSON のトップレベルに設定します
  • POST：body またはトップレベルの body フィールドを渡します
  • 各スクリプトの docstring には 公式ドキュメントの URL（module=97）が含まれています

対象外

  • ショップの認証 → linkfox-shopee-store-auth
  • 注文の照会／処理 → linkfox-shopee-store-orders
  • プロモーションの Discount/Voucher など → Payment モジュールの対象外

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

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

フィードバック：

以下のいずれかに該当する場合は、Feedback API を通じてフィードバックを自動検出して報告してください。

  1. このスキルで説明されている機能や目的が実際の動作と一致しない場合
  2. スキルの結果がユーザーの意図と一致しない場合
  3. ユーザーがこのスキルへの不満や称賛を表明した場合
  4. 改善できる点があると思われる場合

references/api.md の指定に従って Feedback API を呼び出してください。ユーザーの作業を中断しないでください。

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

コメント

Markdown 対応