WellMarked

Converta qualquer URL para Markdown!

Ver em wellmarked.io

Documentação

Full reference for the API WellMarked de URL para Markdown — extração, lote, rastreamento, busca, uso, chaves e webhooks assinados, com exemplos em Python, JavaScript, TypeScript e curl.

WellMarked é uma API de extração de conteúdo web. Envie uma URL e receba Markdown limpo, sem navegação, anúncios, banners de cookies e conteúdo irrelevante — além de metadados estruturados (título, autor, data). É a camada de entrada para qualquer coisa que precise ler a web ao vivo de forma confiável.

Quando usar

  • Busque o conteúdo legível de uma URL como Markdown para um prompt de LLM ou um armazenamento vetorial.
  • Reduza uma página ao corpo do artigo, removendo menus, rodapés, anúncios e scripts de rastreamento.
  • Extraia metadados estruturados de uma página.
  • Processe muitas URLs simultaneamente em um único job em lote — em todos os planos, com o Free limitado a 5 URLs.
  • Rastreie um site em largura a partir de uma URL raiz e extraia todas as páginas acessíveis (Pro e acima).
  • Renderize páginas com muito JavaScript antes da extração (Pro e acima).

URL base

https://api.wellmarked.io

Endpoints autenticados exigem um token Bearer. GET /health e GET /pricing são públicos. Um agente com carteira de criptomoedas não precisa de chave alguma — veja pagamentos x402.

Início rápido

Obter uma chave

Registre-se em wellmarked.io e copie a chave da resposta. Ela começa com wm_ e é retornada uma única vez — persista-a imediatamente. Se você a perder, gire com POST /keys/rotate em vez de recomeçar.

Extrair uma 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"}'

Ler a resposta

{
  "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 é o que você não precisou enviar a um modelo, em vez de alimentá-lo com o HTML bruto.

SDKs e integrações

Python

pip install wellmarked — clientes síncronos e assíncronos, exceções tipadas.

JavaScript / TypeScript

npm install wellmarked — ESM + CJS duplos, tipos incluídos.

Servidor MCP

Seis ferramentas para hosts de agentes, local via stdio ou hospedado via OAuth.

n8n

Nó oficial da comunidade — cada endpoint como uma ação tipada.

LangChain

Carregador de documentos além de um recuperador de busca web ao vivo.

LlamaIndex

Leitor para extração, rastreamento e busca.

Para onde ir a seguir

[

Autenticação

Chaves de API Bearer, o modelo de escopos, tokens de job e como girar uma chave sem visitar o painel.

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