MrScraper

oficial

Busque qualquer página pública da web em Markdown, HTML ou como captura de tela com renderização automática no navegador, pesquise na web por resultados analisados e confira o uso do plano.

O que você pode fazer com MrScraper MCP?

  • Busque páginas como Markdown, HTML ou capturas de tela — Peça ao seu assistente para recuperar qualquer URL pública em um ou todos esses formatos por meio de scraperAPI.
  • Lide com páginas renderizadas pelo navegador — Solicite a renderização automática no navegador, aguarde o aparecimento de um seletor CSS ou carregue uma página de um país escolhido.
  • Pesquise na web — Execute uma consulta ou uma URL completa de resultados de pesquisa por meio de webSearch e obtenha resultados analisados com classificação, título, link e trecho.
  • Compare diferentes sites — Combine pesquisas e leituras de páginas para comparar preços, produtos ou páginas de documentação, mantendo as fontes para consulta.
  • Confira o uso do plano — Peça status para consultar seu plano, limite de tokens, tokens usados, tokens restantes e limite de requisições.

Servidor MCP hospedado

npx add-mcp 'https://mcp.mrscraper.com/mcp'

Instala no Claude Code, Codex, Cursor e outros

Documentação

MrScraper

Servidor MCP do MrScraper

O servidor oficial do Model Context Protocol (MCP) para o MrScraper: forneça dados da web em tempo real ao seu assistente de IA. Leia qualquer página pública como Markdown, HTML ou captura de tela, pesquise na web e confira o uso do seu plano por meio de um endpoint hospedado com login pelo navegador ou de um servidor local que você mesmo executa.

Official MrScraper server npm version License: MIT Hosted at mcp.mrscraper.com

Model Context Protocol compatible MCP Registry: io.github.mrscraper-com/mrscraper-mcp Auth: OAuth 2.1 or API key Transport: Streamable HTTP or stdio

scraperAPI: HTML, Markdown, screenshot webSearch: parsed results status: plan usage

Documentação · Referência das ferramentas · Segurança · Suporte


O MCP do MrScraper conecta assistentes e agentes de IA ao serviço de dados da web do MrScraper. Depois de conectado, seu assistente pode recuperar qualquer página pública da web, descobrir páginas por meio de pesquisas na web e verificar quantos tokens restam no seu plano, sem que você precise copiar páginas para o chat.

Com o MCP do MrScraper, você pode:

  • Ler uma página. Buscar uma página pública como Markdown, HTML ou captura de tela, ou os três formatos de uma só vez.
  • Ler páginas que precisam de um navegador. A renderização no navegador é iniciada automaticamente quando uma página precisa dela; você também pode aguardar a exibição de um elemento e carregar a página a partir de um país escolhido.
  • Pesquisar na web. Obter resultados analisados (posição, título, link, trecho) para uma consulta e, em seguida, buscar as páginas necessárias.
  • Pesquisar e comparar. Combinar pesquisas e leituras de páginas para comparar páginas de preços, produtos ou documentação em diferentes sites, mantendo as páginas de origem como referência.
  • Conferir seu uso. Perguntar quantos tokens restam no seu plano.

Configuração com um clique

Escolha seu cliente de IA. Na primeira vez que você usar uma ferramenta, cada cliente fará seu login no MrScraper pelo navegador, sem precisar colar uma chave de API.

Add to Cursor
Adicionar ao Cursor

Instalação com um clique.
Add to VS Code
Adicionar ao VS Code

Instalação com um clique.
Get the JetBrains plugin
Obter o plugin do JetBrains

Para agentes de IA do JetBrains.
Add to Claude
Adicionar ao Claude

Como conector personalizado.
Add to Claude Code
Adicionar ao Claude Code

Um comando.
Add to Codex
Adicionar ao Codex

Um comando.

Deixe seu agente fazer a configuração

A maioria dos agentes de programação com IA consegue configurar o servidor por conta própria. Cole este prompt no seu agente:

Connect MrScraper MCP to this agent. Detect the current MCP client and configure a Streamable HTTP server named mrscraper at https://mcp.mrscraper.com/mcp with no credential. The server uses OAuth 2.1, so the client will open a browser to sign in. If the client cannot do OAuth, fall back to a MrScraper API key from https://app.mrscraper.com/api-tokens stored through the client's environment-variable or secret-storage mechanism and sent as Authorization: Bearer <key>. Reload the MCP client when required, then list the tools and confirm that scraperAPI, webSearch, and status are the only available tools.

Ferramentas

FerramentaO que faz
scraperAPIRecupera uma URL conhecida como HTML, Markdown, captura de tela ou uma combinação desses formatos. As opções incluem renderização no navegador, espera por um seletor CSS, país, tempo limite e limites de novas tentativas.
webSearchExecuta uma pesquisa na web a partir do texto da consulta ou de uma URL completa de resultados de pesquisa e retorna JSON analisado ou o HTML da página de resultados. As opções incluem região, idioma e página.
statusRetorna o plano da conta, o limite de tokens, o uso de tokens, os tokens restantes e o limite de taxa.

As ferramentas da web são somente para leitura. Hosts compatíveis com MCP Apps também exibem um widget de resultados de pesquisa e um medidor de uso da conta.

Conectar manualmente

Endpoint (HTTP com streaming):

https://mcp.mrscraper.com/mcp

Adicione a URL ao seu cliente MCP sem credenciais. O cliente abre o navegador; você faz login no MrScraper e aprova o acesso, e o cliente armazena os tokens. Use a URL exatamente como exibida, incluindo /mcp.

Claude Code:

claude mcp add --transport http --scope user mrscraper https://mcp.mrscraper.com/mcp

Codex:

codex mcp add mrscraper --url https://mcp.mrscraper.com/mcp

Clientes configurados por arquivo:

{
  "mcpServers": {
    "mrscraper": {
      "url": "https://mcp.mrscraper.com/mcp"
    }
  }
}

Permissões que você aprova

EscopoPermite
scrape:readwebSearch
scrape:writescraperAPI
account:readstatus

Você pode desconectar um cliente a qualquer momento em Aplicativos conectados na sua conta do MrScraper.

Usar uma chave de API

Clientes sem OAuth podem enviar uma chave de API do MrScraper, criada em app.mrscraper.com/api-tokens, como token bearer:

{
  "mcpServers": {
    "mrscraper": {
      "url": "https://mcp.mrscraper.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MRSCRAPER_API_KEY"
      }
    }
  }
}

Uma chave de API concede acesso completo à sua conta. Mantenha-a no armazenamento de segredos ou de variáveis de ambiente do seu cliente, nunca em um arquivo de projeto compartilhado.

Executar localmente

O mesmo servidor é de código aberto e publicado no npm como @mrscraper/mcp. As configurações locais usam uma chave de API do MrScraper em vez do login pelo navegador.

# stdio, for clients that start a local process; reads the key from MRSCRAPER_API_KEY
MRSCRAPER_API_KEY=YOUR_MRSCRAPER_API_KEY npx -y @mrscraper/mcp@latest

# local Streamable HTTP service; clients send the key as a bearer token
TRANSPORT=http npx -y @mrscraper/mcp@latest

Plugins

O MrScraper também está disponível como plugin com o servidor MCP e habilidades para Claude Code e JetBrains IDEs.

Dados e uso

  • É necessária uma conta do MrScraper. Cada chamada consome tokens do seu plano; consulte mrscraper.com/pricing.
  • O MrScraper recebe as URLs e as entradas das ferramentas que você envia, incluindo consultas de pesquisa, e retorna os resultados ao seu cliente.
  • Recupere apenas conteúdo ao qual você tem permissão de acesso e siga os termos de cada site e a Política de Uso Aceitável do MrScraper.

Links