Quickstart

The shortest path from a Turaxia key to a structured product record. Pick the surface that matches your stack.

1. Get an API key

Join the early-access list. We onboard design partners personally first, then open self-serve more broadly as modules graduate. When your workspace is provisioned, Connect issues an API key you can scope to specific modules.

2. curl

curl -X POST https://api.turaxia.com/parse/v1/parse \
  -H "Authorization: Bearer $TURAXIA_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sourceUrl": "https://www.gu-global.com/jp/ja/products/E357744-000/00"
  }'

Response shape: typed product record with productId, title, variants, and per-field confidence signals. See the Parse module doc for the full schema.

3. TypeScript SDK

import { createTuraxiaClient } from '@turaxia/sdk';

const turaxia = createTuraxiaClient({ apiKey: process.env.TURAXIA_KEY });

const parsed = await turaxia.parse({
  sourceUrl: 'https://www.gu-global.com/jp/ja/products/E357744-000/00',
});

const quote = await turaxia.price.quote({
  productId: parsed.productId,
  destinationCountry: 'KZ',
});

4. CLI

npm i -g @turaxia/cli
turaxia login                              # workspace + key
turaxia parse https://www.gu-global.com/... # prints typed record
turaxia price quote --product $PID --to KZ  # landed-cost quote

5. Remote MCP

Turaxia currently exposes remote MCP endpoints over HTTPS. For the full authenticated tool set, point your client at https://api.turaxia.com/mcp and pass your workspace bearer token.

Use the remote MCP config shape your client expects. A common form looks like this:

{
  "mcpServers": {
    "turaxia": {
      "url": "https://api.turaxia.com/mcp",
      "headers": {
        "Authorization": "Bearer ${TURAXIA_KEY}"
      }
    }
  }
}

Your agent can now call turaxia.parse, turaxia.localize, turaxia.price.quote, and turaxia.route.resolve with typed inputs and typed outputs. See the MCP guide for the full tool list and the public-safe /public/mcp connector path.

The public-safe connector surface is also published in the official MCP Registry under com.turaxia/connect.

6. Reproduce our benchmarks

• Public proof bundle: /proof.
• Per-scenario cards and videos are downloadable.
• Scenario source + exact commands are in apps/validation/scenarios/ in the apps workspace.