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 faz | Roteamento de proxy + fetch | Anti-bot completo + renderização headless + extração estruturada |
| Ideal para | Fetches simples, segmentação geográfica | Raspagem de sites protegidos (Amazon, eBay, LinkedIn), páginas renderizadas em JS |
| Anti-detecção | Headers de fingerprint do Chrome | Spoofing TLS JA3 + anti-detecção Playwright |
| Instalação | npx proxyclaw-mcp-server | uvx proxyclaw-mcp-server[all] |
| Ferramentas | 4 (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
- Site: proxyclaw.ai
- Plataforma: iploop.io
- GitHub: github.com/Iploop/proxyclaw-mcp
- Docs MCP: modelcontextprotocol.io
Construído com ⚡ por IPLoop