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