URLpipe
Servidor MCP hospedado que renderiza páginas no Chrome real: Markdown, capturas de tela, metadados, erros de console e Lighthouse.
Servidor MCP hospedado
npx add-mcp 'https://urlpipe.dev/mcp'Instala no Claude Code, Codex, Cursor e outros
Documentação
Dê ao seu agente de IA um navegador que renderiza JavaScript
A maioria das ferramentas de fetch faz um HTTP GET simples, então um site em JavaScript retorna vazio. Esta carrega a página em um navegador real primeiro — hospedado, um token, nada para executar localmente.
Por Roger Campos · Última atualização: setembro de 2026
Resumo
O servidor MCP da URLpipe é um servidor remoto de HTTP streamable em https://urlpipe.dev/mcp.. Adicione-o ao seu cliente com um token bearer e seu agente terá 14 ferramentas: Markdown renderizado, HTML, capturas de tela que ele pode visualizar, metadados, Lighthouse, erros de console e mais — cada página carregada em Chrome real, com os mesmos créditos da API HTTP.
Plano gratuito, sem cartão de crédito. 1.000 créditos por mês.
O problema
Por que um agente precisa de um fetch com renderização
O servidor MCP de referência fetch — o que a maioria dos tutoriais instala primeiro — busca uma página com um HTTP GET simples e converte o HTML que recebe. Isso é suficiente para um blog. Em um aplicativo React, Vue ou Angular, o HTML é um contêiner vazio e uma tag de script, e o agente recebe nada enquanto acredita que leu a página.
| Servidor de fetch de referência | Servidor MCP da URLpipe | |
|---|---|---|
| Como a página é carregada | HTTP GET (httpx), sem JavaScript | Chrome headless real, scripts executados |
| Onde executa | Na sua máquina (uvx / pip / Docker) | Hospedado — nada para instalar |
| Saída | Markdown (Readability + markdownify), ou bruto | Markdown, HTML renderizado, captura de tela, metadados, Lighthouse, console, resumo, palavras-chave |
| Capturas de tela | Retornadas como uma imagem que o modelo pode ver | |
| Banners de cookies e anúncios | Removidos com page_options | |
| Custo | Gratuito, código aberto | Créditos do seu plano URLpipe |
O servidor de fetch é a ferramenta certa quando as páginas são estáticas e você quer tudo local e gratuito. Use este quando o agente encontrar páginas que precisam de um navegador, ou quando precisar ver uma página, não apenas lê-la. O código-fonte está em modelcontextprotocol/servers.
Configuração
Conecte seu cliente
Crie um token de organização em Acesso MCP no seu painel, depois forneça ao seu cliente a URL e o cabeçalho.
Três valores são toda a configuração: transporte HTTP streamable, URL https://urlpipe.dev/mcp, e um cabeçalho Authorization: Bearer YOUR_TOKEN. Não há fluxo OAuth nem processo local. O token não é sua chave de API do projeto — veja tokens e escopos abaixo.
Claude Code
claude mcp add --transport http urlpipe https://urlpipe.dev/mcp \
--header "Authorization: Bearer YOUR_TOKEN"
Cursor
~/.cursor/mcp.json (ou .cursor/mcp.json em um projeto)
{
"mcpServers": {
"urlpipe": {
"url": "https://urlpipe.dev/mcp",
"headers": {
"Authorization": "Bearer ${env:URLPIPE_MCP_TOKEN}"
}
}
}
}
VS Code
{
"inputs": [
{
"type": "promptString",
"id": "urlpipe-token",
"description": "URLpipe MCP token",
"password": true
}
],
"servers": {
"urlpipe": {
"type": "http",
"url": "https://urlpipe.dev/mcp",
"headers": {
"Authorization": "Bearer ${input:urlpipe-token}"
}
}
}
}
Windsurf
{
"mcpServers": {
"urlpipe": {
"serverUrl": "https://urlpipe.dev/mcp",
"headers": {
"Authorization": "Bearer ${env:URLPIPE_MCP_TOKEN}"
}
}
}
}
Claude Desktop
O arquivo de configuração do Claude Desktop inicia servidores locais, então um servidor remoto com cabeçalho bearer passa pela ponte mcp-remote, que precisa de Node.js. O espaço do cabeçalho fica na variável de ambiente porque alguns clientes não escapam espaços em argumentos:
{
"mcpServers": {
"urlpipe": {
"command": "npx",
"args": [
"mcp-remote",
"https://urlpipe.dev/mcp",
"--header",
"Authorization:${AUTH_HEADER}"
],
"env": {
"AUTH_HEADER": "Bearer YOUR_TOKEN"
}
}
}
}
Qualquer outro cliente que fale HTTP streamable segue o formato genérico na documentação do MCP. Mantenha o token fora de arquivos que você commita — os exemplos acima o leem de uma variável de ambiente ou de um prompt onde o cliente suporta.
Ou instale a partir de um diretório
O servidor está listado nos diretórios MCP, que o configuram para você nos clientes que suportam, e no Registro MCP oficial como dev.urlpipe/mcp. Sua entrada no registro e a configuração para cada cliente acima são código aberto no GitHub.
Smithery Glama cursor.directory GitHub: URLpipe/mcp
Ferramentas
As 14 ferramentas
Nove são os endpoints da API, com os mesmos argumentos e as mesmas respostas. Cinco existem apenas aqui.
| Ferramenta | O que retorna | Créditos |
|---|---|---|
| fetch_markdown | O conteúdo principal da página como Markdown | 1 |
| fetch_html | O HTML renderizado, após JavaScript | 1 |
| capture_screenshot | Uma captura de tela de página inteira, como uma imagem que o modelo pode ver | 1 |
| capture_console_errors | Erros, avisos e exceções não capturadas que a página registra | 1 |
| run_lighthouse_audit | Pontuações Lighthouse e métricas de laboratório Core Web Vitals | 2 |
| extract_metadata | Título, descrição, autor, datas, imagem, favicon, feed | 1 |
| extract_keywords | Palavras-chave da página, por um modelo de IA | 15 |
| summarize_page | Um resumo da página, por um modelo de IA | 17 |
| scrape_url | Vários dos acima em uma única visita à página | soma de suas operações |
| list_projects | Seus projetos e seus ids — cada fetch nomeia um | 0 |
| get_usage | Créditos usados e restantes, data de redefinição, lista de preços | 0 |
| get_result | O resultado de uma chamada anterior, por token | 0 |
| list_requests | O que um projeto já buscou, filtrável por rótulo | 0 |
| get_request | Uma solicitação em detalhes: tempos, opções, entrega de webhook | 0 |
Diga ao seu agente uma vez: fetch_markdown custa 1 crédito e summarize_page custa 17 créditos. Se o agente vai ler a página por conta própria, Markdown é mais barato e melhor entrada; as ferramentas de IA são para quando o resumo ou a lista de palavras-chave é o que você está produzindo. O servidor diz o mesmo ao modelo quando ele se conecta.
Comportamento
Assíncrono por padrão, mesmo para um agente
Uma chamada de ferramenta retorna um token imediatamente e o trabalho continua em segundo plano, exatamente como a API HTTP faz. Passe sync: true quando o agente deve esperar e receber o resultado; caso contrário, ele coleta o resultado com get_result. Uma chamada assíncrona também entrega ao webhook do projeto se um estiver configurado, então um agente pode iniciar um trabalho que seu backend recebe.
Cada ferramenta de endpoint aceita project_id e url, além das opções que seu endpoint aceita — page_options, screenshot_options, max_age, residential, labels e idempotency_key para novas tentativas seguras. Resultados armazenados são reutilizados gratuitamente, então um agente que relê uma página que leu ontem não gasta nada.
Acesso
Tokens, escopos e limites
- Tokens de organização. Um token alcança todos os projetos da organização, por isso cada fetch nomeia um
project_id. Você pode restringir um token a um projeto. - Escopo somente leitura. Um token pode ser limitado a ler resultados passados, uso e projetos. Ele não pode buscar uma página, então não pode gastar créditos.
- Expiração. Dê uma data de término ao token, ou exclua-o para revogá-lo imediatamente. Ele é mostrado uma vez e armazenado como hash.
- Limites. 300 chamadas por 5 minutos por token — confortavelmente acima de uma por segundo, sustentado — e o limite de solicitações paralelas do seu plano.
- A mesma conta. Uma chamada MCP gasta exatamente o que o endpoint correspondente gasta, da mesma cota. Fetches com falha e resultados reutilizados são gratuitos.
Limites
O que ele não faz
- Sem navegação interativa. O agente não pode clicar, digitar, fazer login ou preencher formulários. Cada ferramenta carrega uma URL pública e relata o que encontrou.
- Sem crawling. Ele não descobre nem segue links por conta própria; o agente decide quais URLs buscar.
- Sem login OAuth. A autenticação é um cabeçalho bearer; clientes que só suportam conector OAuth precisam da ponte mostrada para Claude Desktop.
- Apenas páginas públicas. Endereços privados, loopback e intranet são recusados.
Preços
Quanto custa
| Chamada | Créditos | Gratuito (chamadas/mês) | Starter (chamadas/mês) | Pro (chamadas/mês) | Scale (chamadas/mês) |
|---|---|---|---|---|---|
| /markdown | 1 crédito | 1.000 | 20.000 | 55.000 | 175.000 |
| /screenshot | 1 crédito | 1.000 | 20.000 | 55.000 | 175.000 |
| /meta | 1 crédito | 1.000 | 20.000 | 55.000 | 175.000 |
Acessos de cache e solicitações com falha não custam nada. Planos pagos nunca são cortados: além da cota, créditos extras custam $1,50 por 1.000 créditos. Veja todos os planos.
Endpoints
Os endpoints nesta página
- Transforme qualquer URL em Markdown limpo Cole um link e obtenha o conteúdo principal da página como Markdown organizado — cabeçalhos, listas, links e código preservados, navegação e banners de cookies removidos. O formato com que LLMs e pipelines de RAG trabalham melhor. Experimente grátis
- Capture tela de qualquer site a partir da URL Cole um link e obtenha um PNG de página inteira da página renderizada — JavaScript executado, exatamente como um navegador real desenharia. Ótimo para prévias, monitoramento e QA visual. Experimente grátis
- Verifique as tags Open Graph e metadados de uma página Cole um link e veja tudo que a página diz sobre si mesma — título, descrição, imagem de compartilhamento, autores, datas, idioma, ícones e feeds — como um único objeto estruturado. Experimente grátis
FAQ
Perguntas frequentes
Este servidor MCP renderiza JavaScript?
Sim. Toda ferramenta que lê uma página a carrega em Chrome headless e deixa seus scripts executarem primeiro, então aplicativos de página única retornam com seu conteúdo — ao contrário do servidor de fetch de referência, que faz um HTTP GET simples.
Preciso instalar algo?
Não. É um servidor remoto de HTTP streamable: forneça ao seu cliente a URL https://urlpipe.dev/mcp e um cabeçalho Authorization: Bearer. Apenas clientes que iniciam servidores locais a partir de um arquivo de configuração, como Claude Desktop, precisam da ponte mcp-remote.
Quanto custa?
Os mesmos créditos da API HTTP, da mesma cota mensal — fetch_markdown custa 1 crédito, capture_screenshot 1 crédito, extract_metadata 1 crédito. O plano gratuito também funciona com MCP.
O agente pode ver capturas de tela?
Sim. capture_screenshot retorna a imagem como um bloco de conteúdo de imagem MCP, então um modelo que aceita imagens olha para a página em vez de segurar uma string base64. Um link sem chave para a imagem retorna ao lado dela.
Posso impedir um agente de gastar créditos?
Crie o token com o escopo somente leitura. Ele pode listar projetos, verificar uso e ler resultados que já foram pagos, e não pode buscar uma página.
Por que minha chamada de ferramenta retornou um token em vez de um resultado?
Assíncrono é o padrão, como na API HTTP. Passe sync: true para esperar o resultado, ou colete depois com get_result e o token.
Conecte seu agente em dois minutos.
Plano gratuito, sem cartão. Confirme seu e-mail e sua chave de API estará ativa — você fará solicitações reais em minutos.