Decodo

Decodo MCP Server

Conecte LLMs e agentes de IA a dados da web em tempo real usando MCP (Model Context Protocol). O Decodo MCP Server permite extrair dados de sites, mecanismos de busca, plataformas de eCommerce e redes sociais diretamente de ferramentas de IA como Claude, Cursor e Windsurf, sem precisar criar uma infraestrutura de scraping do zero.

• Saídas estruturadas em JSON, Markdown e capturas de tela
• Renderização de JavaScript no servidor e tratamento de sistemas anti-bot
• Mais de 125 milhões de IPs em mais de 195 locais

O que é o servidor Decodo MCP?

O Decodo MCP Server é uma camada de scraping da web para agentes de IA. Ele conecta clientes compatíveis com MCP à Decodo's Web Scraping API, permitindo:

• Scraping da web para LLMs
• Recuperação de dados em tempo real para RAG
• Navegação e pesquisa por agentes de IA
• Extração de dados estruturados de sites dinâmicos

Em vez de manter proxies, analisadores e lógica de novas tentativas, você tem um único ponto de integração para acessar dados da web de forma confiável.

Por que usar MCP para scraping da web?

O Model Context Protocol (MCP) é o padrão emergente para conectar agentes de IA a ferramentas e fontes de dados externas. Com MCP:

• Os agentes podem chamar ferramentas dinamicamente
• As integrações permanecem padronizadas
• Os fluxos de trabalho são escaláveis em diferentes ambientes

O Decodo MCP Server oferece aos seus agentes acesso confiável à web, pronto para produção, por meio desse padrão.

Principais recursos

Scraping da web para agentes de IA, sem necessidade de infraestrutura. Extraia dados de qualquer site, incluindo páginas com muito JavaScript, sem lidar com rotação de proxy, resolução de CAPTCHA ou sistemas anti-bot.

Saídas estruturadas para fluxos de trabalho com LLMs. Markdown (pronto para LLMs), JSON (para pipelines estruturados) e capturas de tela (para contexto visual), desenvolvidos para pipelines de RAG, agentes de pesquisa de IA e fluxos de automação.

Suporte integrado para destinos populares. Ferramentas prontas para Google e Bing (SERPs), Amazon, Walmart e Target (eCommerce), TikTok e YouTube (redes sociais), além de ChatGPT e Perplexity (busca com IA).

Infraestrutura global de proxy. Mais de 115 milhões de IPs residenciais, mais de 195 localizações geográficas e uma taxa de sucesso de 99,99% até mesmo nos destinos mais protegidos.

Conjuntos modulares de ferramentas MCP. Ative apenas o que você precisa: web, search, ecommerce, social_media, ai para selecionar ferramentas com mais facilidade e melhorar o desempenho dos agentes.

Resultados rápidos. Da chave de API ao primeiro scraping em minutos, sem sobrecarga de configuração.

Casos de uso

Use o Decodo MCP Server quando precisar de scraping da web para agentes de IA, extração de dados estruturados em escala, acesso confiável a sites dinâmicos, dados em tempo real para RAG ou uma alternativa à criação de infraestrutura de scraping do zero. Cenários comuns:

• Scraping da web com IA – permita que LLMs coletem dados atualizados em vez de depender de dados de treinamento estáticos.
• RAG com dados em tempo real – obtenha resultados em tempo real do Google, Bing e mecanismos de busca com IA para pipelines de recuperação.
• Inteligência de eCommerce – acompanhe preços de produtos, anúncios e vendedores em marketplaces sem ser bloqueado.
• Coleta de dados de redes sociais – reúna publicações, canais e dados de engajamento do TikTok e YouTube.
• Agregação de viagens e preços – crie ferramentas que coletem preços e disponibilidade em tempo real em diferentes sites.

Início rápido

1. Crie uma conta gratuita em dashboard.decodo.com – até 10 mil solicitações gratuitas, sem necessidade de cartão de crédito.
2. Obtenha sua chave de API. Copie sua chave da Web Data API na assinatura da Web Data API no dashboard. Planos mais antigos têm um token de autenticação básica, que também funciona (consulte Autenticação).
3. Baixe o Node.js 18+ em https://nodejs.org.
4. Obtenha um cliente MCP, como Claude Desktop, Cursor, Windsurf ou outras ferramentas compatíveis com MCP.
5. Configure o servidor MCP no seu cliente de IA (consulte os exemplos de configuração abaixo).

Conectando ao servidor MCP da Decodo

Abra seu cliente MCP preferido e adicione a seguinte configuração (consulte os exemplos para Claude Code, Cursor e Windsurf abaixo):

{
  "mcpServers": {
    "Decodo": {
      "url": "https://mcp.decodo.com/mcp",
      "headers": {
        "Authorization": "Bearer <api_key>"
      }
    }
  }
}

Autenticação

O servidor local lê qualquer uma das credenciais de SCRAPER_API_TOKEN e identifica qual delas recebeu.

Claude Desktop

1. Abra Claude Desktop → Settings → Developer → Edit Config.
2. Adicione ao claude_desktop_config.json:

{
  "mcpServers": {
    "Decodo": {
      "command": "npx",
      "args": ["-y", "@decodo/mcp-server"],
      "env": {
        "SCRAPER_API_TOKEN": "<api_key>",
        "TOOLSETS": "web,ai"
      }
    }
  }
}

3. Salve e reinicie o Claude Desktop.

Cursor

1. Abra Settings → MCP.
2. Clique em Add a new global MCP server (abre mcp.json).
3. Adicione a mesma configuração acima.
4. Salve — procure um indicador de status verde ao lado de Decodo.

Windsurf

1. Abra Settings → Windsurf Settings.
2. Role até Cascade → Add custom server + (abre mcp_config.json).
3. Adicione a mesma configuração acima.
4. Salve e reinicie o Windsurf.

Teste sua configuração

Depois de conectar, experimente este prompt no seu cliente:

▎ "Extraia os títulos dos 5 principais artigos do Hacker News"

Você deverá receber uma lista estruturada em segundos. Se aparecer um erro de autenticação, confira novamente sua chave de API no dashboard.

Desenvolvimento local

Necessário apenas se você quiser alterar o código do servidor.

git clone https://github.com/Decodo/mcp-server

cd mcp-server
npm install
npm run build

cd build/
pwd

/Users/your.user/projects/mcp-server/build/index.js

{
  "mcpServers": {
    "decodo-mcp": {
      "command": "node",
      "args": ["/Users/your.user/projects/mcp-server/build/index.js"],
      "env": {
        "SCRAPER_API_TOKEN": "<api_key>"
      }
    }
  }
}

Conjuntos de ferramentas

As ferramentas são organizadas em conjuntos. Os conjuntos disponíveis dependem de como você se conecta.

Claude (conector oficial)

O conector Decodo no diretório de conectores do Claude inclui apenas as ferramentas da Web Data API:

Qualquer cliente MCP

Você pode ativar conjuntos de ferramentas específicos de forma seletiva, passando uma lista separada por vírgulas pelo parâmetro de consulta toolsets:

    "Decodo MCP Server": {
      "url": "https://mcp.decodo.com/mcp?toolsets=web,ai",
      "headers": {
        "Authorization": "Bearer <api_key>"
      }
    }

Quando nenhum conjunto de ferramentas é especificado, todas as ferramentas são registradas.

Ferramentas

O servidor disponibiliza as seguintes ferramentas:

Parâmetros

Os parâmetros a seguir são inferidos dos prompts do usuário:

Exemplos

Extração de conteúdo com restrição geográfica

Faça a seguinte solicitação ao seu agente de IA:

Scrape peacock.com from a German IP address and tell me the pricing.

Este prompt informará que peacock.com tem restrição geográfica. Para contornar essa restrição:

Scrape peacock.com from a US IP address and tell me the pricing.

Limitar o número de tokens da resposta

Se o agente tiver uma janela de contexto pequena, o conteúdo retornado pela extração será truncado automaticamente para evitar o estouro da janela de contexto. Você pode aumentar o número de tokens retornados no prompt:

Scrape hacker news, return 50k tokens.

Se o seu agente tiver uma janela de contexto grande, peça para ele retornar full content:

Scrape hacker news, return full content.

Use com as habilidades de agente do Decodo

Este servidor fornece as ferramentas de scraping para o seu agente. Decodo/agent-skills ensina quando recorrer a elas, qual interface usar e como chamá-las — assim, o agente escolhe a ferramenta e os parâmetros certos por conta própria, em vez de adivinhar.

As habilidades abrangem a CLI do decodo, este servidor MCP hospedado e a API HTTP bruta, e recorrem automaticamente ao servidor MCP quando não há um shell disponível. A combinação dos dois oferece ao seu agente tanto a camada de execução (este servidor) quanto a camada de decisão (as habilidades) em uma única configuração.

Início rápido (Claude Code):

/plugin marketplace add Decodo/agent-skills
/plugin install decodo@decodo-skills

Consulte o README de habilidades de agente para instalação manual e outros agentes (Cursor, Codex, Gemini CLI, Windsurf).

Repositórios relacionados

Web Scraping API, habilidades de agente do Decodo, habilidade do Decodo OpenClaw

Experimente

Integre o Decodo MCP Server ao seu fluxo de trabalho de IA em apenas alguns cliques e equipe seus agentes de IA com dados em tempo real de qualquer site.

Comece gratuitamente | Documentação | Discord

Licença

Todo o código é distribuído sob a Licença MIT.