Spider Cloud MCP

Servidor Spider MCP: rastreie, extraia, pesquise e automatize navegadores em escala

Documentação

Spider MCP Server

O servidor mais rápido de crawling, scraping e automação de navegador para agentes de IA. Dá ao Claude acesso direto à web por meio de 22 ferramentas — rastreie sites a 100 mil+ páginas/seg, extraia dados estruturados com IA e controle navegadores remotos com bypass anti-bot integrado.

Por que o Spider

Velocidade — Rastreie 100 mil+ páginas por segundo. O roteamento inteligente de requisições escolhe HTTP ou Chrome headless automaticamente. Respostas em streaming começam a entregar dados imediatamente.
Custo — Créditos pagos por uso, sem necessidade de assinatura para as ferramentas principais. Verifique seu saldo a qualquer momento com spider_get_credits. Ferramentas de IA disponíveis com uma assinatura de IA.
Confiabilidade — Bypass anti-bot com fingerprinting e rotação de proxies. Frota de navegadores com fallback automático entre Chrome, Firefox e outros. Repetição automática e escalonamento furtivo integrados.

Início Rápido

Claude Code

claude mcp add spider -- npx -y spider-cloud-mcp

Defina sua chave de API:

export SPIDER_API_KEY="your-api-key"

Claude Desktop

Adicione em claude_desktop_config.json:

{
  "mcpServers": {
    "spider": {
      "command": "npx",
      "args": ["-y", "spider-cloud-mcp"],
      "env": {
        "SPIDER_API_KEY": "your-api-key"
      }
    }
  }
}

Cursor

Adicione em .cursor/mcp.json:

{
  "mcpServers": {
    "spider": {
      "command": "npx",
      "args": ["-y", "spider-cloud-mcp"],
      "env": {
        "SPIDER_API_KEY": "your-api-key"
      }
    }
  }
}

Windsurf

Adicione em ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "spider": {
      "command": "npx",
      "args": ["-y", "spider-cloud-mcp"],
      "env": {
        "SPIDER_API_KEY": "your-api-key"
      }
    }
  }
}

Configuração

Variável	Obrigatório	Descrição
`SPIDER_API_KEY`	Sim	Sua chave de API do Spider. Obtenha uma em spider.cloud/api-keys

Ferramentas

Ferramentas Principais (8)

Estas funcionam com créditos pagos por uso, sem necessidade de assinatura.

Ferramenta	Descrição
`spider_crawl`	Rastreie um site e extraia conteúdo de várias páginas. Segue links até uma profundidade/limite.
`spider_scrape`	Extraia uma única página. Mais rápido e barato que o crawling quando você precisa de uma URL.
`spider_search`	Pesquise na web. Opcionalmente, busque o conteúdo completo das páginas nos resultados.
`spider_links`	Extraia todos os links de uma página sem buscar o conteúdo.
`spider_screenshot`	Capture uma captura de tela da página como PNG base64.
`spider_unblocker`	Acesse conteúdo protegido contra bots com bypass anti-bot avançado.
`spider_transform`	Converta HTML em markdown ou texto sem fazer requisições web.
`spider_get_credits`	Verifique seu saldo de créditos de API.

Ferramentas de IA (5)

Interação web em linguagem natural. Descreva o que você quer em linguagem simples.

Requer uma assinatura de IA.

Ferramenta	Descrição
`spider_ai_crawl`	Crawling guiado por IA — descreva qual conteúdo encontrar.
`spider_ai_scrape`	Extraia dados estruturados com linguagem simples — sem seletores CSS.
`spider_ai_search`	Busca aprimorada por IA com compreensão de intenção.
`spider_ai_browser`	Automatize ações do navegador com linguagem natural.
`spider_ai_links`	Encontre e filtre links por descrição.

Ferramentas de Automação de Navegador (9)

Controle direto do navegador via spider-browser. Os navegadores são executados na nuvem do Spider com repetição inteligente, troca de navegador, proteção anti-bot, rotação de proxies e escalonamento furtivo automático. Suporta os protocolos CDP e BiDi.

Ferramenta	Descrição
`spider_browser_open`	Abra uma sessão de navegador remota. Retorna um session_id.
`spider_browser_navigate`	Navegue para uma URL e aguarde o carregamento.
`spider_browser_click`	Clique em um elemento por seletor CSS.
`spider_browser_fill`	Preencha um campo de formulário com texto.
`spider_browser_screenshot`	Tire uma captura de tela da página atual. Retorna PNG base64.
`spider_browser_content`	Obtenha o HTML da página ou o texto visível.
`spider_browser_evaluate`	Execute JavaScript no contexto da página.
`spider_browser_wait_for`	Aguarde um elemento, navegação ou inatividade da rede.
`spider_browser_close`	Feche a sessão e pare a cobrança.

As sessões de navegador são fechadas automaticamente após 5 minutos de inatividade. Sempre chame spider_browser_close ao terminar.

Exemplos

Pesquisa e RAG

"Rastreie a documentação do React e resuma a API de hooks"

Usa spider_crawl para buscar 50+ páginas em segundos e retornar markdown limpo pronto para contexto.

spider_crawl: {
  url: "https://react.dev/reference/react",
  limit: 50,
  return_format: "markdown",
  filter_output_main_only: true
}

Extração de Dados Estruturados

"Obtenha todos os nomes e preços de produtos desta página de e-commerce"

Usa spider_ai_scrape para extrair JSON estruturado com zero seletores CSS.

spider_ai_scrape: {
  url: "https://example-store.com/products",
  prompt: "Extract every product name, price, and availability status as JSON"
}

Automação de Navegador em Múltiplas Etapas

"Faça login no painel, vá para relatórios e capture a tela do resumo mensal"

Usa as ferramentas spider_browser_* para controlar um navegador remoto com proteção anti-bot completa.

1. spider_browser_open: { browser: "auto" }
2. spider_browser_navigate: { url: "https://app.example.com/login" }
3. spider_browser_fill: { selector: "input[name='email']", value: "user@example.com" }
4. spider_browser_fill: { selector: "input[name='password']", value: "..." }
5. spider_browser_click: { selector: "button[type='submit']" }
6. spider_browser_wait_for: { navigation: true }
7. spider_browser_navigate: { url: "https://app.example.com/reports/monthly" }
8. spider_browser_screenshot: {}
9. spider_browser_close: {}

Inteligência Competitiva

"Pesquise rodadas de financiamento recentes de startups de IA e obtenha os detalhes"

Usa spider_search com filtro de tempo e depois spider_scrape para os detalhes.

spider_search: {
  search: "AI startup Series A funding 2025",
  num: 10,
  fetch_page_content: true,
  return_format: "markdown",
  tbs: "qdr:m"
}

Referência da API

Todas as ferramentas mapeiam diretamente para a API do Spider. As ferramentas principais aceitam os mesmos parâmetros que suas contrapartes na API:

Crawl/Scrape: url, return_format, request, readability, root_selector, proxy_enabled, cache e muitos outros
Search: search, num, fetch_page_content, country, language, tbs
Ferramentas de IA: Adicione um parâmetro prompt descrevendo o que você quer em linguagem natural
Ferramentas de navegador: Use session_id de spider_browser_open para todas as operações

Referência completa de parâmetros: spider.cloud/docs/api

Licença

MIT