linkfox-temu-manage-product-eu

Temu 欧州站商品管理 API（Manage Product）

本 skill（linkfox-temu-manage-product-eu）涵盖 Partner Platform for EU Product > Manage Products（menu_code=2283b8dc7fcc42529633b0b41114aef8）下的 24 个 bg.local.* / temu.local.* 接口（type 与 US 版保持一致）。美国站请使用 linkfox-temu-manage-product-us；全球站（US/EU 以外）请使用 linkfox-temu-manage-product-global。

ゲートウェイ（本 skill に内蔵）：

能力	方法	路径
商品 OpenAPI（eu_manage_*、temu_eu_proxy）	POST	https://tool-gateway.linkfox.com/temu/proxy
署名付きファイルのダウンロード	POST	https://tool-gateway.linkfox.com/temu/fileDownload

商品登録、注文 など、その他の領域では、当面は対応する linkfox-temu-*-us skill を使用して site=eu を設定してください。または、公開済みの EU skill linkfox-temu-price-eu、linkfox-temu-promotion-eu、linkfox-temu-ads-eu、linkfox-temu-tax-eu などを使用してください。

呼び出し方法

• 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 ファイルから jq または ConvertFrom-Json を使って必要な項目を抽出し、JSON 全体がコンテキストに入らないようにしてください。

認証と計算リソースの問題への対処

次のような異常が発生した場合は、references/onboarding.md の案内に従って問題を解決してください。

異常な状況

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

API ドキュメント

パラメーター／戻り値と、Partner 公式ドキュメントの URL は references/ に含まれています。

ドキュメント	内容
api.md	ゲートウェイ、認証、エラーコード
partner-eu-catalog.md	24 インターフェースの一覧 + スクリプト + ドキュメントリンク
apis/README.md	インターフェースごとにファイルを分割（24 個の apis/*.md）

よく使う個別インターフェースのドキュメント例：

• 一部編集：apis/bg-local-goods-partial-update.md
• 商品一覧：apis/bg-local-goods-list-query.md
• 在庫編集：apis/bg-local-goods-stock-edit.md

デフォルトパラメーター

フィールド	デフォルト	説明
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_manage_list_query.py	bg.local.goods.list.query
eu_manage_goods_list_retrieve.py	temu.local.goods.list.retrieve
eu_manage_detail_query.py	bg.local.goods.detail.query
eu_manage_sku_list_query.py	bg.local.goods.sku.list.query
eu_manage_sku_list_retrieve.py	temu.local.sku.list.retrieve
eu_manage_publish_status_get.py	bg.local.goods.publish.status.get
eu_manage_sku_stock_query.py	temu.local.goods.sku.stock.query
eu_manage_stock_edit.py	bg.local.goods.stock.edit
eu_manage_partial_update.py	bg.local.goods.partial.update
eu_manage_goods_update.py	bg.local.goods.update
eu_manage_goods_delete.py	temu.local.goods.delete
eu_manage_spec_info_get.py	temu.local.goods.spec.info.get
eu_manage_category_check.py	bg.local.goods.category.check
eu_manage_property_get.py	bg.local.goods.property.get
eu_manage_property_relations.py	bg.local.goods.property.relations
eu_manage_property_relations_level_template.py	bg.local.goods.property.relations.level.template
eu_manage_property_relations_template.py	bg.local.goods.property.relations.template
eu_manage_out_sn_set.py	bg.local.goods.out.sn.set
eu_manage_sku_out_sn_set.py	bg.local.goods.sku.out.sn.set
eu_manage_compliance_list_query.py	bg.local.compliance.goods.list.query
eu_manage_compliance_edit.py	bg.local.goods.compliance.edit
eu_manage_sale_status_set.py	bg.local.goods.sale.status.set
eu_manage_pre_sale_status_edit.py	temu.local.goods.pre.sale.status.edit
eu_manage_videocoverimage_get.py	bg.local.goods.videocoverimage.get
temu_eu_proxy.py	任意 type
temu_eu_file_download.py	加签文件下载

示例

export LINKFOXAGENT_API_KEY="<key>"

# 商品列表
python scripts/eu_manage_list_query.py '{"accessToken":"TOKEN","request":{"pageNo":1,"pageSize":20,"goodsSearchType":1,"goodsStatusFilterType":0}}'

# 详情
python scripts/eu_manage_detail_query.py '{"accessToken":"TOKEN","request":{"goodsId":123456,"versionQueryType":2}}'

# 部分编辑标题（官方字段为 goodsBasic.goodsName，非 productName）
python scripts/eu_manage_partial_update.py '{"accessToken":"TOKEN","request":{"goodsId":123456,"goodsBasic":{"goodsName":"New Title"}}}'

# 库存增量
python scripts/eu_manage_stock_edit.py '{"accessToken":"TOKEN","request":{"goodsId":123456,"skuStockChangeList":[{"skuId":999,"stockDiff":10}]}}'

Feedback： skillName：linkfox-temu-manage-product-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

算力消耗规则

不消耗算力。