Recipes

Short, opinionated Turaxia recipes. Each one is the minimum useful composition.

A single supplier URL → landed-cost quote

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 localized = await turaxia.localize({ productId: parsed.productId, to: 'ru' });
const quote = await turaxia.price.quote({ productId: parsed.productId, destinationCountry: 'KZ' });
const plan = await turaxia.route.resolve({ productId: parsed.productId, destinationCountry: 'KZ' });

console.log({ localized, quote, plan });

A CSV of URLs → batch catalog export

Use Flow (Beta) for batch. On the CLI:

turaxia batch run urls.csv \
  --steps parse,localize,price,route \
  --concurrency 4 \
  --output ./catalog/ \
  --webhook https://ops.example.com/turaxia-webhook

Agent-era: a buyer asking "can I get this delivered to KZ for under $30?"

1. Agent calls turaxia.parse on the supplier URL.
2. Agent calls turaxia.price.quote with destinationCountry: 'KZ' on the resulting product record.
3. Agent compares the quote against the user's budget.
4. If under budget, agent calls turaxia.route.resolve to lock in a carrier.
5. Agent asks the user for confirmation, then hands off to Connect for the workspace-level action.

All five tools are typed. The agent keeps the reasoning; Turaxia keeps the data primitives stable.

Ops-side: reconcile a catalog against fresh FX rates

Every Price.quote result is deterministic against a given rate feed. To replay at a new FX snapshot, pass asOf: '2026-04-18T00:00:00Z' on the quote and compare against the cached record.