linkfox-temu-manage-product-us

Temu 米国サイトの商品管理 API（Manage Product）

このスキル（linkfox-temu-manage-product-us）は、Partner Platform for US の Product > Manage Product（menu_code=fb16b05f7a904765aac4af3a24b87d4a）にある 24 個の bg.local.* / temu.local.* インターフェースに対応しています。欧州サイトでは linkfox-temu-manage-product-eu、グローバルサイト（US/EU 以外）では linkfox-temu-manage-product-global を使用してください。

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

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

商品登録（V2 add、カテゴリーマッピングなど）には linkfox-temu-add-product-us を使用してください。価格／供給価格（priceorder.query、recommendedprice.query など）には linkfox-temu-price-us を使用してください。プロモーション／マーケティングキャンペーンには linkfox-temu-promotion-us（bg.promotion.*）を使用してください。広告 Ads には linkfox-temu-ads-us を使用してください。注文には linkfox-temu-order-us を使用してください。フルフィルメント／発送には linkfox-temu-fulfillment-us を使用してください。注文のキャンセルには linkfox-temu-cancel-order-us を使用してください。

呼び出し方法

• 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 を使って必要なデータを抽出してください。

入力／出力パラメーター、Partner 公式ドキュメントの URL は references/ に含まれています：

ドキュメント	内容
api.md	ゲートウェイ、認証、エラーコード
partner-us-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

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

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

異常な状況

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

デフォルトパラメーター

フィールド	デフォルト	説明
site	us	Partner US
managementType	semi-managed	セミマネージド
tokenPurpose	product-inventory	酷鳥セラーアシスタントのトークン

認証

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

Scripts（按 type）

脚本	type
us_manage_list_query.py	bg.local.goods.list.query
us_manage_goods_list_retrieve.py	temu.local.goods.list.retrieve
us_manage_detail_query.py	bg.local.goods.detail.query
us_manage_sku_list_query.py	bg.local.goods.sku.list.query
us_manage_sku_list_retrieve.py	temu.local.sku.list.retrieve
us_manage_publish_status_get.py	bg.local.goods.publish.status.get
us_manage_sku_stock_query.py	temu.local.goods.sku.stock.query
us_manage_stock_edit.py	bg.local.goods.stock.edit
us_manage_partial_update.py	bg.local.goods.partial.update
us_manage_goods_update.py	bg.local.goods.update
us_manage_goods_delete.py	temu.local.goods.delete
us_manage_spec_info_get.py	temu.local.goods.spec.info.get
us_manage_category_check.py	bg.local.goods.category.check
us_manage_property_get.py	bg.local.goods.property.get
us_manage_property_relations.py	bg.local.goods.property.relations
us_manage_property_relations_level_template.py	bg.local.goods.property.relations.level.template
us_manage_property_relations_template.py	bg.local.goods.property.relations.template
us_manage_out_sn_set.py	bg.local.goods.out.sn.set
us_manage_sku_out_sn_set.py	bg.local.goods.sku.out.sn.set
us_manage_compliance_list_query.py	bg.local.compliance.goods.list.query
us_manage_compliance_edit.py	bg.local.goods.compliance.edit
us_manage_sale_status_set.py	bg.local.goods.sale.status.set
us_manage_pre_sale_status_edit.py	temu.local.goods.pre.sale.status.edit
us_manage_videocoverimage_get.py	bg.local.goods.videocoverimage.get
temu_us_proxy.py	任意 type
temu_us_file_download.py	加签文件下载

示例

export LINKFOXAGENT_API_KEY="<key>"

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

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

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

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

Feedback： skillName：linkfox-temu-manage-product-us

网关与授权脚本

脚本	说明
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

算力消耗规则

不消耗算力。