linkfox-temu-price-eu

Temu 欧州サイト価格 API（linkfox-temu-price-eu）

米国サイトでは linkfox-temu-price-us を、グローバルサイト（US／EU 以外）では linkfox-temu-price-global を使用してください。

このスキル（linkfox-temu-price-eu）は、Partner Platform for EU の Price メニュー（menu_code=dfff38c23adf498d8a7cd55052bd3648）にある、価格／供給価格に関連する bg.local.*／temu.local.* インターフェイスを対象とします（type は US 版に合わせており、デフォルトは site=eu です）。

現在 4 個のインターフェイスを接続済みです。その他の価格インターフェイスは、Partner のドキュメントに従って references/apis/ と eu_price_*.py に順次追加します。

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

機能	メソッド	パス
価格 OpenAPI（eu_price_*、temu_eu_proxy）	POST	https://tool-gateway.linkfox.com/temu/proxy
署名付きファイルのダウンロード	POST	https://tool-gateway.linkfox.com/temu/fileDownload

関連スキル

シナリオ	スキル
商品一覧／詳細／編集／在庫／出品・出品停止	linkfox-temu-manage-product-eu
注文照会、発送、物流	linkfox-temu-order-us
注文キャンセル（購入者＋販売者）	linkfox-temu-cancel-order-us

| フルフィルメント／発送（自発送を含む） | linkfox-temu-fulfillment-eu | | 商品登録、カテゴリ、V2 add | linkfox-temu-add-product-us | | 半管理型 temu.goods.price.list.get（productSkuIds） | linkfox-temu-add-product-us → us_goods_price_list.py | | ゲートウェイと Temu トークン | このスキルの scripts/ |

呼び出し方法

• API エンドポイント：POST /temu/proxy（操作はリクエストボディで区別します。完全なパラメーター／レスポンス／エラーコードは 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 全体をコンテキストに取り込まないよう、保存された json ファイルから jq または ConvertFrom-Json を使って必要な部分を抽出することを優先してください。

認証と計算リソースの問題を解決する

以下の異常が発生した場合は、references/onboarding.md の案内に従って解決してください。

異常な状況

• API Key が未設定：環境変数 LINKFOX_AGENT_API_KEY も LINKFOXAGENT_API_KEY も設定されていません。
• レスポンスのステータスコードが 401 または 402
• 計算リソースまたは残高不足を示すレスポンス：メッセージに「計算リソース残高不足／課金不足／残高不足／quota exceeded／insufficient balance／プランの有効期限切れ／チャージが必要／チャージしてください」または同様の意味の内容が含まれています。

デフォルトパラメーター

フィールド	デフォルト	説明
site	eu	Partner EU
managementType	semi-managed	半管理型
tokenPurpose	product-inventory	酷鳥セラーアシスタントの token

認証

1. LinkFox：LINKFOXAGENT_API_KEY → Header Authorization ＋ Token
2. Temu：accessToken または storeKey

Scripts（type 別）

スクリプト	type	状態
eu_price_baseprice_recommend.py	temu.local.goods.baseprice.recommend	接続済み
eu_price_recommendedprice_query.py	temu.local.goods.recommendedprice.query	接続済み
eu_price_priceorder_query.py	bg.local.goods.priceorder.query	接続済み
eu_price_priceorder_change_sku_price.py	bg.local.goods.priceorder.change.sku.price	接続済み
temu_eu_proxy.py	任意の type	汎用
temu_eu_file_download.py	署名付きファイルのダウンロード	汎用

インターフェイスを追加した後は、この表と partner-eu-catalog.md に登録してください。

例

export LINKFOXAGENT_API_KEY="<key>"

# 推荐基础价/供货价估算（须 catId + supplierPriceEstimateSkuQryList）
python scripts/eu_price_baseprice_recommend.py '{
  "accessToken": "TOKEN",
  "request": {
    "supplierPriceEstimateQry": {
      "goodsBasicInfo": { "catId": 12345 },
      "supplierPriceEstimateSkuQryList": [
        {
          "specIdList": [9001],
          "externPlatformPriceInfo": { "amount": "19.99", "currency": "EUR" }
        }
      ]
    }
  }
}'

# 推荐供货价查询（须 recommendedPriceType + goodsIdList，1～100 个 goodsId）
python scripts/eu_price_recommendedprice_query.py '{
  "accessToken": "TOKEN",
  "request": {
    "recommendedPriceType": 10,
    "goodsIdList": [123456789]
  }
}'

# 定价单列表查询（白名单；分页 page/size，可选筛选）
python scripts/eu_price_priceorder_query.py '{
  "accessToken": "TOKEN",
  "request": {
    "page": 1,
    "size": 20,
    "priceOrderType": 1,
    "orderBy": "order_create_time",
    "orderByType": 0
  }
}'

# 批量修改 SKU 基础价（白名单；须 goodsId + changeSkuPriceDTOList）
python scripts/eu_price_priceorder_change_sku_price.py '{
  "accessToken": "TOKEN",
  "request": {
    "goodsId": 123456,
    "changeSkuPriceDTOList": [
      {
        "skuChangePriceBaseDTOList": [
          {
            "skuId": 58224724203874,
            "newSupplierPrice": { "amount": "15.99", "currency": "EUR" }
          }
        ]
      }
    ]
  }
}'

Feedback： skillName：linkfox-temu-price-eu

ゲートウェイと認証スクリプト

スクリプト	説明
check_linkfox_token.py	LinkFox ユーザー Token を検証します
temu_token_guide.py	Temu 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

計算リソース消費ルール

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