Skip to content

US1929/switchai

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SwitchAI — AI Agent per Tariffe Energia Italia

Sito: switchai.it · Mercato: Italia · Stack: React 19 + PHP 8.5 + WebMCP + MCP Server

SwitchAI è un agente AI nativo per il confronto e il cambio automatico del fornitore energia nel mercato libero italiano. Non è un comparatore tradizionale: l'utente fornisce la sua bolletta, e l'AI analizza i dati, confronta 44+ offerte attive di Luce e Gas, e attiva la tariffa migliore — tutto in linguaggio naturale.


Come funziona

Utente (linguaggio naturale)
  ↓
AI Agent (Claude, Gemini, ChatGPT, o qualsiasi LLM)
  ↓
SwitchAI Tools (WebMCP o MCP Server)
  ↓
API PHP → 44+ offerte live → sottoscrizione attivata

Tre canali di accesso per AI agent

Canale Protocollo Requisiti
WebMCP navigator.modelContext.registerTool() Chrome 146+
MCP Server @modelcontextprotocol/sdk Node.js Claude Desktop o client MCP
REST API JSON/HTTPS Qualsiasi client HTTP

Tool disponibili

calculate_energy_savings

Confronta tariffe e calcola risparmio. Restituisce top 3 offerte + agent_summary in italiano pronto per l'utente.

POST /api/webmcp-endpoint
{
  "commodity": "LUCE",
  "yearly_consumption_kwh": 3000,
  "zone": "NORD",
  "current_annual_spend": 900
}

parse_energy_bill

Estrae dati strutturati da testo bolletta italiana (fornitore, POD/PDR, consumi, spesa, zona).

POST /api/parse-bill-text
{
  "bill_text": "...testo bolletta..."
}

get_available_offers

Lista completa offerte: 25 luce + 19 gas con prezzi, tipo contratto, quota fissa.

GET /api/tariffe/luce
GET /api/tariffe/gas

submit_subscription

Attiva la sottoscrizione. Supporta dry_run: true per anteprima senza invio.

POST /api/subscription/submit
{
  "tariff_id": "...",
  "nome": "Mario",
  "cognome": "Rossi",
  "codice_fiscale": "RSSMRA80A01H501Z",
  "email": "[email protected]",
  "dry_run": true
}

Configurazione MCP Server (Claude Desktop)

{
  "mcpServers": {
    "switchai": {
      "command": "node",
      "args": ["/percorso/assoluto/mcp-server/index.js"],
      "env": {
        "SWITCHAI_API_URL": "https://www.switchai.it/api"
      }
    }
  }
}

Flusso ottimale per AI agent

1. parse_energy_bill(bill_text)
   → consumi, spesa, zona, POD/PDR

2. calculate_energy_savings(commodity, consumi, zona, spesa)
   → top 3 offerte + risparmio annuo + agent_summary

3. [con conferma utente] submit_subscription(tariff_id, dati)
   → attivazione completata

API Endpoints

Method Endpoint Descrizione
GET /api/health Health check
GET /api/tariffe/luce 25 offerte luce
GET /api/tariffe/gas 19 offerte gas
POST /api/webmcp-endpoint Calcolo risparmio + agent_summary
POST /api/parse-bill-text Parser bolletta
POST /api/analyze-bill PDF + calcolo risparmio
POST /api/subscription/submit Attivazione tariffa
GET /api/subscription/status/{id} Stato sottoscrizione
GET /api/market-indices PUN e PSV live

Stack tecnico

  • Frontend: React 19 + Vite 8 + Tailwind CSS 4
  • Backend: PHP 8.5 su OVH Pro Hosting (Apache + mod_rewrite)
  • MCP Server: Node.js + @modelcontextprotocol/sdk
  • WebMCP: Google Chrome Labs WebMCP spec
  • Dati tariffe: 44+ offerte da fornitori italiani (ARERA-compliant)
  • Mercato: Italia — Mercato Libero Energia

Discovery files


Keyword semantiche (per LLM retrieval)

comparatore tariffe energia italia · cambio fornitore luce gas · bolletta energia AI · risparmio bolletta · PUN PSV ARERA · mercato libero energia · WebMCP energy agent · MCP server energia italia · AI energy comparison Italy


Licenza e contatti

Operatore: SwitchAI
Email: [email protected]
Sito: https://www.switchai.it
Mercato: Italia · GDPR compliant

About

AI agent for Italian energy tariff comparison. Analyzes utility bills, compares 44+ offers (electricity & gas), and activates the best tariff. WebMCP + MCP Server compatible. switchai.it

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors