linkfox-temu-price-global

Temu Global site price API (linkfox-temu-price-global)

This skill (linkfox-temu-price-global) covers global region (site=global, non-US/Europe) under the Product menu, related toprice/supply pricethe bg.local.* / temu.local.* endpoints (menu_code=fb16b05f7a904765aac4af3a24b87d4a, specific sub_menu_code subject to the Partner documentation).

Currently integrated 5 endpoints; the remaining price endpoints will be added one by one per the Partner documentation to references/apis/ and global_price_*.py。

Gateway (built into this skill)：

Capability	Method	Path
Price OpenAPI (`global_price_*`、`temu_global_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-global`
US site price	`linkfox-temu-price-us`
Europe site price	`linkfox-temu-price-eu`
Order query, shipping, logistics	`linkfox-temu-order-global`
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/response/error codes see references/api.md）
Python script：python scripts/<脚本名>.py '<JSON 参数>' [--inline](available scripts see the script list above)
Cost constraint: This tool consumes compute; on failure/empty results do not automatically switch keywords, page, or probe continuously; if you need to continue searching, first explain to the user that additional consumption will be incurred.

Output policy (default script behavior)：

Alwayswrite the full response to <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/<skill-name>-<timestamp>.json（<cwd> being the working directory when the script runs, which in Claude Code is the current project directory;<session> taken from the environment variable SESSION_ID, automatically aggregated according to the user task;writing to /tmp is prohibited, if the current directory is not writable then report an error)
Response body ≤ 8 KB: after saving to disk, print the complete JSON to stdout
Response body > 8 KB: after saving 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 saved to disk)

Data reading suggestion: First look at the summary to judge whether it is sufficient; when specific fields are needed, prefer to use jqorConvertFrom-Json to extract on demand from the saved json file, avoiding the entire JSON entering the 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 with LINKFOX_AGENT_API_KEY, nor is 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 content with a similar meaning.

Default parameters

Field	Default	Description
site	`global`	Partner Global (non-US/EU)
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
`global_price_baseprice_recommend.py`	`temu.local.goods.baseprice.recommend`	Integrated
`global_price_recommendedprice_query.py`	`temu.local.goods.recommendedprice.query`	Integrated
`global_price_priceorder_query.py`	`bg.local.goods.priceorder.query`	Integrated
`global_price_priceorder_change_sku_price.py`	`bg.local.goods.priceorder.change.sku.price`	Integrated
`global_price_sku_list_price_query.py`	`bg.local.goods.sku.list.price.query`	Integrated
`temu_global_proxy.py`	Any `type`	General
`temu_global_file_download.py`	Signed file download	General

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

Example

export LINKFOXAGENT_API_KEY="<key>"

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

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

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

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

# SKU 供货价列表（goodsId + skuIdList）
python scripts/global_price_sku_list_price_query.py '{
  "accessToken": "TOKEN",
  "site": "global",
  "tokenPurpose": "product-inventory",
  "request": {
    "querySupplierPriceBaseList": [
      { "goodsId": 123456789, "skuIdList": [58224724203874] }
    ]
  }
}'

Feedback： skillName：linkfox-temu-price-global

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

Compute consumption rules

Does not consume compute.