Decodo

oficial

Acesso fácil a dados da web. Recuperação simplificada de informações de sites e fontes online.

O que você pode fazer com Decodo MCP?

  • Extraia qualquer página da web como Markdown — extraia conteúdo limpo e pronto para LLM de uma URL usando scrape_as_markdown.
  • Capture capturas de tela de páginas da web — tire uma foto visual de qualquer site com screenshot.
  • Pesquise no Google e Bing — recupere resultados de SERP analisados via google_search e bing_search.
  • Obtenha dados de produtos de e-commerce — consulte preços, vendedores e mais vendidos na Amazon, Walmart ou Target.
  • Colete conteúdo de mídias sociais — extraia postagens do Reddit, vídeos do TikTok ou metadados e legendas do YouTube.
  • Consulte ferramentas de busca com IA — interaja com ChatGPT, Perplexity ou Google AI Mode para respostas baseadas em IA.

Documentação

Servidor MCP Decodo

Install MCP Server

Conecte LLMs e agentes de IA a dados web ao vivo usando MCP (Model Context Protocol). O Servidor MCP Decodo permite que você faça scraping de sites, mecanismos de busca, plataformas de eCommerce e redes sociais diretamente de ferramentas de IA como Claude, Cursor e Windsurf, tudo sem a necessidade de construir infraestrutura de scraping do zero.

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

O que é o servidor MCP Decodo?

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

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

Em vez de manter proxies, parsers e lógica de repetição, você obtém um único ponto de integração para acesso confiável a dados web.

Por que usar MCP para web scraping?

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

  • Agentes podem chamar ferramentas dinamicamente
  • Integrações permanecem padronizadas
  • Fluxos de trabalho escalam entre ambientes

O Servidor MCP Decodo oferece aos seus agentes acesso web confiável e pronto para produção através deste padrão.

Principais recursos

Web scraping para agentes de IA, sem necessidade de infraestrutura. Faça scraping 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 de LLM. Markdown (pronto para LLM), JSON (para pipelines estruturados) e capturas de tela (para contexto visual), construídos para pipelines RAG, agentes de pesquisa de IA e fluxos de automação.

Suporte integrado para alvos populares. Ferramentas prontas para Google e Bing (SERPs), Amazon, Walmart e Target (eCommerce), Reddit, TikTok e YouTube (redes sociais), e ChatGPT e Perplexity (busca com IA).

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

Conjuntos de ferramentas MCP modulares. Habilite apenas o que você precisa: web, search, ecommerce, social_media, ai para uma seleção de ferramentas mais limpa e melhor desempenho do agente.

Rápido tempo de retorno. Da chave de API ao primeiro scraping em minutos, sem sobrecarga de configuração.

Casos de uso

Use o Servidor MCP Decodo quando precisar de web scraping 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 à construção de infraestrutura de scraping do zero. Cenários comuns:

  • Web scraping com IA – dê aos LLMs a capacidade de coletar dados atualizados em vez de depender de dados de treinamento estáticos.
  • RAG com dados ao vivo – puxe resultados de busca do Google, Bing e IA em tempo real para pipelines de recuperação.
  • Inteligência de eCommerce – acompanhe preços de produtos, listagens e vendedores em marketplaces sem ser bloqueado.
  • Coleta de dados de redes sociais – reúna posts, canais e dados de engajamento do Reddit, TikTok e YouTube.
  • Agregação de preços e viagens – construa ferramentas que coletam preços e disponibilidade ao vivo em sites.

Início rápido

  1. Crie uma conta gratuita em dashboard.decodo.com – até 2 mil requisições gratuitas, sem necessidade de cartão de crédito.
  2. Obtenha sua chave de API. Obtenha um token de autenticação básica da API de Web Scraping no painel.
  3. Baixe o Node.js 18+ de 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 (veja exemplos de configuração abaixo).

Conectando-se ao servidor MCP da Decodo

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

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

Claude Desktop

  1. Abra o Claude Desktop → Configurações → Desenvolvedor → Editar Config.
  2. Adicione ao claude_desktop_config.json:
{
  "mcpServers": {
    "Decodo": {
      "command": "npx",
      "args": ["-y", "@decodo/mcp-server"],
      "env": {
        "SCRAPER_API_TOKEN": "<basic_auth_token>",
        "TOOLSETS": "web,ai"
      }
    }
  }
}
  1. Salve e reinicie o Claude Desktop.

Cursor

  1. Abra Configurações → MCP.
  2. Clique em Adicionar um novo servidor MCP global (abre mcp.json).
  3. Adicione a mesma configuração acima.
  4. Salve — procure por um indicador de status verde ao lado de Decodo.

Windsurf

  1. Abra Configurações → Configurações do Windsurf.
  2. Role até Cascade → Adicionar servidor personalizado + (abre mcp_config.json).
  3. Adicione a mesma configuração acima.
  4. Salve e reinicie o Windsurf.

Teste sua configuração

Uma vez conectado, tente este prompt no seu cliente:

▎ "Faça o scraping dos títulos dos 5 principais artigos do Hacker News"

Você deve receber uma lista estruturada de volta em segundos. Se você encontrar um erro de autenticação, verifique novamente seu token no painel.

Opcional: habilitar conjuntos de ferramentas específicos

Executando o servidor MCP localmente

Pré-requisitos

Guia passo a passo

  1. Clone este repositório:
git clone https://github.com/Decodo/mcp-server
  1. Execute os seguintes comandos no terminal:
cd decodo-mcp-server
npm install
npm run build
  1. Anote o local da sua build:
cd build/
pwd

Adicionando index.js ao final deste diretório, o local do seu arquivo de build deve se parecer com isto:

/Users/your.user/projects/decodo-mcp/build/index.js
  1. Atualize seu cliente MCP com as informações do servidor:
{
  "mcpServers": {
    "decodo-mcp": {
      "command": "node",
      "args": ["/Users/your.user/projects/decodo-mcp/build/index.js"],
      "env": {
        "SCRAPER_API_TOKEN": "<web_scraping_api_base64_token>"
      }
    }
  }
}

Conjuntos de ferramentas

As ferramentas são organizadas em conjuntos. Você pode habilitar seletivamente conjuntos específicos passando uma lista separada por vírgulas através do parâmetro de consulta toolsets:

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

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

Conjunto de ferramentasFerramentas
webscrape_as_markdown, screenshot
searchgoogle_search, google_ads, google_lens, google_travel_hotels, bing_search
ecommerceamazon_search, amazon_product, amazon_pricing, amazon_sellers, amazon_bestsellers, walmart_search, walmart_product, target_search, target_product, tiktok_shop_search, tiktok_shop_product, tiktok_shop_url
social_mediareddit_post, reddit_subreddit, reddit_user, tiktok_post, youtube_metadata, youtube_channel, youtube_subtitles, youtube_search
aichatgpt, perplexity, google_ai_mode

Ferramentas

O servidor expõe as seguintes ferramentas:

FerramentaDescriçãoExemplo de prompt
scrape_as_markdownRaspa qualquer URL de destino, espera que uma URL seja fornecida via prompt. Retorna resultados em Markdown.Raspe peacock.com de um endereço IP dos EUA e me diga os preços.
screenshotCaptura uma captura de tela de qualquer página da web e a retorna como uma imagem PNG.Tire uma captura de tela de github.com de um endereço IP dos EUA.
google_searchRaspa o Google Search para uma determinada consulta e retorna resultados analisados.Raspe o Google Search por sapatos e me diga a primeira posição.
google_adsRaspa resultados de busca do Google Ads.Raspe o Google Ads por laptop e me mostre os principais anúncios.
google_lensRaspa resultados de busca de imagens do Google Lens.Pesquise no Google Lens por esta imagem: https://example.com/image.jpg
google_ai_modeRaspa resultados do Google AI Mode (Busca com IA).Pergunte ao Google AI Mode: Quais são as três principais raças de cachorro?
google_travel_hotelsRaspa resultados de busca do Google Travel Hotels.Pesquise no Google Travel Hotels por hotéis em Paris.
amazon_searchRaspa o Amazon Search para uma determinada consulta e retorna resultados analisados.Raspe o Amazon Search por teclado sem fio.
amazon_productRaspa a página de produto da Amazon.Raspe o produto Amazon B09H74FXNW e me mostre os detalhes.
amazon_pricingRaspa informações de preços de produtos da Amazon.Obtenha preços do produto Amazon B09H74FXNW.
amazon_sellersRaspa informações do vendedor da Amazon.Obtenha informações sobre o vendedor Amazon A1R0Z7FJGTKESH.
amazon_bestsellersRaspa a lista de Mais Vendidos da Amazon.Mostre-me os mais vendidos da Amazon em eletrônicos.
walmart_searchRaspa o Walmart Search para uma determinada consulta e retorna resultados analisados.Raspe o Walmart Search por barraca de camping.
walmart_productRaspa a página de produto do Walmart.Raspe o produto Walmart 15296401808.
target_searchRaspa o Target Search para uma determinada consulta e retorna resultados analisados.Raspe o Target Search por eletrodomésticos de cozinha.
target_productRaspa a página de produto da Target.Raspe o produto Target 92186007.
tiktok_postRaspa uma URL de post do TikTok para dados estruturados (ex.: engajamento, legenda, hashtags).Raspe este post do TikTok: https://www.tiktok.com/@nba/video/7393013274725403950
tiktok_shop_searchRaspa o TikTok Shop Search para uma determinada consulta e retorna resultados analisados.Raspe o TikTok Shop Search por capas de celular.
tiktok_shop_productRaspa a página de produto do TikTok Shop.Raspe o produto TikTok Shop 1731541214379741272.
tiktok_shop_urlRaspa a página do TikTok Shop por URL.Raspe esta URL do TikTok Shop: https://www.tiktok.com/shop/s?q=HEADPHONES
youtube_metadataRaspa metadados de vídeo do YouTube.Obtenha metadados do vídeo do YouTube dFu9aKJoqGg.
youtube_channelRaspa vídeos de um canal do YouTube.Raspe o canal do YouTube @decodo_official.
youtube_subtitlesRaspa legendas de vídeos do YouTube.Obtenha legendas do vídeo do YouTube L8zSWbQN-v8.
youtube_searchPesquisa vídeos no YouTube.Pesquise no YouTube por "Como cuidar de chinchilas".
reddit_postRaspa um post específico do Reddit.Raspe o seguinte post do Reddit: https://www.reddit.com/r/horseracing/comments/1nsrn3/
reddit_subredditRaspa resultados de um subreddit.Raspe os 5 principais posts do r/Python esta semana.
reddit_userRaspa um perfil de usuário do Reddit e seus posts/comentários.Raspe este usuário do Reddit: https://www.reddit.com/user/IWasRightOnce/
bing_searchRaspa resultados do Bing Search.Pesquise no Bing por avaliações de laptop.
chatgptPesquisa e interage com o ChatGPT para respostas e conversas com tecnologia de IA.Pergunte ao ChatGPT para explicar computação quântica em termos simples.
perplexityPesquisa e interage com o Perplexity para respostas e conversas com tecnologia de IA.Pergunte ao Perplexity quais são as últimas tendências em desenvolvimento web.

Parâmetros

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

ParâmetroDescrição
jsRenderRenderiza a URL de destino em um navegador headless.
geoDefine o país de origem da requisição.
localeDefine a localidade da requisição.
tokenLimitTrunca o conteúdo da resposta até este limite. Útil se a janela de contexto for pequena.
promptPrompt para enviar a ferramentas de IA (chatgpt, perplexity).
searchAtiva a funcionalidade de busca na web do ChatGPT (somente chatgpt).
xhrQuando verdadeiro, inclui respostas XHR ou fetch no resultado da raspagem onde suportado (ex.: tiktok_post).
deviceTypeTipo de dispositivo a ser emulado para a requisição (desktop, mobile, tablet).
domainDomínio a ser usado para a requisição (ex.: amazon.com, amazon.co.uk, bing.com).
pageFromNúmero da página inicial para paginação.
deliveryZipCódigo postal para local de entrega (Target, Walmart).
storeIdID da loja para inventário local (Target, Walmart).
countryPaís para requisições do TikTok Shop.
limitNúmero máximo de resultados a retornar (ex.: vídeos de canal do YouTube).
language_codeCódigo de idioma para legendas (ex.: en, es).

Exemplos

Raspando conteúdo com restrição geográfica

Consulte seu agente de IA com o seguinte prompt:

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

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

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

Limitando o número de tokens de resposta

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

Scrape hacker news, return 50k tokens.

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

Scrape hacker news, return full content.

Uso com as habilidades do agente Decodo

Este servidor fornece ao seu agente as ferramentas de raspagem. Decodo/agent-skills ensina a ele quando usá-las, qual superfície usar e como chamá-la — para que o agente escolha a ferramenta e os parâmetros certos por conta própria, em vez de adivinhar.

As habilidades roteiam através da CLI decodo, deste servidor MCP hospedado e da API HTTP bruta, e recorrem ao servidor MCP automaticamente quando nenhum shell está disponível. Emparelhar os dois dá 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

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

Repositórios relacionados

API de Web Scraping, Habilidades do agente Decodo, Habilidade Decodo OpenClaw

Experimente

Conecte 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 é liberado sob a Licença MIT.