Scrappa
Servidor MCP remoto para Claude, Cursor, VS Code e Windsurf com acesso a mais de 80 APIs de web scraping e extração de dados.
Documentação
API MCP de Web Scraping para Claude, Cursor e Agentes de IA
Conecte o Scrappa como um servidor MCP de web scraping remoto e dê ao Claude Desktop, Cursor, Codex, OpenCode, Gemini CLI, VS Code ou Windsurf acesso direto a mais de 80 APIs de scraping. Pesquise no Google, faça scraping do Google Maps, monitore avaliações, obtenha transcrições do YouTube e qualifique leads diretamente do seu cliente de IA.
URL do servidor MCP
Endpoint da API MCP de web scraping usando transporte streamable-HTTP. Autentique com o cabeçalho X-API-KEY do seu painel do Scrappa.
https://scrappa.co/mcp
Hub de scraping MCP
Comece pelo guia de integração e depois avance para a configuração específica do cliente e tutoriais de endpoints para Claude Desktop, Cursor, Google Maps, Google Search, YouTube e casos de uso de agentes.
[
Maps
Scraper do Google Maps
simple-search
Encontre lugares, enriqueça perfis de empresas e colete dados de avaliações para geração de leads e agentes de pesquisa de mercado local.
](https://scrappa.co/mcp/google-maps-scraper)[
Search
Scraper do Google Search
search
Forneça resultados SERP estruturados para Claude, Cursor e outros agentes de IA para monitoramento de rankings, pesquisas e acompanhamento de concorrentes.
](https://scrappa.co/mcp/google-search-scraper)[
Pesquise vídeos, obtenha metadados, colete comentários e recupere transcrições para fluxos de pesquisa de conteúdo.
](https://scrappa.co/mcp/youtube-scraper)[
Configuração do cliente
Configuração no Claude Desktop
mcp-remote
Copie e cole a configuração do mcp-remote e conecte o Claude Desktop ao Scrappa em menos de um minuto.
](https://scrappa.co/mcp/claude-desktop)[
Configuração do cliente
Configuração MCP no Cursor
cursor
Adicione o Scrappa ao Cursor para que o modo agente possa chamar ferramentas de web scraping enquanto você trabalha na IDE.
](https://scrappa.co/mcp/cursor)[
Casos de uso
Casos de uso de agentes
agent-workflows
Crie agentes de geração de leads, monitoramento de avaliações, pesquisa imobiliária e acompanhamento de SERP com dados web ao vivo.
](https://scrappa.co/mcp/use-cases)
WebMCP em scrappa.co
O Scrappa registra ferramentas WebMCP nativas do navegador em todas as páginas públicas e do painel. Agentes de navegador compatíveis podem pesquisar o catálogo público de endpoints ao vivo e abrir uma página validada de documentação ou playground do endpoint sem ler a interface visualmente.
search_scrappa_api_endpoints
Encontre endpoints por provedor, fonte ou caso de uso e retorne suas tags, rótulos de crédito, contagens de campos obrigatórios e links canônicos.
open_scrappa_api_endpoint
Abra a documentação ou o fluxo do playground para uma tag exata do catálogo. Esta ferramenta navega somente após a tag ser verificada no índice de endpoints do Scrappa.
Estas ferramentas do site não expõem chaves de API, alteram dados da conta, fazem compras ou executam solicitações pagas de scraping. O WebMCP é uma API experimental do navegador, então navegadores não compatíveis continuam usando o Scrappa normalmente.
O que é MCP?
O Model Context Protocol (MCP) é um padrão aberto que permite que assistentes de IA se conectem a ferramentas externas e fontes de dados. O servidor MCP de web scraping do Scrappa é um único endpoint remoto gerenciado — aponte qualquer cliente compatível com MCP para a URL MCP do Scrappa acima, informe sua chave de API, e sua IA poderá:
Clientes compatíveis
C
Claude Desktop
Aplicativo desktop oficial da Anthropic
C
Claude Mobile
Use autenticação baseada em URL quando cabeçalhos não estiverem disponíveis
Claude Code
Assistente de codificação de IA baseado em terminal
Codex
Agente de codificação da OpenAI na CLI e IDE
OpenCode
Agente de codificação de IA de terminal de código aberto
Gemini CLI
Assistente de IA de linha de comando do Google
Cu
Cursor
Editor de código com tecnologia de IA
Cu
VS Code
Modo agente do GitHub Copilot
Cu
Windsurf
Editor de código com tecnologia de IA
Pré-requisitos
1
Obtenha sua chave de API
Cadastre-se em scrappa.co e obtenha sua chave de API no painel.
2
Instale o Node.js para clientes baseados em ponte
Node.js 18+ só é necessário para clientes que usam mcp-remote: Claude Desktop, Cursor, VS Code e Windsurf. Codex, OpenCode e Gemini CLI conectam-se por meio da configuração MCP remota nativa.
Obrigatório antes da instalação
Obtenha a chave de API que você colará no MCP
Crie uma conta gratuita no Scrappa, copie a chave do painel e use-a em qualquer lugar onde este guia mostrar YOUR_SCRAPPA_API_KEY.
Verificação opcional
Teste uma solicitação ao vivo antes de configurar seu cliente
Abra o playground público, execute uma solicitação do Google Search ou Maps e confirme a estrutura JSON que seu agente de IA receberá por meio do MCP.
Instalação rápida
Usando Claude Code ou Gemini CLI? Execute o comando correspondente:
Claude Code
claude mcp add scrappa --transport http https://scrappa.co/mcp -H 'X-API-KEY: YOUR_SCRAPPA_API_KEY'
Gemini CLI
gemini mcp add --transport http --header 'X-API-KEY: YOUR_SCRAPPA_API_KEY' scrappa https://scrappa.co/mcp
Pronto! Reinicie seu cliente de IA e comece a usar as ferramentas do Scrappa.
Usando outra ferramenta? Veja as instruções detalhadas abaixo.
Claude Mobile e clientes sem cabeçalhos personalizados
Se seu cliente MCP não puder enviar o cabeçalho X-API-KEY, cole a chave de API na URL MCP. Prefira autenticação por cabeçalho quando o cliente suportar, pois URLs podem ser armazenadas no histórico do navegador, logs de proxy, análises, capturas de tela e tickets de suporte.
https://scrappa.co/mcp?X-API-KEY=YOUR_SCRAPPA_API_KEY
Ainda não está pronto para editar sua configuração MCP?
Execute os mesmos endpoints do Scrappa no playground primeiro e depois cole sua chave de API no Claude, Codex, Gemini CLI, Cursor, VS Code ou Windsurf.
Criar chave de API Testar playground
Instalação detalhada
Escolha sua ferramenta de IA e siga as instruções de instalação.
Adicione o seguinte ao arquivo de configuração do seu Claude Desktop:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"scrappa": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://scrappa.co/mcp", "--header", "X-API-KEY: YOUR_SCRAPPA_API_KEY"]
}
}
}
Execute este único comando no seu terminal:
claude mcp add scrappa --transport http https://scrappa.co/mcp -H 'X-API-KEY: YOUR_SCRAPPA_API_KEY'
É isso! Reinicie o Claude Code e você estará pronto.
Ou adicione ao arquivo .mcp.json do seu projeto:
{
"mcpServers": {
"scrappa": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://scrappa.co/mcp", "--header", "X-API-KEY: YOUR_SCRAPPA_API_KEY"]
}
}
}
Adicione ao arquivo de configuração do Codex:
Arquivo: ~/.codex/config.toml
[mcp_servers.scrappa]
url = "https://scrappa.co/mcp"
http_headers = { "X-API-KEY" = "YOUR_SCRAPPA_API_KEY" }
Adicione ao arquivo de configuração do OpenCode:
Arquivo: opencode.json na raiz do seu projeto, ou ~/.config/opencode/opencode.json para configuração global.
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"scrappa": {
"type": "remote",
"url": "https://scrappa.co/mcp",
"enabled": true,
"oauth": false,
"headers": {
"X-API-KEY": "YOUR_SCRAPPA_API_KEY"
}
}
}
}
Execute este comando no seu terminal:
gemini mcp add --transport http --header 'X-API-KEY: YOUR_SCRAPPA_API_KEY' scrappa https://scrappa.co/mcp
Ou adicione ao ~/.gemini/settings.json:
{
"mcpServers": {
"scrappa": {
"httpUrl": "https://scrappa.co/mcp",
"headers": {
"X-API-KEY": "YOUR_SCRAPPA_API_KEY"
}
}
}
}
Adicione à configuração MCP do Cursor:
Arquivo: ~/.cursor/mcp.json
{
"mcpServers": {
"scrappa": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://scrappa.co/mcp", "--header", "X-API-KEY: YOUR_SCRAPPA_API_KEY"]
}
}
}
Adicione às configurações do VS Code (settings.json):
{
"mcp": {
"servers": {
"scrappa": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://scrappa.co/mcp", "--header", "X-API-KEY: YOUR_SCRAPPA_API_KEY"]
}
}
}
}
Adicione ao arquivo de configuração MCP do Windsurf:
Arquivo: ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"scrappa": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://scrappa.co/mcp", "--header", "X-API-KEY: YOUR_SCRAPPA_API_KEY"]
}
}
}
Ferramentas disponíveis
O servidor MCP do Scrappa fornece as seguintes ferramentas ao seu assistente de IA:
G Google Search, Maps, Flights & Hotels
search - SERPs do Google
google-search-light - Pesquisa web leve
simple-search - Lugares do Google Maps (busca simples)
google-reviews - Avaliações do Google Maps
google-business-details - Perfil de empresa no Maps
google-flights-one-way - Busca de voos só de ida
google-flights-round-trip - Voos de ida e volta
google-hotels-search - Listagens e preços de hotéis
google-jobs - SERPs de empregos
google-news - Resultados do Google News
google-translate-api - Traduzir texto
google-images - Pesquisar imagens
google-videos - Pesquisar vídeos
★ Avaliações e reputação
trustpilot-company-reviews - Classificações e avaliações do Trustpilot
trustpilot-company-details - Perfil de empresa no Trustpilot
kununu-reviews - Avaliações de empregadores no Kununu
trustedshops-reviews - Avaliações do TrustedShops
jameda-reviews - Avaliações de médicos no Jameda
in Profissional e marketplace
linkedin-profile - Dados de perfil do LinkedIn
linkedin-company - Páginas de empresas no LinkedIn
linkedin-post - Detalhes de posts do LinkedIn
indeed-jobs - Listagens de empregos no Indeed
vinted-search - Pesquisa de produtos no Vinted
Exemplos de uso
Depois que o Scrappa estiver conectado, basta perguntar ao seu assistente de IA naturalmente. Estes prompts são fluxos reais de web scraping que as pessoas executam hoje por meio do Claude, Codex, Cursor e Gemini CLI:
"Pesquise no Google por 'melhor API de web scraping 2026' e resuma os 10 principais resultados"
"Obtenha avaliações do Google Maps para as três cafeterias mais bem avaliadas em Berlin Mitte"
"Obtenha a classificação do Trustpilot, o número de avaliações e as três avaliações mais recentes de stripe.com"
"Busque o perfil do LinkedIn e a empresa atual de https://linkedin.com/in/satyanadella"
"Obtenha a transcrição do YouTube de https://youtube.com/watch?v=... e transforme-a em um esboço de blog"
"Encontre empregos remotos sênior de Laravel no Indeed publicados nos últimos 7 dias e agrupe-os por faixa salarial"
"Compare preços do Google Flights BER → JFK para a próxima sexta-feira e a seguinte"
"Traduza esta descrição de produto para alemão, francês e espanhol"
Exemplos de código em TypeScript e Python
MCP é o caminho mais rápido para agentes de IA, mas toda ferramenta é suportada pela mesma API REST. Use chamadas diretas quando precisar de um job agendado, pipeline de enriquecimento de backend ou fixture de teste fora do cliente de IA.
TypeScript
const response = await fetch('https://api.scrappa.co/google-maps/simple-search?query=coffee%20shops%20Austin', {
headers: { 'X-API-KEY': process.env.SCRAPPA_API_KEY! }
});
const places = await response.json();
console.log(places);
Python
import os
import requests
response = requests.get(
'https://api.scrappa.co/google/search',
params={'query': 'best mcp scraper'},
headers={'X-API-KEY': os.environ['SCRAPPA_API_KEY']},
)
print(response.json())
Preços para uso do MCP
Chamadas MCP usam os mesmos créditos do Scrappa que chamadas de API REST. Não há plano MCP separado, sem mínimo de assentos de agente, e toda conta pode começar com 500 créditos mensais gratuitos antes de migrar para pacotes de créditos ou assinaturas na página de preços.
Scrappa MCP vs alternativas
| Provedor | Foco do MCP | Melhor para |
|---|---|---|
| Scrappa | Mais de 80 APIs de scraping estruturado expostas como ferramentas MCP | Agentes que precisam de dados de busca, mapas, avaliações, empregos, redes sociais e marketplaces |
| Firecrawl | Rastreamento de sites e extração de páginas via MCP | Extração de Markdown de sites conhecidos |
| Apify | Ecossistema de atores via MCP | Equipes que já mantêm atores do Apify |
| Bright Data | Ferramentas empresariais de coleta de dados | Operações grandes com uso intensivo de proxies e compras empresariais |
Obtenha sua chave de API
Cadastre-se para uma conta gratuita no Scrappa para obter sua chave de API e começar a usar a integração MCP com seu assistente de IA.
Solução de problemas do servidor MCP de web scraping
Se você está avaliando um servidor MCP de web scraping para Claude ou outro cliente de IA, a URL MCP do Scrappa https://scrappa.co/mcp é um único endpoint gerenciado que atende todas as APIs de scraping do Scrappa. Estes são os problemas que aparecem com mais frequência durante a configuração.
A URL do servidor MCP deve ser exata
Use https://scrappa.co/mcp sem barra final, sem /v1 e sem segmentos extras de caminho. Clientes MCP remotos nativos rejeitam URLs incompatíveis silenciosamente e voltam para "sem ferramentas".
Formatação do cabeçalho X-API-KEY
O nome do cabeçalho é X-API-KEY (em maiúsculas). Passe o valor bruto da chave sem prefixo "Bearer" e sem aspas ao redor. Clientes baseados em ponte passam por --header "X-API-KEY: YOUR_KEY".
A ponte mcp-remote requer Node.js 18+
Claude Desktop, Cursor, VS Code e Windsurf iniciam a ponte npx mcp-remote contra a URL MCP do Scrappa. Certifique-se de que node --version reporte 18 ou superior e que npx esteja no PATH do usuário sob o qual o cliente de IA é executado.
Reinicie o cliente de IA após editar a configuração
Servidores MCP são carregados uma vez por sessão do cliente. Após atualizar claude_desktop_config.json, ~/.codex/config.toml, opencode.json ou ~/.cursor/mcp.json, saia completamente e reinicie o cliente — recarregar a janela não é suficiente.
Verifique se o servidor está registrado
Execute "claude mcp list" ou "gemini mcp list" para confirmar que o scrappa aparece. Dentro do chat, perguntar "liste suas ferramentas" deve retornar endpoints do Scrappa como search, trustpilot-company-reviews, linkedin-profile e youtube-transcript.
Perguntas frequentes
O que é um servidor MCP e como ele funciona com clientes de IA?
MCP (Model Context Protocol) é um padrão aberto que permite que assistentes de IA se conectem a ferramentas externas e fontes de dados. O servidor MCP do Scrappa expõe mais de 80 APIs de web scraping como ferramentas que Claude, Codex, OpenCode, Gemini CLI, Cursor, VS Code e Windsurf podem chamar diretamente durante conversas.
Qual é a URL do servidor MCP do Scrappa?
A URL do servidor MCP do Scrappa é https://scrappa.co/mcp. É um endpoint MCP remoto streamable-HTTP autenticado com o cabeçalho X-API-KEY do seu painel do Scrappa. Se um cliente MCP móvel não puder definir cabeçalhos personalizados, use https://scrappa.co/mcp?X-API-KEY=YOUR\_SCRAPPA\_API\_KEY como fallback de compatibilidade.
Como uso o Scrappa MCP no Claude Mobile ou em clientes sem cabeçalhos personalizados?
Use https://scrappa.co/mcp?X-API-KEY=YOUR\_SCRAPPA\_API\_KEY quando o cliente não puder enviar o cabeçalho X-API-KEY. Prefira autenticação por cabeçalho em clientes desktop e CLI quando disponível, porque chaves de API em URLs podem aparecer no histórico do navegador, logs de proxy, análises, capturas de tela e tickets de suporte.
Quais clientes de IA suportam o servidor MCP do Scrappa?
O servidor MCP do Scrappa funciona com Claude Desktop, Claude Mobile, Claude Code, Codex, OpenCode, Gemini CLI, Cursor, VS Code com GitHub Copilot e Windsurf. Qualquer cliente que suporte o Model Context Protocol pode se conectar ao Scrappa.
Preciso instalar algo para usar o Scrappa via MCP?
Claude Code e Gemini CLI podem adicionar o Scrappa com um único comando. Claude Desktop, Cursor, VS Code e Windsurf usam configurações JSON, Codex usa TOML e OpenCode usa opencode.json. Node.js 18+ é necessário apenas para clientes que usam a ponte mcp-remote.
Quantas APIs estão disponíveis através do servidor MCP?
O Scrappa fornece mais de 80 endpoints de API em Google Maps, Google Search, YouTube, LinkedIn, Trustpilot, Google Flights, Google Hotels, Indeed e muito mais. Todos os endpoints estão automaticamente disponíveis como ferramentas MCP, incluindo o endpoint mais recente de transcrição do YouTube adicionado em abril de 2026.
Posso usar o servidor MCP do Scrappa para web scraping no Claude?
Sim. O servidor MCP do Scrappa é projetado especificamente para web scraping dentro do Claude, Claude Code, Codex, Cursor e outros clientes MCP. Uma vez conectado, o Claude pode pesquisar no Google, buscar avaliações do Google Maps, puxar classificações do Trustpilot ou Kununu, extrair perfis do LinkedIn, recuperar transcrições do YouTube e traduzir texto — tudo sem sair da janela de chat.
Posso usar o servidor MCP do Scrappa gratuitamente?
Você pode criar uma conta gratuita no Scrappa para obter uma chave de API. O servidor MCP usa os mesmos créditos de API que a API REST, incluindo os 500 créditos mensais gratuitos em todas as contas. Consulte a página de preços para planos pagos e pacotes de créditos quando você superar o nível gratuito.
Como faço para solucionar problemas de um servidor MCP que não conecta?
A maioria dos problemas vem da formatação de cabeçalhos ou de clientes desatualizados. Confirme se a URL do servidor MCP é exatamente https://scrappa.co/mcp, que o cabeçalho X-API-KEY não está entre aspas em uma única linha e que seu cliente foi totalmente reiniciado após editar a configuração. Execute "claude mcp list" ou "gemini mcp list" para verificar se o servidor está registrado e confirme se clientes que usam mcp-remote têm Node.js 18+ no PATH.
Precisa de Ajuda?
Consulte nossa documentação de autenticação para mais detalhes sobre chaves de API, ou visite o playground da API para testar endpoints diretamente.
Guia de integração MCP atualizado pela última vez.