AlterLab

Extraia dados de qualquer site, extraia dados estruturados e capture capturas de tela, com renderização de JavaScript, rotação de proxies residenciais e tentativas automáticas.

GitHub

Documentação

AlterLab MCP Server

Dê a Claude, Cursor e Windsurf a capacidade de fazer scraping de qualquer site, extrair dados estruturados e tirar capturas de tela — com bypass automático de anti-bot.

Comece Grátis → Saldo grátis de $1 no cadastro — até 5.000 extrações.

Instalação em Uma Linha

Claude Code

claude mcp add alterlab -- npx -y alterlab-mcp-server@latest

Depois defina sua chave de API: export ALTERLAB_API_KEY=sk_live_... ou adicione-a a .claude.json (veja configuração completa abaixo).

Cursor

# Add to .cursor/mcp.json — see full config below

Smithery

npx -y @smithery/cli install alterlab-mcp-server --client claude

Por que AlterLab em Vez de WebFetch ou Browser MCP?

A ferramenta integrada do Claude WebFetch e os servidores MCP de navegador de código aberto falham na maioria dos sites reais. Eles não conseguem contornar o Cloudflare, renderizar SPAs JavaScript ou extrair dados estruturados.

O AlterLab substitui ferramentas de fetch quebradas por um servidor MCP que realmente funciona:

Capacidade	WebFetch / fetch()	Browser MCP	AlterLab MCP
Bypass anti-bot (Cloudflare, DataDome, Akamai)	Não	Parcial	Sim — automático
Renderização JavaScript (SPAs React, Angular, Vue)	Não	Sim (lento)	Sim — Chromium headless
Extração de dados estruturados (JSON, Schema.org)	Não	Não	Sim — perfis integrados
Escalonamento inteligente de camadas (método mais barato primeiro)	N/A	N/A	Sim — economiza 60-80%
Rotação de proxy residencial (195+ países)	Não	Não	Sim
Captura de screenshot e PDF	Não	Somente screenshot	Sim — ambos
Extração de texto OCR de imagens	Não	Não	Sim
Custo por requisição	Grátis (mas falha)	Grátis (mas lento)	A partir de $0.0002

Como Funciona a Extração de Dados do AlterLab?

O AlterLab usa uma arquitetura de extração em múltiplas camadas. Ele seleciona automaticamente o método mais barato capaz de buscar cada URL:

Curl ($0.0002/req) — HTTP direto para páginas estáticas, feeds RSS, APIs públicas
HTTP ($0.0003/req) — Rotação de impressão digital TLS para sites moderadamente protegidos
Stealth ($0.0005/req) — Impersonação de navegador para sites protegidos por Cloudflare/DataDome
Light JS ($0.0007/req) — Extração JS leve de HTML renderizado no servidor
Browser ($0.001/req) — Chromium headless completo para SPAs com muito JavaScript

O modo automático começa na Camada 1 e escala somente quando bloqueado. A maioria dos sites é resolvida nas Camadas 1-2, então $1 rende de 1.000 a 5.000 extrações dependendo dos sites que você almeja.

Instalação

Instalar no Claude Desktop / Claude Code

Adicione ao seu arquivo de configuração do Claude (~/.claude.json para Claude Code, ou Configurações para Claude Desktop):

{
  "mcpServers": {
    "alterlab": {
      "command": "npx",
      "args": ["-y", "alterlab-mcp-server@latest"],
      "env": {
        "ALTERLAB_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

Instalar no Cursor

Adicione a .cursor/mcp.json na raiz do seu projeto:

{
  "mcpServers": {
    "alterlab": {
      "command": "npx",
      "args": ["-y", "alterlab-mcp-server@latest"],
      "env": {
        "ALTERLAB_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

Instalar no Windsurf

Adicione às configurações MCP do Windsurf (~/.codeium/windsurf/mcp_config.json):

{
  "mcpServers": {
    "alterlab": {
      "command": "npx",
      "args": ["-y", "alterlab-mcp-server@latest"],
      "env": {
        "ALTERLAB_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

Instalar via Smithery

npx -y @smithery/cli install alterlab-mcp-server --client claude

Obtenha Sua Chave de API

Cadastre-se grátis — saldo grátis de $1 no cadastro
Vá para Dashboard → API Keys e copie sua chave
Cole-a no campo ALTERLAB_API_KEY na sua configuração MCP

Ferramentas

`alterlab_scrape` — Extraia Qualquer Página Web

Extraia uma URL e retorne seu conteúdo como markdown, texto, HTML ou JSON. Lida automaticamente com proteção anti-bot com escalonamento de camadas. Retorna markdown por padrão — otimizado para janelas de contexto de LLM.

"Scrape https://www.amazon.com/dp/B0BSHF7WHW and summarize the product"

Parâmetro	Tipo	Padrão	Descrição
`url`	string	obrigatório	URL para extrair
`mode`	`auto` \| `html` \| `js` \| `pdf` \| `ocr`	`auto`	Modo de extração
`formats`	`(text\|json\|html\|markdown)[]`	`["markdown"]`	Formatos de saída
`render_js`	boolean	`false`	Usar navegador headless (+3 créditos)
`use_proxy`	boolean	`false`	Proxy premium (+1 crédito)
`proxy_country`	string	—	Código de país ISO para geo-direcionamento (ex.: `US`, `DE`)
`wait_for`	string	—	Seletor CSS para aguardar antes da extração
`timeout`	number	`90`	Tempo limite em segundos (1-300)
`include_raw_html`	boolean	`false`	Incluir HTML bruto junto com o conteúdo formatado
`session_id`	string (UUID)	—	ID de sessão armazenada para extração autenticada
`cookies`	`Record<string, string>`	—	Cookies inline para requisições autenticadas pontuais

`alterlab_extract` — Extraia Dados Estruturados

Extraia campos estruturados de qualquer página web usando perfis pré-construídos ou JSON Schema personalizado. Retorna JSON limpo — pronto para bancos de dados, planilhas ou processamento downstream.

"Extract the product name, price, and rating from this Amazon page"

Parâmetro	Tipo	Padrão	Descrição
`url`	string	obrigatório	URL para extrair
`extraction_profile`	enum	`auto`	Perfil: `product`, `article`, `job_posting`, `faq`, `recipe`, `event`
`extraction_schema`	object	—	JSON Schema personalizado para saída estruturada
`extraction_prompt`	string	—	Instruções de extração em linguagem natural
`render_js`	boolean	`false`	Usar navegador headless
`use_proxy`	boolean	`false`	Proxy premium

Perfis de extração:

Produto — nome, preço, moeda, avaliação, comentários, disponibilidade, imagens, descrição
Artigo — título, autor, data de publicação, texto do corpo, imagem em destaque
Vaga de Emprego — título, empresa, localização, salário, descrição, requisitos
FAQ — pares de pergunta-resposta
Receita — ingredientes, instruções, tempo de preparo, porções
Evento — nome, data, local, descrição, organizador

`alterlab_screenshot` — Capture Qualquer Página

Tire um screenshot de página inteira de qualquer URL. Retorna uma imagem PNG diretamente na conversa — sem URLs para copiar, sem arquivos para baixar.

"Take a screenshot of our landing page at https://alterlab.io"

Parâmetro	Tipo	Padrão	Descrição
`url`	string	obrigatório	URL para capturar
`wait_for`	string	—	Seletor CSS para aguardar antes da captura
`wait_until`	enum	`networkidle`	`networkidle`, `domcontentloaded` ou `load`

`alterlab_estimate_cost` — Estime Antes de Extrair

Verifique quanto uma extração custará antes de executá-la. Retorna a camada prevista, o custo por requisição e o nível de confiança.

"How much would it cost to scrape linkedin.com?"

Parâmetro	Tipo	Padrão	Descrição
`url`	string	obrigatório	URL para estimar
`mode`	enum	`auto`	Modo de extração
`render_js`	boolean	`false`	Incluir custo de renderização JS
`use_proxy`	boolean	`false`	Incluir custo de proxy

`alterlab_check_balance` — Verifique Seus Créditos

Verifique o saldo da sua conta, o total depositado e o total gasto. Nenhum parâmetro necessário.

"Check my AlterLab balance"

`alterlab_list_sessions` — Listar Sessões Armazenadas

Liste todas as sessões armazenadas para extração autenticada. As sessões contêm cookies para domínios específicos, permitindo extrair conteúdo atrás de muros de login.

"List my stored sessions"

`alterlab_create_session` — Criar uma Sessão

Crie uma nova sessão armazenada com cookies de um navegador conectado. A sessão é armazenada com segurança e pode ser reutilizada em várias requisições de extração.

"Create an Amazon session with these cookies: session-id=abc123, session-token=xyz789"

Parâmetro	Tipo	Padrão	Descrição
`name`	string	obrigatório	Nome legível por humanos (ex.: "Minha Conta Amazon")
`domain`	string	obrigatório	Domínio (ex.: "amazon.com")
`cookies`	`Record<string, string>`	obrigatório	Pares chave-valor de cookies
`user_agent`	string	—	User-Agent do navegador a usar com esta sessão

`alterlab_validate_session` — Validar uma Sessão

Verifique se uma sessão armazenada ainda está ativa e se seus cookies são válidos.

"Is my Amazon session still valid?"

Parâmetro	Tipo	Padrão	Descrição
`session_id`	string (UUID)	obrigatório	ID da sessão para validar

`alterlab_delete_session` — Excluir uma Sessão

Exclua permanentemente uma sessão armazenada e seus cookies.

"Delete session abc-123-def"

Parâmetro	Tipo	Padrão	Descrição
`session_id`	string (UUID)	obrigatório	ID da sessão para excluir

Extração Autenticada

O AlterLab MCP suporta extração de páginas que exigem autenticação. Isso permite que agentes de IA acessem conteúdo específico do usuário, como históricos de pedidos, painéis de conta e preços exclusivos para membros.

Como Funciona

Crie uma sessão com cookies de um navegador conectado usando alterlab_create_session
Extraia páginas autenticadas passando o session_id para alterlab_scrape
Gerencie sessões com as ferramentas de listar, validar e excluir

Exemplo: Verificar Preços do Amazon Prime

User: "What's my Prime member price for this product?"

Claude: [calls alterlab_list_sessions → finds Amazon session]
Claude: [calls alterlab_scrape with session_id for authenticated pricing]
Claude: "The Prime member price is $24.99 (public price: $34.99)"

Cookies Inline vs Sessões Armazenadas

Sessões armazenadas (session_id): Melhor para acesso repetido ao mesmo domínio. Crie uma vez, reutilize em várias requisições.
Cookies inline (cookies): Melhor para requisições autenticadas pontuais onde você não precisa salvar a sessão.

O Que Você Pode Fazer com o AlterLab MCP?

Pesquisa e Análise

Peça ao Claude para extrair e analisar sites em tempo real:

"Extraia os 5 principais resultados desta pesquisa do Google e resuma-os"
"Extraia todos os preços de produtos desta página de categoria da Amazon"
"Compare as páginas de preços desses 3 concorrentes"

Geração de Código com Dados Reais

Deixe o Cursor ou Windsurf buscar dados ao vivo enquanto você desenvolve:

"Extraia esta página de documentação de API e gere tipos TypeScript a partir dela"
"Extraia a paleta de cores deste site e crie uma configuração Tailwind"
"Capture um screenshot deste design e recrie-o em React"

Conteúdo e SEO

Use o Claude para analisar conteúdo em escala:

"Extraia este post de blog e sugira melhorias para SEO"
"Extraia todas as entradas de FAQ deste centro de ajuda e crie um conjunto de dados estruturado"
"Compare nossa landing page com a do concorrente e identifique lacunas"

Monitoramento e Alertas

Construa fluxos de trabalho agênticos que observam a web:

"Verifique se este produto voltou ao estoque"
"Extraia esta página diariamente e me alerte quando o preço cair abaixo de $50"
"Monitore este quadro de vagas para novas posições de engenharia sênior"

Preços — Extração de Dados com Pagamento por Uso

Sem assinaturas. Sem mínimos mensais. Adicione saldo e use quando precisar.

Custos Base de Extração

Camada	Método	Custo por Requisição	Caso de Uso
Curl	HTTP direto	$0.0002	Páginas estáticas, feeds RSS, APIs públicas
HTTP	Impressão digital TLS	$0.0003	Sites com detecção básica de bot
Stealth	Impersonação de navegador	$0.0005	Sites protegidos por Cloudflare, DataDome, PerimeterX
Light JS	Extração JSON	$0.0007	Páginas renderizadas no servidor que precisam de dados estruturados
Browser	Chromium headless	$0.001	SPAs JavaScript completos (React, Angular, Vue)

Complementos Opcionais

Complemento	Custo Extra	Descrição
Renderização JavaScript	+$0.0006	Chromium headless para conteúdo dinâmico
Captura de Screenshot	+$0.0002	Screenshot PNG de página inteira
Proxy Premium	+$0.0002	Proxy residencial com geo-direcionamento (195+ países)
Extração de Texto OCR	+$0.001	Extrair texto de imagens na página

$1 = 5.000 extrações leves. Novas contas recebem saldo grátis de $1 no cadastro.

Variáveis de Ambiente

Variável	Obrigatório	Padrão	Descrição
`ALTERLAB_API_KEY`	Sim	—	Sua chave de API (obtenha uma gratuitamente)
`ALTERLAB_API_URL`	Não	`https://api.alterlab.io`	URL base da API (para self-hosted ou desenvolvimento)

Perguntas Frequentes

Como adiciono web scraping ao Claude, Cursor ou Windsurf?

Instale o servidor MCP da AlterLab. Para o Claude Code, execute claude mcp add alterlab -- npx -y alterlab-mcp-server@latest e defina seu ALTERLAB_API_KEY. Para Claude Desktop, Cursor ou Windsurf, adicione o bloco de configuração JSON ao seu arquivo de configurações MCP. Uma vez configurado, seu assistente de IA pode fazer scraping de qualquer URL, extrair dados estruturados e tirar screenshots diretamente na conversa.

O Claude consegue fazer scraping de sites protegidos por Cloudflare ou proteção anti-bot?

Sim. A AlterLab lida automaticamente com Cloudflare, DataDome, PerimeterX, Akamai e outros sistemas anti-bot. Ela usa uma abordagem em múltiplas camadas que começa com o método mais barato e só aumenta quando há bloqueio. Você não precisa configurar nada — o bypass anti-bot é totalmente automático.

O que é um servidor MCP e como ele funciona com o Claude?

MCP (Model Context Protocol) é o padrão aberto da Anthropic para conectar assistentes de IA a ferramentas externas e fontes de dados. Um servidor MCP é um pequeno programa que expõe ferramentas — como web scraping — que o Claude, Cursor ou Windsurf podem chamar durante uma conversa. O servidor MCP da AlterLab dá ao seu assistente de IA 23 ferramentas: scrape, extract, screenshot, crawl, search, map, scraping em lote, gerenciamento de sessões, recursos beta e muito mais.

Como a AlterLab se diferencia dos servidores MCP Firecrawl, ScrapingBee ou Apify?

A AlterLab começa em US$ 0,0002 por requisição — 5 a 20 vezes mais barato que a maioria das APIs de scraping — porque só usa renderização de navegador cara quando um site realmente exige. A escalada inteligente de camadas significa que você paga pelo que cada site precisa, não pelo máximo. A AlterLab também inclui extração de dados estruturados integrada com perfis pré-construídos (produto, artigo, vaga de emprego, etc.) sem custo adicional.

Posso fazer scraping de Amazon, Walmart e outros sites de e-commerce pelo Claude?

Sim. A AlterLab lida com toda a proteção anti-bot dos principais sites de e-commerce. Use a ferramenta alterlab_extract com extraction_profile: "product" para obter JSON estruturado: nome do produto, preço, moeda, avaliação, número de avaliações, disponibilidade e imagens — pronto para análise, comparação ou pipelines de dados.

O Cursor consegue fazer scraping de documentação e gerar código a partir dela?

Sim. Com o MCP da AlterLab instalado no Cursor, você pode pedir para ele fazer scraping de documentação de API, documentação de bibliotecas ou qualquer página de referência e gerar tipos TypeScript, clientes de API ou código de componentes a partir do conteúdo ao vivo. Isso é mais confiável do que depender dos dados de treinamento do LLM, que podem estar desatualizados.

O MCP da AlterLab funciona com sites com muito JavaScript (React, Angular, Vue)?

Sim. Use render_js: true ou defina mode: "js" para ativar a renderização completa do Chromium headless. A AlterLab renderiza a página completa incluindo todo o JavaScript, aguarda o carregamento do conteúdo dinâmico e então extrai o conteúdo do DOM totalmente renderizado. Isso funciona para React, Angular, Vue, Next.js e qualquer outro framework JavaScript.

Qual formato de saída é melhor para janelas de contexto de IA e LLM?

Use markdown (o padrão). Ele preserva a estrutura do documento — cabeçalhos, tabelas, listas, links — sendo 60-80% menor que o HTML bruto. Claude, GPT-4 e outros LLMs processam markdown significativamente melhor que HTML. A saída em markdown da AlterLab é especificamente otimizada para janelas de contexto de LLM.

Existe limite de requisições?

Contas no plano gratuito têm limites de requisições. Adicionar qualquer saldo remove os limites. O servidor MCP inclui nova tentativa automática com backoff exponencial para erros transitórios de limite de requisições (429).

Posso usar este servidor MCP para scraping em larga escala?

Sim. Para scraping paralelo, use alterlab_batch para fazer scraping de até 100 URLs em uma única requisição — muito mais rápido que chamadas sequenciais. Para crawling de domínios inteiros, use alterlab_crawl. Você também pode criar workflows agênticos que fazem scraping de muitas URLs sequencialmente, ou usar a integração com n8n para automação de workflows.

Tratamento de Erros

O servidor MCP retorna mensagens de erro úteis com próximas ações sugeridas:

Erro	O que Acontece	Ação Sugerida
401 Não autorizado	Chave de API inválida	Verifique se `ALTERLAB_API_KEY` está definido corretamente
402 Créditos insuficientes	Saldo muito baixo	Execute `alterlab_check_balance`, adicione fundos
403 Proibido	O site bloqueou a requisição	Tente `render_js: true` + `use_proxy: true`
429 Limite de requisições	Muitas requisições	Nova tentativa automática com backoff
504 Timeout do gateway	O scraping demorou demais	Aumente `timeout`, simplifique a requisição

Workflows Agênticos — Agentes de IA que Fazem Scraping na Web

O MCP da AlterLab transforma qualquer agente de IA em um agente com capacidade web. Em vez de depender de dados de treinamento desatualizados, seu agente pode buscar informações ao vivo de qualquer site durante a execução.

Casos de Uso para Agentes de IA

Agentes de pesquisa — fazem scraping de múltiplas fontes, cruzam referências de fatos, geram relatórios com citações
Agentes de pipeline de dados — extraem dados estruturados de produtos/preços/vagas em uma programação
Inteligência competitiva — monitoram páginas de concorrentes, acompanham mudanças de preços, detectam novos recursos
Geração de conteúdo — fazem scraping de dados reais para fundamentar a saída do LLM em fatos, não em alucinações
Enriquecimento de leads — fazem scraping de sites de empresas para enriquecer registros de CRM com dados ao vivo
Monitoramento de conformidade — verificam páginas regulatórias, termos de serviço e atualizações de políticas

Frameworks e Clientes de IA Compatíveis

Funciona com qualquer ferramenta que suporte MCP (Model Context Protocol):

Claude Desktop / Claude Code — assistente de IA da Anthropic
Cursor — editor de código com IA
Windsurf — IDE de IA da Codeium
Cline — assistente de IA do VS Code
GitHub Copilot — via configuração MCP
Agentes personalizados — qualquer framework que use o SDK MCP (Python, TypeScript, Go)
n8n — automação de workflows via n8n-nodes-alterlab

Contribuindo

git clone https://github.com/RapierCraft/alterlab-mcp-server.git
cd alterlab-mcp-server
npm install
npm run build

Suporte

Licença

MIT