MrScraper
oficialBusque 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
webSearche 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
statuspara 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
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.
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.
|
Adicionar ao Cursor Instalação com um clique. |
Adicionar ao VS Code Instalação com um clique. |
Obter o plugin do JetBrains Para agentes de IA do JetBrains. |
|
Adicionar ao Claude Como conector personalizado. |
Adicionar ao Claude Code Um comando. |
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
| Ferramenta | O que faz |
|---|---|
scraperAPI | Recupera 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. |
webSearch | Executa 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. |
status | Retorna 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
| Escopo | Permite |
|---|---|
scrape:read | webSearch |
scrape:write | scraperAPI |
account:read | status |
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
- Documentação: https://docs.mrscraper.com/docs/getting-started/mcp-server
- Código-fonte: https://github.com/mrscraper-com/mrscraper-mcp
- Registro oficial do MCP:
io.github.mrscraper-com/mrscraper-mcp - Política de privacidade: https://mrscraper.com/privacy-policy
- Termos de uso: https://mrscraper.com/terms-of-use
- Suporte: support@mrscraper.com