Docs · quickstart

Quickstart

The shortest path from a Turaxia API key to a structured product record — with curl, the TypeScript SDK, the CLI, and MCP.

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/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. MCP

Add Turaxia to your MCP-capable client:

{
  "mcpServers": {
    "turaxia": {
      "command": "npx",
      "args": ["-y", "@turaxia/mcp"],
      "env": { "TURAXIA_API_KEY": "${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.

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.

← All docs