read

const result = await saturn.read({
  url: 'https://example.com/article',
});

console.log(result.data.content);
// → Clean text content without HTML, ads, or navigation

interface ReadResponse {
  data: {
    content: string;    // Extracted text content
    title: string;      // Page title
    url: string;        // Final URL (after redirects)
  };
  metadata: {
    chargedUsdCents: number;
    provider: string;
    latencyMs: number;
    auditId: string;
  };
}

const page = await saturn.read({
  url: 'https://blog.example.com/long-article',
});

const summary = await saturn.reason({
  prompt: `Summarize this article:\n\n${page.data.content}`,
  maxTokens: 500,
});

console.log(summary.data.content);

async function researchTopic(query: string) {
  // Find relevant pages
  const search = await saturn.search({ query, numResults: 5 });

  // Read all pages in parallel
  const pages = await Promise.all(
    search.data.results.map(r => saturn.read({ url: r.url }))
  );

  // Extract key information
  const synthesis = await saturn.reason({
    prompt: `Based on these sources, summarize what we know about "${query}":\n\n${
      pages.map((p, i) => `Source ${i + 1}: ${p.data.content.slice(0, 3000)}`).join('\n\n')
    }`,
  });

  return synthesis.data.content;
}

try {
  const page = await saturn.read({ url: 'https://example.com/article' });
} catch (err) {
  if (err.code === 'PROVIDER_ERROR') {
    // Page couldn't be read (404, blocked, etc.)
    console.log('Could not read page:', err.message);
  }
}