WellMarked

¡Convierte cualquier URL a Markdown!

Ver en wellmarked.io

Documentación

Referencia completa de la API de WellMarked de URL a Markdown: extracción, lote, rastreo, búsqueda, uso, claves y webhooks firmados, con ejemplos en Python, JavaScript, TypeScript y curl.

WellMarked es una API de extracción de contenido web. Envía una URL y recibe Markdown limpio sin navegación, anuncios, banners de cookies ni contenido repetitivo, además de metadatos estructurados (título, autor, fecha). Es la capa de entrada para cualquier cosa que necesite leer la web en vivo de manera confiable.

Cuándo usarlo

  • Obtén el contenido legible de una URL como Markdown para un prompt de LLM o un almacén de vectores.
  • Reduce una página a su cuerpo de artículo, eliminando menús, pies de página, anuncios y scripts de seguimiento.
  • Extrae metadatos estructurados de una página.
  • Procesa muchas URLs simultáneamente en un solo trabajo por lotes: todos los planes, con Free limitado a 5 URLs.
  • Rastrea un sitio en anchura desde una URL raíz y extrae cada página alcanzable (Pro y superior).
  • Renderiza páginas con mucho JavaScript antes de extraer (Pro y superior).

URL base

https://api.wellmarked.io

Los endpoints autenticados requieren un token Bearer. GET /health y GET /pricing son públicos. Un agente con una billetera criptográfica no necesita ninguna clave; consulta pagos x402.

Inicio rápido

Obtén una clave

Regístrate en wellmarked.io y copia la clave de la respuesta. Comienza con wm_ y se devuelve una vez: persístela de inmediato. Si la pierdes, rota con POST /keys/rotate en lugar de empezar de nuevo.

Extrae una página

curl -X POST https://api.wellmarked.io/extract \
  -H "Authorization: Bearer wm_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'

Lee la respuesta

{
  "url": "https://example.com",
  "markdown": "# Example Domain\n\nThis domain is for use in…",
  "metadata": { "title": "Example Domain", "author": null, "date": null },
  "metrics": {
    "content_bytes": 84213,
    "input_tokens": 21050,
    "output_tokens": 1204,
    "tokens_saved": 19846,
    "reduction_pct": 94.3
  }
}

tokens_saved es lo que no tuviste que enviar a un modelo, en lugar de alimentarlo con el HTML crudo.

SDKs e integraciones

Python

pip install wellmarked: clientes síncronos y asíncronos, excepciones tipadas.

JavaScript / TypeScript

npm install wellmarked: ESM + CJS dual, tipos incluidos.

MCP server

Seis herramientas para hosts de agentes, local sobre stdio o alojado sobre OAuth.

n8n

Nodo comunitario oficial: cada endpoint como una acción tipada.

LangChain

Cargador de documentos más un recuperador de búsqueda web en vivo.

LlamaIndex

Lector para extracción, rastreo y búsqueda.

Dónde ir a continuación

[

Autenticación

Claves de API Bearer, el modelo de alcance, tokens de trabajo y cómo rotar una clave sin visitar el panel.

](https://wellmarked.io/docs/authentication)