Massive

Acesso web em tempo real para agentes de IA — busque qualquer URL, pesquise no Google e consulte chatbots de IA com renderização JS, resolução de captcha e geolocalização em mais de 195 países.

GitHub

Experimente este MCPPatrocinado

Documentação

@joinmassive/mcp-server

Servidor MCP oficial para a Massive Web Render API. Dê aos seus agentes de IA acesso web em tempo real — busque qualquer URL, pesquise no Google, consulte chatbots de IA — com renderização JS, resolução de captcha e geolocalização em mais de 195 países tratada automaticamente.

Início rápido (Claude Desktop)

Opção A — Instalação com um clique (`.mcpb`)

Baixe o massive-mcp-X.Y.Z.mcpb mais recente dos lançamentos do GitHub.
Abra o arquivo com o Claude Desktop (ou arraste e solte em Configurações → Extensões).
Cole seu token da API Massive quando solicitado. O token é armazenado no chaveiro do seu sistema operacional.

Opção B — npx + trecho de configuração

Adicione a ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "massive": {
      "command": "npx",
      "args": ["-y", "@joinmassive/mcp-server"],
      "env": { "MASSIVE_TOKEN": "your-token-here" }
    }
  }
}

Reinicie o Claude Desktop.

Início rápido (Claude Code)

Um comando, funciona em todos os seus projetos:

claude mcp add massive --scope user -e MASSIVE_TOKEN=your-token-here -- npx -y @joinmassive/mcp-server

Em seguida, use /mcp em qualquer sessão do Claude Code para confirmar que está conectado. Remova --scope user para limitar ao projeto atual.

Outros clientes MCP

O mesmo trecho JSON funciona para qualquer cliente compatível com MCP. Coloque-o no arquivo de configuração do cliente:

Cliente	Caminho de configuração
Cursor	`~/.cursor/mcp.json`
Continue	`~/.continue/config.json` (em `mcpServers`)
Cody	`~/Library/Application Support/com.sourcegraph.cody/mcp.json` (macOS)
Windsurf	`~/.codeium/windsurf/mcp_config.json`
VS Code (MCP)	`~/.config/Code/User/settings.json` (em `chat.mcp.servers`)

Se npx não estiver no PATH do cliente, troque para um caminho binário direto: "command": "node", "args": ["/absolute/path/to/dist/index.js"].

Obtendo um token de API

Entre em dashboard.joinmassive.com → Desenvolvedor → Chaves de API.

Ferramentas

`web_fetch`

Busque qualquer URL. Retorna Markdown por padrão (melhor para LLMs).

Argumento	Tipo	Padrão	Observações
`url`	string (obrigatório)	—
`format`	`"markdown"` \| `"rendered"` \| `"raw"`	`"markdown"`
`country`	string (ISO 3166-1 alpha-2)	—
`city`	string	—
`subdivision`	string	—	ISO 3166-2 (ex.: `"TN"`). Ignorado se `city` estiver definido.
`device`	string	—	Nome da emulação de dispositivo
`expiration`	inteiro (0–365)	—	Dias em que o resultado em cache é reutilizado. `0` = sempre ao vivo (bom para preços, pontuações).
`difficulty`	`"low"` \| `"medium"` \| `"high"`	`"low"`	Força de evasão anti-bot. Multiplicadores: `medium`=2×, `high`=premium.

Exemplo de prompt: "Use o servidor MCP Massive para buscar https://news.ycombinator.com e resumir as principais notícias."

`web_search`

Resultados de pesquisa do Google, analisados em JSON estruturado.

Argumento	Tipo	Padrão
`query` (obrigatório, ≤ 255 caracteres)	string	—
`country`	string (ISO)	—
`city`	string	—
`subdivision`	string	—
`max_results`	número	10
`expiration`	inteiro (0–365)	—
`language`	string	—
`display`	string	—

Retorna: { organic, ai_overview, people_also_ask, query }.

Exemplo de formato:

{
  "query": "best espresso machines 2026",
  "organic": [
    { "title": "...", "url": "https://...", "snippet": "..." }
  ],
  "ai_overview": { "answer": "...", "sources": [{ "domain": "wirecutter.com", "url": "https://..." }] },
  "people_also_ask": [
    { "question": "What is the best espresso machine for beginners?", "answer": "" }
  ]
}

Exemplo de prompt: "Use web_search para encontrar avaliações recentes de máquinas de espresso e retorne os 3 principais resultados orgânicos mais a visão geral da IA."

`ai_chat_completion`

Resposta de chatbot com fontes.

Argumento	Tipo	Padrão
`prompt` (obrigatório, ≤ 2047 caracteres)	string	—
`model`	`"chatgpt"` \| `"gemini"` \| `"perplexity"` \| `"copilot"`	`"chatgpt"`
`country`	string (ISO)	—
`city`	string	—
`subdivision`	string	—
`expiration`	inteiro (0–365)	—
`language`	string	—
`display`	string	—
`device`	string	—

Retorna: { completion, sources, model, subqueries? }.

`account_status`

Sem argumentos. Retorna { credits_remaining }. Útil para avisar o usuário antes de ficar sem créditos. Gratuito — não consome créditos.

Preços e controle de custos

Custos de crédito (referência ao vivo: https://joinmassive.com/pricing):

Endpoint	Custo base	Observações
`web_fetch`	1 crédito	Multiplicadores — `difficulty=medium` → 2×, `difficulty=high` → premium
`web_search`	1 crédito	Sem multiplicadores
`ai_chat_completion`	1 crédito	Sem multiplicadores
`account_status`	Gratuito	—

Exemplo prático: web_fetch com difficulty=medium custa 1 × 2 = 2 credits.

Dicas para manter os custos baixos

Cache: expiration (dias) reutiliza resultados recentes. Padrão 1. Defina expiration=0 apenas quando a atualização for importante (preços, pontuações, clima).
Dificuldade: comece com o padrão low. Aumente para medium / high somente se a tentativa baixa falhar.
Verifique primeiro: chame account_status (gratuito) antes de iniciar um lote.

Recursos

Este servidor expõe três documentos de referência somente leitura em URIs docs://. Eles aparecem no seu cliente MCP como referências anexáveis:

URI	Conteúdo
`docs://massive/pricing`	Custos de crédito e multiplicadores (mesma tabela acima, inline no seu cliente)
`docs://massive/geotargeting`	Mais de 190 países, formato de subdivisão/cidade, exemplos
`docs://massive/changelog`	Novidades em cada versão

No Claude Desktop: abra o painel Conectores e escolha o recurso deste servidor. No Claude Code: digite @ e pesquise pelo nome. O modelo não lê esses automaticamente — eles são para você navegar.

Solução de problemas

"A variável de ambiente MASSIVE_TOKEN não está definida" Confirme se o bloco env na configuração do Claude Desktop tem o token. Reinicie o Claude Desktop.

"O endpoint Massive está em autoscaling, tente novamente" Um 503 do upstream. O servidor já tentou uma vez; aguarde ~10s e tente novamente.

"403 Proibido — a solicitação foi rejeitada (provavelmente captcha ou token inválido)" Ou o site de destino rejeitou nosso solucionador de captcha, ou o token é inválido. Verifique novamente o token no painel.

Nenhuma ferramenta aparece no Claude Desktop Configurações → Desenvolvedor → verifique os logs do servidor MCP. A causa mais comum é command: "npx" não estar no PATH do Claude Desktop. Execute which npx no Terminal — se estiver sob o Homebrew (/opt/homebrew/bin), o PATH do Claude Desktop não o incluirá. Como alternativa, use um caminho direto: "command": "node", "args": ["/absolute/path/to/dist/index.js"]. Ou instale o pacote .mcpb (Opção A acima), que contorna completamente os problemas de PATH.

Contribuindo

Issues e PRs são bem-vindos em github.com/joinmassive/mcp-server.

Licença

MIT. Veja LICENSE.