convez.ai
MCP ServerIntegração & APIsIntermediário
WellMarkedAPI

WellMarked MCP Server

WellMarkedAPI/MCP

Extraia URLs como Markdown limpo dentro do Claude e agentes MCP

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP oficial do WellMarked.io que permite aos agentes de IA extrair conteúdo limpo em Markdown de URLs, fazer crawling de sites e processar lotes de páginas em paralelo. Integra-se nativamente com Claude Desktop, Claude Code, Cursor e outros hosts MCP, oferecendo tratamento de erros tipado e retry automático.

Instalação

$npx convez-ai WellMarkedAPI/MCP

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
50%
Último commit
há 3 meses
Versão
v1.2.1
Issues abertas
2
Contribuidores
2

Casos de uso

  • Extrair conteúdo principal de páginas web para análise por IA
  • Fazer crawling de sites inteiros e converter estrutura em Markdown
  • Processar lotes grandes de URLs concorrentemente (plano Pro+)
  • Alimentar agentes com conteúdo web estruturado e limpo

Veredito

MCP server bem estruturado e maduro para quem precisa extrair conteúdo web de forma confiável. A integração com WellMarked oferece limpeza robusta de HTML→Markdown, mas requer chave de API paga; recomendado para fluxos de produção que envolvam processamento sistemático de páginas.

README

A tradução para o português deste README ainda está na fila.

WellMarked MCP Server

The official Model Context Protocol server for WellMarked.io — give your AI agents the ability to turn any URL into clean Markdown, bulk-extract batches of pages, and crawl entire sites, all from inside Claude Desktop, Claude Code, Cursor, or any MCP host.

It's a thin adapter over the official wellmarked JavaScript SDK, so it inherits the SDK's auth, typed errors, retry/back-off hints, and polymorphic job polling.

Tools

ToolWhat it does
extractFetch one URL and return its main content as clean Markdown + metadata.
bulkSubmit many URLs for concurrent extraction (Pro+). Blocks for results by default.
crawlCrawl a site BFS from a root URL to a given depth (Pro+). Returns an async job.
get_jobPoll a bulk/crawl job once by id.
wait_for_jobBlock until a job finishes, then return all results.
get_usageReport current billing-period quota (plan, used, limit, remaining).

Not exposed as tools: API-key rotation (/keys/rotate) and webhook-secret rotation (/webhook/rotate). Both are destructive and irreversible — the old credential dies the instant the call returns, with no recovery flow — which is the wrong shape for an autonomous agent. Rotate from the dashboard or the SDK.

Setup

You need a WellMarked API key (wm_...) — generate one at wellmarked.io.

Claude Desktop

Add to claude_desktop_config.json (Settings → Developer → Edit Config):

{
  "mcpServers": {
    "wellmarked": {
      "command": "npx",
      "args": ["-y", "wellmarked-mcp"],
      "env": {
        "WELLMARKED_API_KEY": "wm_your_key_here"
      }
    }
  }
}

Claude Code

claude mcp add wellmarked --env WELLMARKED_API_KEY=wm_your_key_here -- npx -y wellmarked-mcp

Cursor / other MCP hosts

Any host that launches MCP servers over stdio works — point it at npx -y wellmarked-mcp with WELLMARKED_API_KEY in the environment.

Environment variables

VariableRequiredDescription
WELLMARKED_API_KEYyesYour wm_... API key.
WELLMARKED_BASE_URLnoOverride the API base URL (self-hosted instances).
WELLMARKED_TIMEOUT_MSnoPer-request timeout in ms (default 30000).

Develop locally

npm install
npm run build        # compile TypeScript to dist/
npm start            # run the compiled server on stdio

# Inspect it interactively with the MCP Inspector:
WELLMARKED_API_KEY=wm_... npx @modelcontextprotocol/inspector node dist/index.js

License

MIT — see LICENSE.

Ver o original no GitHub

Bom para

Relacionados