Switchai

io.github.US1929由 GitHub 帳號 US1929 發布v1.0.2更新於 Oct 24, 2026

Compare Italian energy tariffs with AI. Analyzes bills, finds best offers, live market indices.

已驗證STDIO僅桌面金融資料與分析

概覽

AI 產生的概覽

為 AI 助理比較義大利電力與瓦斯費率:解析帳單、篩選即時 ARERA 方案並估算年度節省金額。

可以做什麼
  • 從義大利文帳單文字中解析用電量、支出與區域
  • 比較費率並計算節省金額,回傳前三名方案、費用明細與建議結論
  • 列出完整的電力與瓦斯方案目錄
  • 查詢目前 PUN 與 PSV 批發市場指數
適用情境
適合義大利使用者想知道自己電費或瓦斯費是否偏高、想依自身用量與區域查看目前最佳方案,或需要助理讀懂並解讀帳單的情境。它是比價與建議工具,不負責實際辦理更換供應商。
執行需求
以本機 Node.js 程序(npm 套件)執行並呼叫 SwitchAI 的 HTTP 介面,README 範例中設定 SWITCHAI_API_URL。匿名使用僅限經過篩選的部分方案且有頻率限制;完整方案清單與更高每日呼叫額度需要註冊帳號及自助申請的 API 金鑰。需要網路連線。
安裝前請注意
結果僅供參考,實際開通在供應商網站透過推廣連結完成,建議可能帶有商業利益。匿名存取有頻率限制且只顯示部分方案。開通環節不收集個人資料,但用於解析的帳單文字會傳送到 SwitchAI 服務。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Switchai,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

SwitchAI — Energy comparison tools for AI agents (Italy)

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

[Glama MCP Server]

SwitchAI is an energy comparison engine for the Italian market, designed to be called by AI agents. An agent gives it a bill (or consumption + spend), and SwitchAI compares 5.600+ live ARERA offers (electricity & gas), returns the best tariffs with direct activation links, and includes an honesty system so the agent never recommends a switch that doesn't pay off.

SwitchAI is not a chatbot: it is the infrastructure AI agents call. Access it via MCP Server, WebMCP, or the REST API.

text
AI Agent (Claude, Gemini, ChatGPT)   ↓MCP / WebMCP / OpenAPI   ↓SwitchAI engine   ↓Italian energy market   ↓Offers (ARERA) · PUN · PSV · bill parsing · savings calculation   ↓Top 3 offers + activation links (supplier site)

Quickstart (60 seconds)

1. Via REST API — no install

bash
curl -s -X POST https://www.switchai.it/api/analyze \  -H 'Content-Type: application/json' \  -d '{    "commodity": "LUCE",    "yearly_consumption_kwh": 3200,    "zone": "NORD",    "current_annual_spend": 1100  }'

Returns top3 offers with full cost breakdown, honesty recommendation, bill_attualization and an Italian agent_summary.

2. Via MCP Server (Claude Desktop)

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

3. Via WebMCP (Chrome 146+)

Visiting switchai.it registers 4 tools via document.modelContext.registerTool() — discoverable by any WebMCP-compatible agent.

More examples (agent conversations, HTTP equivalents, rules): mcp-server/EXAMPLES.md.


Working example

text
User:    "Questa è la mia bolletta Enel, pago ~1.100€/anno e consumo 3.200 kWh.          Sto pagando troppo?"
Agent:   parse_energy_bill(bill_text)         → { commodity: "LUCE", consumo_annuo: 3200, spesa_annua: 1100, zona: "NORD" }
Agent:   calculate_energy_savings({ commodity:"LUCE", yearly_consumption_kwh:3200,                                    zone:"NORD", current_annual_spend:1100 })         → top3 + honesty:{ recommendation:"switch", savings_eur:240, savings_pct:22 }
Agent:   "Sì, risulti sopra la media del mercato. Con 3.200 kWh in zona NORD puoi          risparmiare ~240€/anno (22%). Le migliori 3 offerte: E.ON LuceClick          (0,1146 €/kWh), Edison Web Luce (0,122 €/kWh), A2A Full Luce (0,139 €/kWh).          Clicca per attivare sul sito del fornitore."

The activation always happens on the supplier's website via affiliate_url. SwitchAI never claims "activation completed" and collects no personal data for activation.


Three access channels for AI agents

ChannelProtocolRequirement
WebMCPdocument.modelContext.registerTool()Chrome 146+
MCP Server@modelcontextprotocol/sdk (Node.js)Claude Desktop or any MCP client
REST APIJSON/HTTPSAny HTTP client

Tools

calculate_energy_savings

Compare Italian tariffs and calculate savings. Returns top 3 offers + Italian agent_summary.

json
POST /api/analyze{  "commodity": "LUCE",  "yearly_consumption_kwh": 3000,  "zone": "NORD",  "current_annual_spend": 900}

Italian aliases are also accepted: consumo_annuo_kwh, spesa_annua_eur, zona, fornitore. Add bill_text for full auto-extraction of consumption, spend and zone.

parse_energy_bill

Extract structured data from an Italian bill text.

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

get_available_offers

Full offer list: 3.196 electricity + 2.411 gas.

GET /api/tariffe/luceGET /api/tariffe/gas

get_market_indices

Current PUN (electricity) and PSV (gas) wholesale indices.

GET /api/market-indices

Optimal agent flow

1. parse_energy_bill(bill_text) → consumi, spesa, zona2. calculate_energy_savings(commodity, consumi, zona, spesa) → offerte + affiliate_url3. Utente clicca il link → attivazione sul sito del fornitore

Honesty system: switch (savings >50€/yr and >5%) / evaluate (30-50€ or 3-5%) / stay (<30€ or <3%).


API Endpoints

MethodEndpointDescription
GET/api/healthHealth check
GET/api/tariffe/luce3.196 electricity offers
GET/api/tariffe/gas2.411 gas offers
POST/api/analyzeFull analysis: parse + compare + honesty + attualization
POST/api/parse-bill-textBill parser
GET/api/market-indicesLive PUN and PSV
GET/api/fornitoriSuppliers list

Data & tiers

  • 5.600+ offers (3.196 luce + 2.411 gas), synced nightly from the official ARERA Portale Offerte (CC BY 4.0).
  • Anonymous: ~270 filtered offers (NORD zone), no registration, rate-limited.
  • Free (registered): full 5.600+ offers, 10 calls/day, self-service API keys.
  • API Pro: full 5.600+ offers, 1.000 calls/day, self-service API keys (free beta).

Stack

  • Frontend: React 19 + Vite 8 + Tailwind CSS 4
  • Backend: PHP 8.5 on OVH Pro Hosting (Apache + mod_rewrite)
  • MCP Server: Node.js + @modelcontextprotocol/sdk
  • WebMCP: Chrome WebMCP spec (W3C WebML CG)
  • Data: ARERA Portale Offerte, sync giornaliero notturno

Discovery files


Keywords (for 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 · energy comparison API Italy · MCP energy tariffs Italy


License & contacts

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


[smithery badge]

來源:README.md,提交 db4ff74

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包,因此其工具未知。

版本歷史

1
  1. v1.0.2最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分