linkfox-temu-price-us

Temu US site price API (linkfox-temu-price-us)

This skill (linkfox-temu-price-us) covers the Partner Platform for US Product interfaces under the menu related toprice/supply price( bg.local.* / temu.local.* , specificmenu_code=fb16b05f7a904765aac4af3a24b87d4asubject to the Partner documentation). For the European site, please use sub_menu_code ; for the global site (non-US/EU), please use linkfox-temu-price-eu. linkfox-temu-price-global。

Currently integrated 4 interfaces; the remaining price interfaces will be added one by one according to the Partner documentation to references/apis/ and us_price_*.py。

Gateway (built into this skill)：

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

Related skills

Scenario	skill
Product list/detail/edit/inventory/listing and delisting	`linkfox-temu-manage-product-us`
Order query, shipping, logistics	`linkfox-temu-order-us`
Cancel order (buyer + seller)	`linkfox-temu-cancel-order-us`

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](available scripts are listed in the script overview 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/<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 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, length of the largest list field + 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 using 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 situations

API Key not configured: environment variable not configured LINKFOX_AGENT_API_KEY, and also not configured 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	`product-inventory`	Kuniao Seller Assistant token

Authentication

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

Scripts (by type)

Script	type	Status
`us_price_baseprice_recommend.py`	`temu.local.goods.baseprice.recommend`	Integrated
`us_price_recommendedprice_query.py`	`temu.local.goods.recommendedprice.query`	Integrated
`us_price_priceorder_query.py`	`bg.local.goods.priceorder.query`	Integrated
`us_price_priceorder_change_sku_price.py`	`bg.local.goods.priceorder.change.sku.price`	Integrated
`temu_us_proxy.py`	Any `type`	General
`temu_us_file_download.py`	Signed file download	General

After adding an interface, register it in this table and in partner-us-catalog.md in sync.

Example

export LINKFOXAGENT_API_KEY="<key>"

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

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

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

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

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

No computing power is consumed.