ProxyClaw MCP Server

Servidor MCP de proxy residencial para agentes de IA buscarem, renderizarem, rasparem e verificarem conteúdo web através de proxies ProxyClaw/IPLoop.

Documentação

🌐 ProxyClaw MCP Server

Servidor Model Context Protocol (MCP) para ProxyClaw da IPLoop.

Roteie requisições web através de mais de 175 milhões de IPs residenciais em mais de 195 países — diretamente do Claude Desktop, Cursor, Zed ou qualquer cliente compatível com MCP.

A única rede de proxies residenciais com um servidor MCP. Sua IA agora pode navegar a partir de residências reais, não de datacenters.


✨ O Que Você Obtém

  • Mais de 195 países — Roteie requisições através de IPs residenciais reais
  • Bypass anti-bot — Cloudflare, DataDome, PerimeterX não conseguem perceber a diferença
  • Zero configuração — Uma variável de ambiente, quatro ferramentas poderosas
  • Sessões persistentes — Mesmo IP em múltiplas requisições
  • Segmentação por cidade e ISP — Precisão cirúrgica quando você precisar

⚡ Node.js vs Python — Qual Usar?

Disponibilizamos dois servidores MCP. Escolha com base no que você precisa:

Este repositório (Node.js)Versão Python
O que fazRoteamento de proxy + fetchAnti-bot completo + renderização headless + extração estruturada
Ideal paraFetches simples, segmentação geográficaRaspagem de sites protegidos (Amazon, eBay, LinkedIn), páginas renderizadas em JS
Anti-detecçãoHeaders de fingerprint do ChromeSpoofing TLS JA3 + anti-detecção Playwright
Instalaçãonpx proxyclaw-mcp-serveruvx proxyclaw-mcp-server[all]
Ferramentas4 (fetch, check_ip, list_countries, rotate)6 (+ stealth fetch, render, scrape, extract)

→ Use Node.js se você só precisa rotear requisições através de IPs residenciais.

→ Use Python se você está raspando alvos difíceis (Cloudflare, SPAs, sites React) ou precisa de extração de dados estruturados de mais de 60 sites suportados.

Ambos usam a mesma rede de proxies — apenas níveis diferentes de poder.


🚀 Instalação (30 segundos)

1. Obtenha Sua Chave de API Gratuita

Cadastre-se em iploop.io/signup — 0,5 GB grátis, sem cartão de crédito.

2. Adicione ao Claude Desktop

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

{
  "mcpServers": {
    "proxyclaw": {
      "command": "npx",
      "args": ["-y", "proxyclaw-mcp-server"],
      "env": {
        "IPLOOP_API_KEY": "your_api_key_here"
      }
    }
  }
}

Reinicie o Claude Desktop. Pronto.

3. Verifique

Pergunte ao Claude:

"Verifique meu IP de saída através do proxy"

O Claude chamará proxy_check_ip e mostrará o IP residencial pelo qual você está roteando.


🛠️ Ferramentas Disponíveis

proxy_fetch

Busque qualquer URL através de um proxy residencial.

{
  "url": "https://example.com",
  "country": "US",
  "city": "newyork",
  "session": "my-session-id",
  "timeout": 30
}

Use quando: Raspando sites com restrição geográfica, verificando preços por região, contornando detecção de bots.

proxy_check_ip

Verifique de qual IP e país você está saindo.

{
  "country": "DE"
}

Use quando: Verificando sua localização de proxy antes de raspar.

proxy_list_countries

Liste todos os mais de 195 países disponíveis.

{}

Use quando: Você precisa saber o código exato de 2 letras para Madagascar.

proxy_rotate

Force uma nova rotação de IP.

{
  "country": "GB"
}

Use quando: Seu IP atual foi limitado por taxa e você precisa de um novo.


💬 Exemplos de Conversas

Você: "Verifique o que o Amazon.com mostra a partir de um IP dos EUA"

Claude: [chama proxy_fetch com country=US, retorna HTML]

Você: "Agora verifique a mesma página a partir do Japão"

Claude: [chama proxy_fetch com country=JP, retorna preços/conteúdo diferentes]

Você: "Liste todos os países pelos quais posso rotear"

Claude: [chama proxy_list_countries, retorna mais de 195 países]

Você: "Meu IP atual está bloqueado. Rotacione para um novo IP do Reino Unido"

Claude: [chama proxy_rotate com country=GB, confirma novo IP]


🔒 Segurança

  • A chave de API é passada via variável de ambiente — nunca codificada
  • Todo o tráfego para sites de destino é criptografado com TLS
  • A autenticação do proxy é em texto puro apenas para nosso gateway de proxy (igual a qualquer proxy HTTP)
  • Nenhum dado é registrado ou armazenado pelo servidor MCP

📦 Avançado: Instalação Local

npm install -g proxyclaw-mcp-server

# Run directly
IPLOOP_API_KEY=your_key proxyclaw-mcp-server

Ou com Docker:

docker run -e IPLOOP_API_KEY=your_key proxyclaw/mcp-server

🆓 Plano Gratuito

  • 0,5 GB de banda incluída
  • Todos os mais de 195 países disponíveis
  • Sem cartão de crédito necessário

Faça upgrade a qualquer momento em iploop.io.


🔗 Links


Construído com ⚡ por IPLoop