linkfox-temu-manage-product-us

Temu US Site Product Management API (Manage Product)

This skill (linkfox-temu-manage-product-us) covers Partner Platform for US Product > Manage Product（menu_code=fb16b05f7a904765aac4af3a24b87d4a) under 24 interfaces. bg.local.* / temu.local.* For the European site, use linkfox-temu-manage-product-eu; for the global site (non-US/EU), use linkfox-temu-manage-product-global。

gateway (built into this skill)：

Capability	Method	Path
Product OpenAPI (us_manage_*、temu_us_proxy）	POST	https://tool-gateway.linkfox.com/temu/proxy
signed file download	POST	https://tool-gateway.linkfox.com/temu/fileDownload

product publishing(V2 add, category mapping, etc.), use linkfox-temu-add-product-us。price/supply price（priceorder.query、recommendedprice.query , etc.), use linkfox-temu-price-us。promotions/marketing campaigns, use linkfox-temu-promotion-us（bg.promotion.*）。Ads, use linkfox-temu-ads-us。Orders, use linkfox-temu-order-us。fulfillment/shipping, use linkfox-temu-fulfillment-us。cancel order, use linkfox-temu-cancel-order-us。

Invocation method

• 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 constraints: This tool consumes compute; on failure/empty results, do not automatically switch keywords, paginate, or repeatedly probe; if continued retrieval is needed, 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/<skill-name>-<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 by user 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 recommendation: first check the summary to determine whether it is sufficient; when specific fields are needed, prefer jqorConvertFrom-Json to extract on demand from the saved json file, avoiding bringing the entire JSON into context.

Input/output parameters,Partner official documentation URL has been inlined into references/：

documentation	content
api.md	gateway, authentication, error codes
partner-us-catalog.md	24 interface directory + scripts + documentation links
apis/README.md	split by interface into files(24 apis/*.md）

Example documentation for common single interfaces:

• Partial edit:apis/bg-local-goods-partial-update.md
• Product list:apis/bg-local-goods-list-query.md
• Inventory edit:apis/bg-local-goods-stock-edit.md

Resolve authentication and compute issues

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

Abnormal situations

• API Key not configured: Environment variable not configured LINKFOX_AGENT_API_KEY, and also not configured LINKFOXAGENT_API_KEY。
• Responds with 401 or 402 status code
• Response indicates insufficient computing power or balance: The message contains "insufficient computing power 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	product-inventory	Kuniao Seller Assistant token

Authentication

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

Scripts (by type)

Script	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	Any type
temu_us_file_download.py	Signed file download

Example

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

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	General gateway forwarding (multi-site)
temu_file_download.py	Signed file download (multi-site)

Authorization instructions:references/access-token.md

Computing power consumption rules

Does not consume computing power.