Decodo
oficialAcesso 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_searche 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
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
- Crie uma conta gratuita em dashboard.decodo.com – até 2 mil solicitações gratuitas, sem necessidade de cartão de crédito.
- Obtenha sua chave de API. Obtenha um token de autenticação básica da API de Web Scraping no painel.
- Baixe o Node.js 18+ em https://nodejs.org.
- Obtenha um cliente MCP como Claude Desktop, Cursor, Windsurf ou outras ferramentas compatíveis com MCP.
- 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
- Abra o Claude Desktop → Configurações → Desenvolvedor → Editar Config.
- 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"
}
}
}
}
- Salve e reinicie o Claude Desktop.
Cursor
- Abra Configurações → MCP.
- Clique em Adicionar um novo servidor MCP global (abre o mcp.json).
- Adicione a mesma configuração acima.
- Salve — procure por um indicador de status verde ao lado de Decodo.
Windsurf
- Abra Configurações → Configurações do Windsurf.
- Role até Cascade → Adicionar servidor personalizado + (abre o mcp_config.json).
- Adicione a mesma configuração acima.
- 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
- Node.js 18.0+
- Um cliente MCP – opções populares são Claude Desktop e Cursor
Guia passo a passo
- Clone este repositório:
git clone https://github.com/Decodo/mcp-server
- Execute os seguintes comandos no terminal:
cd decodo-mcp-server
npm install
npm run build
- 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
- 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 ferramentas | Ferramentas |
|---|---|
web | scrape_as_markdown, screenshot |
search | google_search, google_ads, google_lens, google_travel_hotels, bing_search |
ecommerce | amazon_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_media | reddit_post, reddit_subreddit, reddit_user, tiktok_post, youtube_metadata, youtube_channel, youtube_subtitles, youtube_search |
ai | chatgpt, perplexity, google_ai_mode |
Ferramentas
O servidor expõe as seguintes ferramentas:
| Ferramenta | Descrição | Exemplo de prompt |
|---|---|---|
scrape_as_markdown | Extrai 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. |
screenshot | Captura 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_search | Extrai 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_ads | Extrai resultados de pesquisa do Google Ads. | Extraia do Google Ads por laptop e me mostre os principais anúncios. |
google_lens | Extrai resultados de pesquisa de imagens do Google Lens. | Pesquise no Google Lens esta imagem: https://example.com/image.jpg |
google_ai_mode | Extrai 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_hotels | Extrai resultados de pesquisa do Google Travel Hotels. | Pesquise no Google Travel Hotels por hotéis em Paris. |
amazon_search | Extrai resultados do Amazon Search para uma consulta fornecida e retorna resultados analisados. | Extraia do Amazon Search por teclado sem fio. |
amazon_product | Extrai a página de produto da Amazon. | Extraia o produto da Amazon B09H74FXNW e me mostre os detalhes. |
amazon_pricing | Extrai informações de preço de produtos da Amazon. | Obtenha o preço do produto da Amazon B09H74FXNW. |
amazon_sellers | Extrai informações do vendedor da Amazon. | Obtenha informações sobre o vendedor da Amazon A1R0Z7FJGTKESH. |
amazon_bestsellers | Extrai a lista de mais vendidos da Amazon. | Mostre-me os mais vendidos da Amazon em eletrônicos. |
walmart_search | Extrai resultados do Walmart Search para uma consulta fornecida e retorna resultados analisados. | Extraia do Walmart Search por barraca de camping. |
walmart_product | Extrai a página de produto do Walmart. | Extraia o produto do Walmart 15296401808. |
target_search | Extrai resultados do Target Search para uma consulta fornecida e retorna resultados analisados. | Extraia do Target Search por eletrodomésticos de cozinha. |
target_product | Extrai a página de produto do Target. | Extraia o produto do Target 92186007. |
tiktok_post | Extrai 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_search | Extrai resultados do TikTok Shop Search para uma consulta fornecida e retorna resultados analisados. | Extraia do TikTok Shop Search por capas de celular. |
tiktok_shop_product | Extrai a página de produto do TikTok Shop. | Extraia o produto do TikTok Shop 1731541214379741272. |
tiktok_shop_url | Extrai a página do TikTok Shop por URL. | Extraia esta URL do TikTok Shop: https://www.tiktok.com/shop/s?q=HEADPHONES |
youtube_metadata | Extrai metadados de vídeos do YouTube. | Obtenha metadados do vídeo do YouTube dFu9aKJoqGg. |
youtube_channel | Extrai vídeos de canais do YouTube. | Extraia o canal do YouTube @decodo_official. |
youtube_subtitles | Extrai legendas de vídeos do YouTube. | Obtenha legendas do vídeo do YouTube L8zSWbQN-v8. |
youtube_search | Pesquisa vídeos no YouTube. | Pesquise no YouTube por "Como cuidar de chinchilas". |
reddit_post | Extrai um post específico do Reddit. | Extraia o seguinte post do Reddit: https://www.reddit.com/r/horseracing/comments/1nsrn3/ |
reddit_subreddit | Extrai resultados de subreddits do Reddit. | Extraia os 5 principais posts de r/Python esta semana. |
reddit_user | Extrai 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_search | Extrai resultados do Bing Search. | Pesquise no Bing por avaliações de laptops. |
chatgpt | Pesquise e interaja com o ChatGPT para respostas e conversas com IA. | Peça ao ChatGPT para explicar computação quântica em termos simples. |
perplexity | Pesquise 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âmetro | Descrição |
|---|---|
jsRender | Renderiza a URL de destino em um navegador headless. |
geo | Define o país de origem da solicitação. |
locale | Define o locale da solicitação. |
tokenLimit | Trunca o conteúdo da resposta até este limite. Útil se a janela de contexto for pequena. |
prompt | Prompt a ser enviado para ferramentas de IA (chatgpt, perplexity). |
search | Ativa a funcionalidade de pesquisa na web do ChatGPT (somente chatgpt). |
xhr | Quando verdadeiro, inclui respostas XHR ou fetch no resultado da extração quando suportado (ex.: tiktok_post). |
deviceType | Tipo 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. |
domain | Domínio a ser usado para a solicitação (ex.: amazon.com, amazon.co.uk, bing.com). |
pageFrom | Número da página inicial para paginação. |
deliveryZip | Código postal para local de entrega (Target, Walmart). |
storeId | ID da loja para inventário local (Walmart). |
country | País para solicitações do TikTok Shop. |
limit | Número máximo de resultados a retornar (ex.: vídeos de canais do YouTube). |
language_code | Có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.