EuroScrape MCP server

Servidor MCP EuroScrape

Vinte ferramentas de dados para agentes de IA: preços de voos, hotéis e eletricidade, marketplaces de segunda mão, dados de empresas e leads, dados abertos da UE e da França. Cada ferramenta executa um dos EuroScrape Actors na Apify e retorna JSON estruturado.

Funciona com Claude Desktop, Claude Code, Cursor, VS Code e qualquer cliente MCP.

• Roda na sua própria conta Apify. Você paga à Apify por resultado, pelo preço exibido na página de cada Actor. Sem assinatura, nada passa por nós.
• Um limite de gastos em cada chamada (0,50 USD por padrão), para que um agente não inicie uma execução cara por engano.
• Padrões cautelosos: um agente que esquece um limite recebe de 10 a 50 linhas, não milhares.

Instalação

Você precisa de um token de API da Apify (Apify Console → Configurações → API e Integrações). O plano gratuito da Apify inclui 5 USD de uso por mês.

Claude Desktop, em um clique

Baixe euroscrape-mcp.mcpb e abra-o, ou arraste-o para Configurações → Extensões. O Claude Desktop solicita seu token de API da Apify e instala o servidor; nada mais precisa ser configurado.

Qualquer cliente MCP

Com Node.js 18 ou posterior, adicione isto à configuração do seu cliente MCP (para Claude Desktop: claude_desktop_config.json):

{
  "mcpServers": {
    "euroscrape": {
      "command": "npx",
      "args": ["-y", "github:EuroScrape/euroscrape-mcp"],
      "env": { "APIFY_TOKEN": "YOUR_APIFY_TOKEN" }
    }
  }
}

Claude Code:

claude mcp add --env APIFY_TOKEN=YOUR_APIFY_TOKEN euroscrape -- npx -y github:EuroScrape/euroscrape-mcp

Ferramentas

Ferramenta	O que retorna	Actor
get_electricity_prices	Preços de eletricidade day-ahead para mais de 40 zonas de negociação europeias, com a janela mais barata de cada dia	eu-electricity-prices
search_flights	Preços do Google Flights para uma rota e datas, dia mais barato para voar, faixa de preço típica	google-flights-prices
find_ryanair_fares	Calendário de tarifas baixas da Ryanair para uma rota, ou todos os destinos abaixo de um limite de preço a partir de um aeroporto	ryanair-low-fares
search_hotels	Preços do Google Hotels, opcionalmente em todos os sites de reserva	google-hotels-prices
search_second_hand_europe	Uma busca no principal marketplace de segunda mão de 18 países, preços em euros, mediana por país	eu-marketplace-deals
search_vinted	Listagens do Vinted em até 26 países, preços com taxas do comprador	vinted-scraper
search_kleinanzeigen	Anúncios do Kleinanzeigen com uma pontuação de negócio em relação ao preço de mercado	kleinanzeigen-scraper
find_new_companies_without_website	Empresas recém-registradas (Reino Unido, França, cinco estados dos EUA) sem site ainda	no-website-leads
search_uk_companies	Dados do Companies House por código SIC, cidade ou data de incorporação	uk-companies
search_french_companies	Dados do SIRENE por atividade, departamento e porte	france-companies
validate_eu_vat_numbers	Verificação VIES de números de IVA da UE, com um número oficial de consulta	vat-validator
get_company_behind_website	A entidade legal por trás de um site europeu, a partir do seu aviso legal	company-identity
detect_website_tech_stack	Tecnologias usadas por um site (280+), com sinais de vendas	website-intelligence
search_eu_public_tenders	Licitações abertas e contratos adjudicados na Europa e na França	eu-public-tenders
get_france_property_sales	Vendas de imóveis na França (DVF), preço por m2, classe energética	france-property-prices
get_france_energy_ratings	Certificados de desempenho energético de residências francesas (DPE)	france-energy-ratings
get_france_building_permits	Alvarás de construção na França (Sitadel), com a empresa requerente	france-building-permits
get_france_fuel_prices	Preços de combustível em tempo real dos postos ao redor de uma cidade francesa	france-fuel-prices
get_app_reviews	Avaliações da App Store e do Google Play por país	app-reviews
search_trusted_shops	Lojas online listadas no Trusted Shops, ou as avaliações de uma loja	trusted-shops-scraper
get_run_results	Os resultados de uma chamada que ainda estava em execução quando retornou (grátis)

A descrição de cada ferramenta informa seu preço. A lista completa de parâmetros está em tools.json.

O que uma chamada faz

1. Inicia o Actor na sua conta Apify com seus argumentos e o limite de gastos.
2. Aguarda a conclusão da execução (até quatro minutos; depois disso, get_run_results retoma).
3. Retorna as primeiras linhas como JSON, linhas de resumo primeiro, com a contagem total e um link para o conjunto de dados completo no Apify Console.

Configurações

Variáveis de ambiente opcionais:

Variável	Padrão	Significado
EUROSCRAPE_MAX_USD_PER_CALL	0.5	Limite de gastos de uma chamada, em USD (a Apify interrompe a execução quando ele é atingido)
EUROSCRAPE_MAX_ITEMS	50	Linhas retornadas ao agente por chamada (o resultado completo permanece no seu conjunto de dados)
EUROSCRAPE_MAX_CHARS	40000	Limite de tamanho de uma resposta, para proteger o contexto do agente
EUROSCRAPE_TIMEOUT_SECONDS	240	Quanto tempo uma chamada aguarda a execução

Prefere um servidor hospedado?

A Apify hospeda um servidor MCP que pode carregar os mesmos Actors, com OAuth e sem instalação local:

https://mcp.apify.com?tools=euroscrape/eu-electricity-prices,euroscrape/google-flights-prices

Este repositório é a alternativa local, com nomes curtos de ferramentas, padrões cautelosos e um limite de gastos.

Política de Privacidade

O servidor roda no seu computador e a EuroScrape não coleta nada por meio dele: sem analytics, sem telemetria. Os argumentos das ferramentas e seu token de API da Apify vão apenas para a API da Apify, para que o Actor rode na sua própria conta Apify; o servidor não grava nada em disco. Política completa: euroscrape.github.io/apify-actors/privacy.html.

Desenvolvimento

npm install
npm test                                   # lists the tools and checks their schemas, no Apify call
APIFY_TOKEN=... node test/check.mjs --live # also runs one real, cheap call

Exemplos de entrada, saídas de amostra e artigos: euroscrape.github.io/apify-actors.

Licença MIT.