npm install mdxai @mdxai/claude

export ANTHROPIC_API_KEY=sk-ant-...

import { configure } from 'mdxai'
 
configure({
  anthropic: {
    apiKey: process.env.ANTHROPIC_API_KEY,
  },
})

import { generateMDX } from '@mdxai/claude'
 
const result = await generateMDX({
  prompt: 'Write a short introduction to GraphQL',
})
 
console.log(result.content)
// # Introduction to GraphQL
//
// GraphQL is a query language for APIs...

const result = await generateMDX({
  prompt: 'Write a tutorial about React hooks',
  schema: {
    $type: 'Tutorial',
    title: 'string',
    difficulty: 'beginner | intermediate | advanced',
    prerequisites: 'string[]',
  },
})
 
console.log(result.frontmatter)
// {
//   $type: 'Tutorial',
//   title: 'Understanding React Hooks',
//   difficulty: 'intermediate',
//   prerequisites: ['JavaScript basics', 'React fundamentals']
// }

import { transformMDX } from '@mdxai/claude'
 
const original = `
# API Reference
 
The \`get\` method retrieves a document.
`
 
const enhanced = await transformMDX(original, {
  instructions: 'Add code examples and parameter descriptions',
})

const translated = await transformMDX(englishMDX, {
  instructions: 'Translate to Spanish while preserving code blocks',
})

import { extractFromMDX } from '@mdxai/claude'
 
const data = await extractFromMDX(documentation, {
  schema: {
    functions: [{
      name: 'string',
      parameters: 'string[]',
      returnType: 'string',
    }],
  },
})

import { streamMDX } from '@mdxai/claude'
 
const stream = await streamMDX({
  prompt: 'Write a comprehensive guide to testing',
})
 
for await (const chunk of stream) {
  process.stdout.write(chunk)
}

import { generateMDX } from '@mdxai/claude'
import { type } from 'arktype'
 
const BlogPost = type({
  $type: '"BlogPost"',
  title: 'string',
  author: 'string',
  publishedAt: 'string',
  tags: 'string[]',
})
 
const result = await generateMDX({
  prompt: 'Write a blog post about AI',
  schema: BlogPost,
})
 
// result.frontmatter is typed as BlogPost

import { generateMDX, AIError } from '@mdxai/claude'
 
try {
  const result = await generateMDX({
    prompt: 'Generate content',
  })
} catch (error) {
  if (error instanceof AIError) {
    console.log(error.code)     // 'rate_limit' | 'invalid_request' | ...
    console.log(error.message)  // Human-readable message
    console.log(error.retryAfter) // Seconds until retry (for rate limits)
  }
}