@metalift/sdk

@metalift/sdk

Official TypeScript/JavaScript SDK for Metalift — turn any URL into agent-ready markdown, HTML, or structured data.

Requirements

• Node.js 20+
• ESM only — use import, not require()

Install

npm install @metalift/sdk

Quick start

import Metalift from "@metalift/sdk";

const client = new Metalift({ apiKey: "YOUR_API_KEY" });

const result = await client.scrape({
  url: "https://example.com",
  formats: ["markdown"],
});
console.log(result.data.markdown);

Get an API key from the Metalift dashboard.

Configuration

import Metalift from "@metalift/sdk";

const client = new Metalift({
  apiUrl: "https://api.metalift.ai", // default
  apiKey: process.env.METALIFT_API_KEY,
});

Variable	Description
METALIFT_API_URL	API base URL (default: https://api.metalift.ai)
METALIFT_API_KEY	Bearer token for authenticated requests

CommonJS projects

This package is ESM-only. In CommonJS projects, use dynamic import:

const { default: Metalift } = await import("@metalift/sdk");

Or add "type": "module" to your package.json, or use .mjs entry files.

Links

• Documentation
• Support