agentutility(7)$ man sku-normalize
/sku-normalize
PRICE / CALL
$0.01
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
retailCATEGORY
uncategorized
STATUS
● live
NAME
sku-normalize — turns a messy marketplace product title or sku string into structured attributes for catalog matching: brand, model, variant, capacity, c…
SYNOPSIS
POST https://x402.agentutility.ai/sku-normalize
Content-Type: application/json
X-PAYMENT: <signed-transferWithAuthorization>
{ ... }↳ first call →
402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.DESCRIPTION
Turns a messy marketplace product title or SKU string into structured attributes for catalog matching: brand, model, variant, capacity, color, and a canonical key you can join against other catalogs. Feed it the raw title (or SKU) plus an optional category hint and it derives each attribute from what the string implies, with a confidence score, instead of guessing at specs the string doesn't carry. Use it as a sku normalize API, product title parse tool, catalog matching helper, or product attribute extraction service for price-comparison feeds and marketplace listings.
INPUT — request schema
| property | type | description | req? |
|---|---|---|---|
| title | string | Raw product title or SKU string to normalize, max 500 chars. Alias: 'sku'. | required |
| sku | string | Alias for 'title'. | optional |
| category | string | Optional category hint, e.g. 'smartphones', to help disambiguate attributes. | optional |
OUTPUT — response shape
| field | type | description |
|---|---|---|
| title | string | — |
| category | string | — |
| brand | string | — |
| model | string | — |
| variant | string | — |
| capacity | string | — |
| color | string | — |
| canonical_key | string | — |
| confidence | string | — |
| model_used | string | — |
| source | string | — |
EXAMPLES — two ways to call
EXAMPLE 1 · curl
curl -X POST https://x402.agentutility.ai/sku-normalize \
-H 'Content-Type: application/json' \
-d '{ }'first response =
402 Payment Required with payment requirements; sign + retry with X-PAYMENT.EXAMPLE 2 · mcp
# Install the MCP package for this endpoint's cluster npx -y @agentutility/mcp-<cluster> # Required: EVM private key with USDC on Base export X402_PRIVATE_KEY=0x... # Then call the sku-normalize tool from your MCP-aware agent.
MCP server handles payment automatically — your coding agent just calls the tool by name.
METADATA
- tags
- retailskunormalizesku-normalize
- methods
- POST
- cluster
- retail
- price
- $0.01 USDC per call
ADJACENT — other endpoints in retail
| endpoint | description | price |
|---|---|---|
| product-describe | Writes conversion-focused product descriptions and listing copy from a product name and optional category, audience, and attributes. | $0.01 |
| product-description | Product description API (alias of product-describe). | $0.01 |
| return-policy-extract | Turns a merchant's raw return policy text into structured refund terms an agent can act on before buying or returning something. | $0.015 |
| warranty-parse | Turns raw warranty terms text from a manual, warranty card, or manufacturer page into a structured coverage record an agent can check bef… | $0.015 |
| find-products | Find products API (alias of product-search). | $0.02 |
| product-search | Searches shopping results for a product query (and optional retailer), returning ranked results with product title, buy link, retailer do… | $0.02 |
| shop-search | Shopping search API (alias of product-search). | $0.02 |
SEE ALSO