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 分