Solematica

Estimativas solares, comparação de fornecedores, preços de energia e blog para o mercado italiano. 6 ferramentas, 5 gratuitas. Compare fornecedores, analise telhados via Google Solar API, verifique preços PUN/ARERA.

GitHub

Documentação

@solematica/mcp-server

npm version License: MIT MCP Node.js Solematica

Servidor MCP (Model Context Protocol) para Solematica — estimativas solares, comparação de fornecedores e dados de energia para a Itália.

Este servidor permite que assistentes de IA como Claude, Cursor, Windsurf, Kiro e outros clientes compatíveis com MCP analisem o potencial solar, comparem fornecedores de fotovoltaicos, verifiquem preços de energia e pesquisem artigos relacionados a energia para o mercado italiano.

Ferramentas

FerramentaDescriçãoAutenticação
stima_solareGera uma estimativa solar completa para um endereço italiano — produção, economia, ROI, dimensionamento de painéisChave de API
info_tettoAnálise de telhado por satélite via Google Solar API — superfície, orientação, segmentos, potencial de painéisGratuita
confronta_providerCompara 11 fornecedores italianos de energia solar — preços, componentes, garantias, índice de transparênciaGratuita
dettaglio_providerDetalhes completos do fornecedor — acessórios (bombas de calor, carregadores de veículos elétricos, caldeiras), contatos, financiamentoGratuita
prezzi_energiaPreços atuais de energia na Itália (PUN/ARERA) com data de atualizaçãoGratuita
cerca_articoliPesquisa artigos do blog Solematica por categoria ou palavra-chaveGratuita

Início Rápido

Claude Desktop

Adicione ao seu claude_desktop_config.json:

{
  "mcpServers": {
    "solematica": {
      "command": "npx",
      "args": ["@solematica/mcp-server"],
      "env": {
        "SOLEMATICA_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Code

claude mcp add solematica npx @solematica/mcp-server

Cursor

Adicione ao seu .cursor/mcp.json:

{
  "mcpServers": {
    "solematica": {
      "command": "npx",
      "args": ["@solematica/mcp-server"],
      "env": {
        "SOLEMATICA_API_KEY": "your-api-key"
      }
    }
  }
}

Windsurf

Adicione ao seu ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "solematica": {
      "command": "npx",
      "args": ["@solematica/mcp-server"],
      "env": {
        "SOLEMATICA_API_KEY": "your-api-key"
      }
    }
  }
}

Outros Clientes MCP

Qualquer cliente compatível com MCP pode usar este servidor via transporte stdio:

npx @solematica/mcp-server

Autenticação

  • Chave de API é necessária apenas para stima_solare (consome créditos por estimativa)
  • Todas as outras ferramentas são gratuitas e públicas — nenhuma chave de API necessária
  • Obtenha uma chave de API registrando-se como parceiro em solematica.it/partner

Variáveis de Ambiente

VariávelObrigatóriaPadrãoDescrição
SOLEMATICA_API_KEYApenas para stima_solare—Sua chave de API para endpoints autenticados
SOLEMATICA_API_URLNãohttps://api.solematica.it/api/v1URL base da API (para auto-hospedagem ou testes)

Detalhes das Ferramentas

stima_solare

Gera uma estimativa solar completa para um endereço italiano usando dados do Google Solar API + PVGIS.

Entrada:

  • indirizzo (obrigatório) — Endereço italiano completo (ex.: "Via Roma 1, 20100 Milano MI")
  • consumo_annuo_kwh — Consumo anual de eletricidade em kWh (padrão: 3500)
  • tipo_abitazione — Tipo de edificação: indipendente, bifamiliare, schiera, condominio
  • superficie_tetto_mq — Superfície do telhado em m² (calculada automaticamente via satélite se omitida)
  • orientamento — Orientação do telhado: nord, sud, est, ovest

Retorna: Dimensionamento em kWp, número de painéis, produção anual, distribuição mensal, economia, ROI, CO2 evitado, estimativa de custo.

info_tetto

Analisa um telhado usando dados de satélite do Google Solar API.

Entrada:

  • lat (obrigatório) — Latitude
  • lng (obrigatório) — Longitude

Retorna: Superfície do telhado, área utilizável, orientação, segmentos do telhado, número máximo de painéis, horas de sol.

confronta_provider

Lista todos os fornecedores italianos de energia solar ativos com dados de comparação. Veja a comparação completa de fornecedores no Solematica.

Retorna: Matriz de fornecedores com nome, preço (3 kWp), marca do painel, marca do inversor, garantia, índice de transparência (1-3) e disponibilidade de serviços de acessórios (bomba de calor, carregador de veículo elétrico, caldeira).

dettaglio_provider

Detalhes completos de um fornecedor específico.

Entrada:

  • slug (obrigatório) — Slug do fornecedor: enel, iren, plenitude, otovo, eon, hera, a2a, edison, engie, sorgenia, bluenergy

Retorna: Todos os dados de comparação mais: descrição, telefone, sede, ano de fundação, detalhes de financiamento, detalhes de serviços de acessórios com URLs.

prezzi_energia

Preços atuais de energia na Itália do banco de dados Solematica, atualizados mensalmente a partir de ARERA e GME.

Retorna: Preço de autoconsumo (EUR/kWh), preço SSP, faixa de custo por kWp, custo da bateria por kWh, data da última atualização.

cerca_articoli

Pesquisa o blog Solematica por artigos relacionados a energia.

Entrada:

  • categoria — Filtrar por categoria (ex.: fotovoltaico, incentivi, risparmio)
  • limit — Máximo de resultados (padrão: 10, máximo: 50)

Retorna: Lista de artigos com título, slug, categoria, data, descrição e URL completa.

Exemplos

Pergunte ao Claude:

  • "Quanto produrrebbe un impianto fotovoltaico in Via Garibaldi 15, Torino?"
  • "Confronta le offerte fotovoltaico di Enel e Iren"
  • "Quali provider offrono anche la pompa di calore?"
  • "Qual e il prezzo corrente dell'energia in Italia?"
  • "Cerca articoli sugli incentivi fotovoltaico 2026"

Links

Relacionados

Licença

MIT — veja o arquivo LICENSE.

Autor

Solematica — Soloweb SRL