mcpField
L
linkfox-temu-returns-refunds-us

linkfox-temu-returns-refunds-us

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

linkfox-temu-returns-refunds-us について

Temu米国の出店者向けの返品・返金スキルです。LinkFoxゲートウェイからPartnerのアフターサービスAPIを呼び出し、申請照会や返品住所・ラベルの処理を行います。

主な機能

  1. 019種類の返品・返金API呼び出し
  2. 02アフターサービス一覧と詳細の照会
  3. 03返品注文と住所の取得
  4. 04返品ラベルの準備とアップロード
  5. 05配送業者と署名情報の照会

活用シーン

  1. 01アフターサービス申請と詳細の確認
  2. 02返品に必要な住所情報の取得
  3. 03返品ラベルの準備またはアップロード
  4. 04返品時の配送業者情報の確認

インストール

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

$npx skills add https://github.com/linkfox-ai/linkfox-skills --skill linkfox-temu-returns-refunds-us

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

同梱ファイル

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

references/
access-token.md
api.md
authorization-flow.md
onboarding.md
partner-us-catalog.md
references/apis/
bg-aftersales-aftersales-list-get.md
bg-aftersales-parentaftersales-list-get.md
bg-aftersales-parentreturnorder-get.md
README.md
temu-aftersales-carrier-get.md
temu-aftersales-parentaftersales-detail-get.md
temu-aftersales-returnaddress-get.md
temu-aftersales-returnlabel-prepare-get.md
temu-aftersales-signature-get.md
temu-aftersales-upload-returnlabel.md
scripts/
_temu_auth_guide.py
_temu_common.py
_temu_token_store.py
_temu_us_common.py
_us_returns_refunds_script.py
check_linkfox_token.py
get_temu_access_token.py
list_temu_access_tokens.py
onboarding.py
save_temu_access_token.py
temu_file_download.py
temu_proxy.py
temu_token_guide.py
temu_us_file_download.py
temu_us_proxy.py

詳細

Temu 米国サイト — 返品・返金（Returns & Refunds）

このスキル（linkfox-temu-returns-refunds-us）は、Partner Platform for US の Returns & Refunds / EC返品・返金（および関連する After-sales の返品・返金カテゴリ）に関する bg.* / temu.* インターフェースを対象とします（menu_code と各 sub_menu_code は Partner の管理画面に従います。partner-us-catalog.md を参照してください）。

Partner の Return and Refund インターフェース 9 件に対応しています。一覧は partner-us-catalog.md を参照してください。

ゲートウェイ（このスキルに組み込み済み）：

機能メソッドパス
返品・返金 OpenAPI（us_returns_refunds_*、temu_us_proxy）POSThttps://tool-gateway.linkfox.com/temu/proxy
署名付きファイルのダウンロードPOSThttps://tool-gateway.linkfox.com/temu/fileDownload

関連スキル

シナリオスキル
返品・返金（このスキル）linkfox-temu-returns-refunds-us
購入者による注文キャンセル（返品・返金の全プロセス以外）linkfox-temu-cancel-order-us
販売者による注文キャンセル／在庫切れによるキャンセル／異議申し立てlinkfox-temu-cancel-order-us
注文一覧／詳細／金額／アフターサービスのコンテキストlinkfox-temu-order-us
商品管理linkfox-temu-manage-product-us
フルフィルメント／発送linkfox-temu-fulfillment-us
ゲートウェイと Temu トークンこのスキルの scripts/

呼び出し方法

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

出力方針（スクリプトのデフォルト動作）：

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

デフォルトパラメーター

フィールドデフォルト説明
siteusPartner US
managementTypesemi-managed半セルフマネージド（具体的なインターフェースは Partner のドキュメントに従います）
tokenPurposeorder-shipping注文／アフターサービス用トークン（access-token.md を参照してください）

認証

  1. LinkFox：LINKFOXAGENT_API_KEY → Header Authorization + Token
  2. Temu：accessToken または storeKey（storeKey の場合は tokenPurpose=order-shipping の指定を推奨します）

スクリプト

スクリプト説明
temu_us_proxy.py任意の type を汎用転送
temu_us_file_download.py署名付きファイルのダウンロード
us_returns_refunds_aftersales_parentaftersales_list_get.pybg.aftersales.parentaftersales.list.get
us_returns_refunds_aftersales_aftersales_list_get.pybg.aftersales.aftersales.list.get
us_returns_refunds_aftersales_parentaftersales_detail_get.pytemu.aftersales.parentaftersales.detail.get
us_returns_refunds_aftersales_parentreturnorder_get.pybg.aftersales.parentreturnorder.get
us_returns_refunds_aftersales_returnaddress_get.pytemu.aftersales.returnaddress.get
us_returns_refunds_aftersales_returnlabel_prepare_get.pytemu.aftersales.returnlabel.prepare.get
us_returns_refunds_aftersales_signature_get.pytemu.aftersales.signature.get
us_returns_refunds_aftersales_upload_returnlabel.pytemu.aftersales.upload.returnlabel
us_returns_refunds_aftersales_carrier_get.pytemu.aftersales.carrier.get

インターフェースの追加（取り決め）

Partner のドキュメント（type + sub_menu_code + URL + Request/Response パラメーターテーブル）を 1 件提供するごとに、次の対応を行います。

  1. references/apis/<type-slug>.md を新規作成します（入力／出力の階層をすべて記載）
  2. scripts/us_returns_refunds_<slug>.py を新規作成します（_us_returns_refunds_script.run_cli を呼び出します）
  3. partner-us-catalog.md、apis/README.md、およびこの表を更新します

例（汎用プロキシ）

export LINKFOXAGENT_API_KEY="<key>"

python scripts/temu_us_proxy.py '{
  "accessToken": "TOKEN",
  "tokenPurpose": "order-shipping",
  "type": "<TEMU_API_TYPE>",
  "params": {
    "request": {}
  }
}'

フィードバック： skillName：linkfox-temu-returns-refunds-us

网关与授权脚本

脚本说明
check_linkfox_token.py校验 LinkFox 用户 Token
temu_token_guide.pyTemu accessToken 后台授权步骤
save_temu_access_token.py保存 accessToken 到本地
list_temu_access_tokens.py列出已保存 token
get_temu_access_token.py读取已保存 token
temu_proxy.py通用网关转发（多 site）
temu_file_download.py加签文件下载（多 site）

授权说明：references/access-token.md

算力消耗规则

不消耗算力。

コメント

Markdown 対応