ScrapeWise

npx add-mcp 'https://mcp.scrapewise.ai/mcp'

ONE-CLICK INSTALL

Adicione o Scrapewise ao seu cliente

Todo cliente quer as mesmas duas coisas: o endereço abaixo e um cabeçalho Authorization com sua chave de API. Crie a chave no portal primeiro: Settings, API Keys.

Claude Code

Execute isto uma vez no seu terminal e reinicie o Claude Code.

claude mcp add scrapewise --transport http https://mcp.scrapewise.ai/mcp \
  --header 'Authorization: Bearer YOUR_SCRAPEWISE_API_KEY'

Cursor

Abre o Cursor e pré-preenche o endereço do servidor. Cole sua chave quando ele pedir.

Ou cole isto em ~/.cursor/mcp.json:

{
  "mcpServers": {
    "scrapewise": {
      "url": "https://mcp.scrapewise.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_SCRAPEWISE_API_KEY"
      }
    }
  }
}

VS Code

Abre o VS Code com o endereço do servidor preenchido. Cole sua chave quando ele pedir.

Ou execute MCP: Open User Configuration na paleta de comandos e cole:

{
  "servers": {
    "scrapewise": {
      "type": "http",
      "url": "https://mcp.scrapewise.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_SCRAPEWISE_API_KEY"
      }
    }
  }
}

Claude Desktop e claude.ai

Claude Desktop: Settings, Developer, Edit Config, depois adicione o bloco abaixo a claude_desktop_config.json e reinicie. No claude.ai, adicione-o como um conector personalizado com o mesmo endereço e cabeçalho.

{
  "mcpServers": {
    "scrapewise": {
      "url": "https://mcp.scrapewise.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_SCRAPEWISE_API_KEY"
      }
    }
  }
}

Apertou um botão e nada aconteceu? O botão abre um aplicativo no seu computador, então ele fica silencioso se esse editor não estiver instalado, ou se o seu navegador bloquear a transferência. Use a configuração abaixo dele.

Os links acima preenchem o endereço para você. Você ainda cola sua própria chave de API, porque nunca colocamos uma chave em um link público. Opcional: para obter também as ferramentas de configuração, coloque ?toolsets=outcome,admin no final do endereço e, no comando do Claude Code, coloque o endereço entre aspas simples.

Toda configuração nesta página, além do manifesto do registro, também está no repositório scrapewise-mcp.

PYTHON

Ou escreva você mesmo, em Python

Dois pacotes no PyPI. Eles chamam nossa API REST diretamente, então não há cliente MCP nem endereço de gateway envolvidos. Mesma chave de API do portal.

scrapewise

O cliente. Uma dependência, dicas de tipo e todas as rotas que a API tem. Use isto quando estiver escrevendo o código você mesmo.

pip install scrapewise

langchain-scrapewise

Doze ferramentas LangChain para qualquer modelo que chame ferramentas. Todas elas apenas leem, então uma chave LLM_READ é suficiente e o modelo não pode criar, executar ou excluir nada.

pip install langchain-scrapewise

Ambos leem SCRAPEWISE_API_KEY do ambiente, então você pode construí-los sem argumentos. O código-fonte de ambos, e o rastreador de problemas, está em um repositório público: scrapewise-python

LLM_READ

Lista seus grupos e lê linhas salvas e resultados de trabalhos, e pode chamar a ferramenta gratuita de limpeza. Não pode chamar uma ferramenta paga, e não pode criar, executar ou excluir nada. Ler linhas salvas não custa nada. Comece aqui se estiver experimentando.

LLM_FULL

Tudo acima, mais as ferramentas pagas: buscas, buscas de páginas e trabalhos longos. Com as ferramentas de configuração ativadas, também cria e altera scrapers, executa-os, define agendamentos de grupos e exclui. Construir um scraper do zero precisa desse escopo.

Não é uma chave de usuário normal

Uma chave USER comum é recusada pelo gateway MCP de propósito. MCP é uma porta separada com suas próprias chaves, então você pode revogar o acesso de um assistente sem tocar no seu próprio login.

01

Encontre a fonte de dados

Ele pré-visualiza uma página de produto e procura a fonte mais confiável primeiro: uma API de produto ou os dados estruturados de produto da própria loja. Ler a página com IA é a última escolha.

02

Construa e teste um scraper

Ele cria o scraper na sua conta, testa-o em uma única página e mostra as colunas que obteve antes de qualquer execução completa.

03

Execute e leia as linhas

Ele inicia uma execução, espera por ela e depois lê as linhas salvas de volta como uma tabela. Ler linhas salvas é gratuito, então você pode pedir os mesmos dados novamente sem pagar duas vezes.

04

Torne os preços comparáveis

As regras de grupo transformam preços brutos em preço por kg, por 100 g ou por peça e os convertem para EUR à taxa diária do BCE. O assistente define essas regras uma vez para o grupo inteiro.

Quer que o assistente siga nosso próprio processo de construção em vez de improvisar? Instale a habilidade de IA Scrapewise. Ela se conecta através deste mesmo servidor. Para trabalho de preços de concorrentes de ponta a ponta, veja rastreamento de preços de concorrentes.

O CONJUNTO DE FERRAMENTAS

O que seu assistente pode realmente chamar

Uma conta que recebe sua primeira chave MCP agora vê a lista curta abaixo. Toda ferramenta paga informa seu preço, e uma chamada com quote_only: true retorna o preço e o saldo da sua carteira sem gastar nada. Esse preço é o máximo que a chamada pode custar. O resultado de toda chamada paga diz quanto custou e quanto resta na carteira. Envie a mesma idempotency_key em uma nova tentativa e a solicitação é cobrada uma vez. Solicitações grandes respondem com um job_id para coletar depois. Acompanhar um trabalho e ler linhas salvas não custa nada.

Encontre empresas locais

10 créditos por chamada

Peça um tipo de negócio em um lugar, como dentistas em Tallinn. Você obtém o que o Google Maps lista: nome, endereço, telefone, site, avaliação, número de avaliações, categoria e coordenadas, até 20 lugares por chamada. Para mais, divida a área e peça uma vez por distrito ou cidade. Endereços de e-mail não fazem parte dos dados do Maps e não são retornados. Para obtê-los, envie os sites para a etapa de e-mail descrita em scrapewise.ai/use-cases/local-business-leads.

find_local_businesses

Pesquisa Google

10 créditos por consulta

Peça resultados da web, notícias ou ofertas de compras para uma frase. Web dá os resultados orgânicos de uma pesquisa por chamada: título, link, trecho e posição. Notícias dá artigos com fonte e data. Compras dá ofertas de produtos com preço e vendedor. Notícias e compras aceitam até 100 frases em uma chamada, que então roda como um trabalho.

google_search

Pesquisar Amazon

1 crédito por página de resultados

Peça o que a Amazon lista para uma frase no marketplace que você nomear, amazon.com a menos que você diga o contrário. Você obtém título, ASIN, preço, avaliação, número de avaliações, imagem e link. Uma frase e uma página respondem de uma vez. Até 100 frases, ou até 5 páginas por frase, rodam como um trabalho.

search_amazon

Produtos Amazon

1 crédito por página de produto

Dê ASINs ou endereços de produtos da Amazon, após uma pesquisa ou da sua própria lista. Você obtém uma linha por produto: título, marca, preço, avaliação, número de avaliações, imagens, descrição, recursos, variantes e classificações de mais vendidos. Peça também as ofertas e você obtém o preço, condição e entrega de cada vendedor, por 1 crédito adicional por produto. Um produto responde de uma vez. Até 500 rodam como um trabalho, e o primeiro trabalho com vários produtos lê seu primeiro produto mais uma vez para configurar a leitura. A cotação inclui isso.

get_amazon_product

Google Trends

10 créditos por chamada

Peça como o interesse em uma frase mudou ao longo do tempo, em um país ou mundialmente. Você obtém uma linha por ponto no tempo com o valor de interesse de 0 a 100, para um período que você escolhe entre a última hora e todos os anos.

google_trends

Buscar uma página da web

5 a 25 créditos por página

Dê um endereço de página pública. Você obtém o texto legível, ou o HTML se você pedir, e páginas que precisam de JavaScript são renderizadas em um navegador real. Geralmente 5 créditos, no máximo 25 para um site difícil de buscar. Uma página buscada há pouco tempo é gratuita.

fetch_page

Dados de produto de uma loja

5 a 25 créditos por página

Dê endereços de páginas de produto de uma loja online. Você obtém o que a loja publica sobre cada produto: nome, preço, moeda, disponibilidade, marca, códigos de produto como SKU e EAN, imagens, descrição e avaliação, onde a loja os fornece. Geralmente 5 créditos por página, no máximo 25 para uma loja difícil de buscar. Um endereço responde de uma vez. Até 100 endereços da mesma loja rodam como um trabalho, e o primeiro trabalho em uma loja lê sua primeira página mais uma vez para configurar a leitura. Páginas de várias lojas levam uma chamada por loja.

get_product_data

Limpar dados de produto

Grátis

Entregue linhas que você já tem, de uma loja, da Amazon ou da sua própria lista, até 1.000 por chamada. Ele adiciona o preço em EUR à taxa diária armazenada, o preço por quilograma, litro ou peça, ajusta o texto e remove linhas duplicadas. O serviço faz a aritmética, então os números são exatos e os mesmos toda vez. Nada é buscado, nada é armazenado e nada é cobrado, e uma chave somente leitura pode chamá-lo.

clean_product_data

Acompanhar um trabalho longo

Grátis

Uma solicitação grande responde de uma vez com um job_id em vez das linhas. Uma ferramenta mostra o quão longe o trabalho está, quanto custou até agora e as linhas coletadas, em páginas de até 100. A outra interrompe o trabalho. Linhas coletadas antes da interrupção permanecem armazenadas e permanecem cobradas.

get_results, cancel_job

Ler linhas salvas

Grátis

Liste os grupos na sua conta e leia as linhas salvas em um deles, com filtros e paginação. Seu assistente pode reler os mesmos resultados quantas vezes quiser sem pagar novamente.

scrapewise_get_scraper_group_list, scrapewise_get_scraper_data_group_client

Ferramentas de configuração

Opt-in

Precisa das ferramentas de configuração, para criar e editar scrapers, grupos e regras? Adicione ?toolsets=admin ao endereço: https://mcp.scrapewise.ai/mcp?toolsets=admin mostra apenas as ferramentas de configuração, e https://mcp.scrapewise.ai/mcp?toolsets=outcome,admin mostra ambas as listas. Contas que ainda têm uma chave MCP mais antiga mantêm todas as ferramentas, também em chaves novas.

scrapewise_preview_scraper_from_url, scrapewise_create_scraper_site, scrapewise_run_scraper_url_list, scrapewise_update_scraper_group_post_process_rules

TENTE ESTES

O que digitar depois de conectado

Cole um e o assistente faz o resto. Os cinco primeiros funcionam com a lista curta. Os três últimos constroem scrapers ou definem regras, então precisam das ferramentas de configuração.

Construa uma lista de leads

Encontre 20 dentistas em Tallinn com telefone e site. Diga-me o preço primeiro, depois execute e me dê as linhas como uma tabela.

Veja quem vende um produto

Pesquise no Google Shopping pela furadeira Bosch GSR 12V e liste os vendedores e seus preços, do mais barato ao mais caro.

Verifique um preço na Amazon

Quanto custa um conjunto Lego Duplo na amazon.de? Mostre-me a primeira página de resultados com preço, avaliação e número de avaliações.

Verifique a demanda antes de uma campanha

O interesse em e-bikes está crescendo na Alemanha? Mostre-me o Google Trends dos últimos cinco anos e diga-me se é sazonal.

Leia a última execução

Leia as linhas salvas da minha última execução e mostre-me cada produto onde um concorrente está mais barato que eu.

Comece a partir de links de concorrentes

Aqui estão 12 links de produtos de concorrentes. Construa um scraper por loja, teste cada um em uma única página, depois execute-os e me dê preço, preço de venda e tamanho do pacote em uma tabela.

Adicione links a um scraper que você já tem

Adicione estes 40 links ao scraper que já tenho para esta loja. Execute-o e depois me diga quais links voltaram sem preço.

Torne os preços comparáveis

Defina regras de grupo que transformem esses preços em preço por 100 g e converta tudo para EUR à taxa diária.

401 Não autorizado

O cabeçalho Authorization está ausente, ou a chave é uma chave de usuário comum. O gateway só aceita chaves criadas no portal em Settings, API Keys com escopo LLM_READ ou LLM_FULL.

Ele pode ler, mas não construir ou executar

Duas razões possíveis. Uma chave LLM_READ está fazendo exatamente o que deveria: crie uma segunda chave com escopo LLM_FULL quando quiser que o assistente chame ferramentas pagas, crie scrapers ou altere agendamentos. Ou a conta é nova e mostra apenas a lista curta: adicione ?toolsets=outcome,admin ao endereço e reconecte para obter também as ferramentas de configuração.

O cliente não mostra ferramentas do Scrapewise

Reinicie o cliente após adicionar o servidor. No Claude Code, claude mcp list\ deve mostrar scrapewise; no Cursor e no VS Code, o servidor aparece no painel de configurações do MCP.

Uma execução completa dura mais que a conversa

Deixe-o iniciar a execução e volte mais tarde. Ler linhas salvas é gratuito e funciona em um novo chat, então o assistente pode retomar os resultados sem raspar nada duas vezes.

Ainda preso? A documentação do MCP cobre todas as ferramentas e erros em detalhes, e o suporte analisará sua conta com você.

LIMITES E CUSTO

Os números, antes de você perguntar

Tudo aqui é um limite real da plataforma, não um nível de plano. Não há contagem de assentos nem mínimo mensal.

Endereços de uma vez5.000 por chamada

Com as ferramentas de configuração, esse é o teto quando seu assistente entrega uma lista diretamente. Trabalhos maiores vão como arquivo: até 100.000 endereços em um único upload.

Uploads de arquivos200 MB

CSV e JSON Lines até 200 MB. Excel até 36 MB, e apenas a primeira planilha é lida, então coloque seus endereços lá.

Velocidade~60 chamadas por minuto Por API key. Oito importações de arquivos podem estar em execução ao mesmo tempo; uma nona é solicitada a aguardar em vez de ser descartada.

Execuções longasSobrevivem ao chat

Uma conexão expira após 15 minutos e se reconecta sozinha. A execução continua independentemente, e as linhas estão aguardando em uma nova conversa.

Por quanto tempo as linhas são mantidas90 dias

Linhas salvas pelos seus próprios scrapers ficam disponíveis por 90 dias por padrão. Seu assistente pode definir um período mais curto por grupo, ou você pode exportar a qualquer momento. Linhas coletadas por um trabalho longo são mantidas apenas para as execuções mais recentes, então leia-as logo.

O que você pagaA partir de €0,15 por 1.000

Apenas páginas entregues. Páginas simples custam €0,15 por 1.000; uma página que precisa de um navegador completo e um proxy residencial custa até €3,75 por 1.000. Listagem, leitura e trabalho de esquema são gratuitos. As ferramentas de lista curta são precificadas em créditos: 1 crédito é €0,00015, o preço de uma página simples. Uma nova conta recebe 5 solicitações gratuitas.

Locais por pesquisa20 por chamada

Uma chamada retorna uma página de resultados do Google Maps, até 20 locais. Para mais, divida a área e pergunte uma vez por distrito ou cidade. Endereços de e-mail não estão incluídos. Uma segunda etapa os lê do próprio site de cada empresa: veja scrapewise.ai/use-cases/local-business-leads.

Trabalhos em execução3 ao mesmo tempo

Por conta, por padrão. Enquanto três solicitações longas estão em execução, a próxima é recusada como ocupada. Aguarde uma terminar ou cancele uma.

TentativasCobradas uma vez

Envie a mesma idempotency_key quando seu assistente tentar novamente uma chamada paga, e ela será respondida e cobrada uma vez. Uma chave é lembrada por 24 horas por padrão.

Números completos, cada ferramenta e cada código de erro estão na documentação do MCP. Para saber quanto custa uma página nos seus próprios sites, veja preços.

FAQ

Perguntas que recebemos sobre o servidor MCP

Respostas curtas. A documentação aprofunda cada uma delas.

MCP, o Model Context Protocol, é um padrão aberto para dar a um assistente de IA ferramentas reais em vez de suposições. Você adiciona um endereço ao seu assistente, e ele pode então trabalhar com sua conta Scrapewise: pesquisar, buscar uma página, ler linhas salvas e, com as ferramentas de configuração ativadas, criar um scraper e executá-lo. Nada é simulado.