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?

  • Extrair qualquer página da web como Markdown — Peça ao seu assistente para buscar uma URL e retornar conteúdo limpo e pronto para LLM via scrape_as_markdown.
  • Capturar capturas de tela de páginas da web — Solicite uma captura de tela em PNG de qualquer site, opcionalmente de um país específico, usando a ferramenta screenshot.
  • Pesquisar no Google e Bing — Obtenha resultados de mecanismos de busca processados para qualquer consulta, incluindo anúncios, AI Mode e Google Lens via google_search, bing_search e ferramentas relacionadas.
  • Rastrear produtos e preços de eCommerce — Extraia detalhes de produtos, preços, vendedores e mais vendidos da Amazon, Walmart, Target e TikTok Shop.
  • Coletar dados de mídias sociais — Recupere postagens, perfis de usuários, vídeos de canais e legendas do Reddit, TikTok e YouTube.
  • Consultar mecanismos de busca com IA — Pergunte ao ChatGPT ou Perplexity por respostas e conversas geradas por IA através do conjunto de ferramentas ai.

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 de JavaScript no lado do servidor e tratamento anti-bot
  • Mais de 125 milhões de IPs em mais de 195 localizações

O que é o servidor MCP Decodo?

O Servidor MCP Decodo é uma camada de scraping web 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 por agentes de IA
  • Extração de dados estruturados de sites dinâmicos

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

Por que usar MCP para web scraping?

O 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 por meio desse 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 proxies, resolução de CAPTCHA ou sistemas anti-bot.

Saídas estruturadas para fluxos de trabalho com LLM. Markdown (pronto para LLM), JSON (para pipelines estruturados) e capturas de tela (para contexto visual), criados para pipelines de 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 global de proxies. Mais de 125 milhões de IPs residenciais, mais de 195 geolocalizações e uma taxa de sucesso de 99,99% mesmo nos alvos mais protegidos.

Conjuntos de ferramentas MCP modulares. Ative 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 retorno sobre o investimento. Da chave de API ao primeiro scraping em minutos, sem custo 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 – traga resultados de busca em tempo real do Google, Bing e busca com IA 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 viagens e preços – crie 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 solicitaçõ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+ 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 (veja exemplos de configuração abaixo).

Conectando ao servidor MCP da Decodo

Abra seu cliente MCP preferido e adicione a seguinte configuração (veja exemplos para Claude Code, Cursor e 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 o 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 o mcp_config.json).
  3. Adicione a mesma configuração acima.
  4. Salve e reinicie o Windsurf.

Teste sua configuração

Após conectar, tente este prompt no seu cliente:

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

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

Opcional: ative 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 do seu build:
cd build/
pwd

Adicionando index.js ao final deste diretório, o local do seu arquivo de build deve ficar mais ou menos assim:

/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 de ferramentas. Você pode ativar seletivamente conjuntos específicos passando uma lista separada por vírgulas por meio 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_markdownExtrai qualquer URL de destino, espera que uma URL seja fornecida via prompt. Retorna resultados em Markdown.Extraia peacock.com de um 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 IP dos EUA.
google_searchExtrai resultados do Google Search para uma consulta fornecida e retorna resultados analisados.Extraia do Google Search por sapatos e me diga a primeira posição.
google_adsExtrai resultados de pesquisa do Google Ads.Extraia do Google Ads por laptop e me mostre os principais anúncios.
google_lensExtrai resultados de pesquisa de imagens do Google Lens.Pesquise no Google Lens esta imagem: https://example.com/image.jpg
google_ai_modeExtrai resultados do Google AI Mode (Pesquisa com IA).Pergunte ao Google AI Mode: Quais são as três melhores raças de cães?
google_travel_hotelsExtrai resultados de pesquisa do Google Travel Hotels.Pesquise no Google Travel Hotels por hotéis em Paris.
amazon_searchExtrai resultados do Amazon Search para uma consulta fornecida e retorna resultados analisados.Extraia do Amazon Search por teclado sem fio.
amazon_productExtrai a página de produto da Amazon.Extraia o produto da Amazon B09H74FXNW e me mostre os detalhes.
amazon_pricingExtrai informações de preço de produtos da Amazon.Obtenha o preço do produto da Amazon B09H74FXNW.
amazon_sellersExtrai informações do vendedor da Amazon.Obtenha informações sobre o vendedor da Amazon A1R0Z7FJGTKESH.
amazon_bestsellersExtrai a lista de mais vendidos da Amazon.Mostre-me os mais vendidos da Amazon em eletrônicos.
walmart_searchExtrai resultados do Walmart Search para uma consulta fornecida e retorna resultados analisados.Extraia do Walmart Search por barraca de camping.
walmart_productExtrai a página de produto do Walmart.Extraia o produto do Walmart 15296401808.
target_searchExtrai resultados do Target Search para uma consulta fornecida e retorna resultados analisados.Extraia do Target Search por eletrodomésticos de cozinha.
target_productExtrai a página de produto do Target.Extraia o produto do Target 92186007.
tiktok_postExtrai uma URL de post do TikTok para dados estruturados (ex.: engajamento, legenda, hashtags).Extraia este post do TikTok: https://www.tiktok.com/@nba/video/7393013274725403950
tiktok_shop_searchExtrai resultados do TikTok Shop Search para uma consulta fornecida e retorna resultados analisados.Extraia do TikTok Shop Search por capas de celular.
tiktok_shop_productExtrai a página de produto do TikTok Shop.Extraia o produto do TikTok Shop 1731541214379741272.
tiktok_shop_urlExtrai a página do TikTok Shop por URL.Extraia esta URL do TikTok Shop: https://www.tiktok.com/shop/s?q=HEADPHONES
youtube_metadataExtrai metadados de vídeos do YouTube.Obtenha metadados do vídeo do YouTube dFu9aKJoqGg.
youtube_channelExtrai vídeos de canais do YouTube.Extraia o canal do YouTube @decodo_official.
youtube_subtitlesExtrai 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_postExtrai um post específico do Reddit.Extraia o seguinte post do Reddit: https://www.reddit.com/r/horseracing/comments/1nsrn3/
reddit_subredditExtrai resultados de subreddits do Reddit.Extraia os 5 principais posts de r/Python esta semana.
reddit_userExtrai o perfil de um usuário do Reddit e seus posts/comentários.Extraia este usuário do Reddit: https://www.reddit.com/user/IWasRightOnce/
bing_searchExtrai resultados do Bing Search.Pesquise no Bing por avaliações de laptops.
chatgptPesquise e interaja com o ChatGPT para respostas e conversas com IA.Peça ao ChatGPT para explicar computação quântica em termos simples.
perplexityPesquise e interaja com o Perplexity para respostas e conversas com 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 solicitação.
localeDefine o locale da solicitação.
tokenLimitTrunca o conteúdo da resposta até este limite. Útil se a janela de contexto for pequena.
promptPrompt a ser enviado para ferramentas de IA (chatgpt, perplexity).
searchAtiva a funcionalidade de pesquisa na web do ChatGPT (somente chatgpt).
xhrQuando verdadeiro, inclui respostas XHR ou fetch no resultado da extração quando suportado (ex.: tiktok_post).
deviceTypeTipo de dispositivo a emular (desktop, mobile, tablet). Os alvos analisados são mais rígidos: as ferramentas da Amazon são somente para desktop, então o omitem, e bing_search/google_ai_mode aceitam apenas desktop e mobile.
domainDomínio a ser usado para a solicitaçã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 (Walmart).
countryPaís para solicitações do TikTok Shop.
limitNúmero máximo de resultados a retornar (ex.: vídeos de canais do YouTube).
language_codeCódigo de idioma para legendas (ex.: en, es).

Exemplos

Extração de 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 extração 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 dá ao seu agente as ferramentas de extração. Decodo/agent-skills ensina a ele quando usá-las, qual superfície usar e como chamá-las — para que o agente escolha a ferramenta e os parâmetros corretos por conta própria, em vez de adivinhar.

As habilidades roteiam pela CLI do decodo, este servidor MCP hospedado e a API HTTP bruta, e recorrem automaticamente ao servidor MCP quando nenhum shell está disponível. Combinar 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

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

Repositórios relacionados

Web Scraping API, Decodo agent skills, Decodo OpenClaw skill

Experimente

Conecte o Decodo MCP Server ao seu fluxo de trabalho de IA em poucos 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 é lançado sob a Licença MIT.