linkfox-temu-add-product-us

Temu US Add Product API (Partner US)

This skill (linkfox-temu-add-product-us) covers Partner Platform for US Product menu (menu_code=fb16b05f7a904765aac4af3a24b87d4a) under 19 product interfaces：4 V2 recommended product listings + 15 standard product APIs(query, edit, category, inventory, price, etc.).

Gateway (built into this skill)：

Capability	Method	Gateway path
Product OpenAPI (all `us_goods_*`、`temu_us_proxy`）	POST	`https://tool-gateway.linkfox.com/temu/proxy`
Signed file download (`temu_us_file_download`）	POST	`https://tool-gateway.linkfox.com/temu/fileDownload`

Product type is written in the Body,not the URL path.

Not an order skill: for orders, shipping, and logistics, see linkfox-temu-order-us or other fulfillment-type skills.

How to call

API endpoint：POST /temu/proxy(different operations are distinguished by the request body; for complete parameters/responses/error codes, see references/api.md）
Python script：python scripts/<脚本名>.py '<JSON 参数>' [--inline](for available scripts, see the script list above)
Cost constraint: this tool consumes compute; on failure/empty results, do not automatically switch keywords, paginate, or repeatedly probe; if you need to continue searching, first explain to the user that additional consumption will be incurred.

Output strategy (default script behavior)：

Alwayswrite the complete response to <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-temu-add-product-us-<timestamp>.json（<cwd> is the working directory when the script runs, which in Claude Code is the current project directory;<session> is taken from the environment variable SESSION_ID, automatically aggregated according to the user's task;writing to /tmp is prohibited, if the current directory is not writable, report an error)
Response body ≤ 8 KB: after writing to disk, print the complete JSON to stdout
Response body > 8 KB: after writing to disk, stdout outputs only a summary (top-level fields, common counts such as total/costToken, the length of the largest list field + the first 3 samples)
Add --inline to force full printing to stdout (also written to disk)

Data reading suggestions: first look at the summary to determine whether it is sufficient; when specific fields are needed, prefer to use jqorConvertFrom-Json to extract on demand from the saved json file, avoiding bringing the entire JSON into context.

Resolve authentication and compute issues

When the following abnormal situations occur, use references/onboarding.md to guide resolution:

Abnormal situation

API Key not configured: the environment variable is not configured LINKFOX_AGENT_API_KEY, and LINKFOXAGENT_API_KEY。
Response 401 or 402 status code
Response indicates insufficient compute or balance: the message contains "insufficient compute balance/insufficient billing/insufficient balance/quota exceeded/insufficient balance/package expired/recharge required/please recharge", or similar meaning.

Default parameters

Field	Default	Description
site	`us`	Partner US
managementType	`semi-managed`	Semi-managed
tokenPurpose（storeKey）	`product-inventory`	Kuniao Seller Assistant token

Authentication

LinkFox：LINKFOXAGENT_API_KEY → Header Authorization + Token
Temu：accessToken or storeKey

Scripts

V2 recommended product listing

Script	type
`us_goods_attrs.py`	`temu.local.product.attributes.get`
`us_goods_variation.py`	`temu.local.product.variation.get`
`us_goods_image_upload.py`	`temu.local.goods.image.v2.upload`
`us_goods_add.py`	`temu.local.goods.v2.add`

Query / Edit / Category / Inventory

Script	type
`us_goods_list.py`	`temu.goods.list.get`
`us_goods_detail.py`	`temu.goods.detail.get`
`us_goods_update.py`	`temu.goods.update`
`us_goods_edit_property.py`	`temu.goods.edit.property`
`us_goods_edit_sensitive.py`	`temu.goods.edit.sensitive.attr`
`us_goods_migrate.py`	`temu.goods.migrate`
`us_goods_cats.py`	`bg.goods.cats.get`
`us_goods_attrs_bg.py`	`bg.goods.attrs.get`
`us_goods_parent_spec.py`	`bg.glo.goods.parentspec.get`
`us_goods_brand.py`	`bg.glo.goods.brand.get`
`us_goods_category_mapping.py`	`bg.goods.category.mapping`
`us_goods_stock_get.py`	`bg.btg.goods.stock.quantity.get`
`us_goods_stock_update.py`	`bg.btg.goods.stock.quantity.update`
`us_goods_price_list.py`	`temu.goods.price.list.get`
`us_goods_add_legacy.py`	`temu.goods.add`
`temu_us_proxy.py`	Any `type`
`temu_us_file_download.py`	Signed file download

Example

export LINKFOXAGENT_API_KEY="<key>"

# 商品列表
python scripts/us_goods_list.py '{"accessToken":"TOKEN","page":1,"pageSize":20}'

# 类目映射
python scripts/us_goods_category_mapping.py '{
  "accessToken":"TOKEN",
  "goodsName":"测试商品",
  "goodsNameEn":"Test Product"
}'

# V2 发品流程
python scripts/us_goods_attrs.py '{"accessToken":"TOKEN","params":{"catId":12345}}'
python scripts/us_goods_image_upload.py '{"accessToken":"TOKEN","params":{"image":"<BASE64>"}}'
python scripts/us_goods_add.py '{"accessToken":"TOKEN","params":{"..."}}'

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

Gateway and authorization scripts

Script	Description
`check_linkfox_token.py`	Verify LinkFox user Token
`temu_token_guide.py`	Temu accessToken backend authorization steps
`save_temu_access_token.py`	Save accessToken locally
`list_temu_access_tokens.py`	List saved tokens
`get_temu_access_token.py`	Read saved token
`temu_proxy.py`	Generic gateway forwarding (multi-site)
`temu_file_download.py`	Signed file download (multi-site)

Authorization instructions:references/access-token.md

Computing power consumption rules

No computing power is consumed.