Switchai

SwitchAI — 面向 AI Agent 的能源比价工具（意大利）

网站：switchai.it · 市场：意大利 · 技术栈：React 19 + PHP 8.5 + WebMCP + MCP 服务

SwitchAI 是面向意大利市场的能源比价引擎，专为 AI Agent 调用而设计。 Agent 向它提供账单（或用量和支出），SwitchAI 会对比 5.600+ 个 ARERA 实时报价（电力和天然气），返回最优惠的费率及直达开通链接，并提供一套诚信机制，确保 Agent 不会在切换无法带来收益时推荐切换。

SwitchAI 不是聊天机器人：它是供 AI Agent 调用的基础设施。可通过 MCP 服务、WebMCP 或 REST API 访问。

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)

---

快速入门（60 秒）

1. 通过 REST API — 无需安装

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
  }'

返回 top3 报价及完整费用明细、honesty 建议、bill_attualization 和意大利语 agent_summary。

2. 通过 MCP 服务（Claude Desktop）

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

3. 通过 WebMCP（Chrome 146+）

访问 switchai.it 后，会通过 document.modelContext.registerTool() 注册 4 个工具，任何兼容 WebMCP 的 Agent 都可以发现这些工具。

更多示例（Agent 对话、HTTP 等效调用、规则）：mcp-server/EXAMPLES.md。

---

工作示例

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."

用户始终会通过供应商网站上的 affiliate_url 开通服务。SwitchAI 绝不会声称“已完成开通”，也不会收集开通所需的个人数据。

---

AI Agent 的三种访问渠道

渠道	协议	要求
WebMCP	document.modelContext.registerTool()	Chrome 146+
MCP 服务	@modelcontextprotocol/sdk (Node.js)	Claude Desktop 或任何 MCP 客户端
REST API	JSON/HTTPS	任何 HTTP 客户端

---

工具

calculate_energy_savings

比较意大利费率并计算节省金额。返回排名前 3 的报价及意大利语 agent_summary。

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

也接受意大利语别名：consumo_annuo_kwh、spesa_annua_eur、zona、fornitore。添加 bill_text 可自动提取用量、支出和区域。

parse_energy_bill

从意大利账单文本中提取结构化数据。

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

get_available_offers

完整报价列表：3.196 个电力报价 + 2.411 个天然气报价。

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

get_market_indices

当前 PUN（电力）和 PSV（天然气）批发指数。

GET /api/market-indices

---

最优 Agent 工作流

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

诚信机制：switch（每年节省 >50€ 且 >5%）/ evaluate（30-50€ 或 3-5%）/ stay（<30€ 或 <3%）。

---

API 端点

方法	端点	描述
GET	/api/health	健康检查
GET	/api/tariffe/luce	3.196 个电力报价
GET	/api/tariffe/gas	2.411 个天然气报价
POST	/api/analyze	完整分析：解析 + 比较 + 诚信判断 + 费用调整
POST	/api/parse-bill-text	账单解析器
GET	/api/market-indices	实时 PUN 和 PSV
GET	/api/fornitori	供应商列表

---

数据与套餐

• 5.600+ 个报价（3.196 个电力 + 2.411 个天然气），每晚从 ARERA 官方 Portale Offerte 同步（CC BY 4.0）。
• 匿名访问：约 270 个筛选后的报价（NORD 区域），无需注册，但有速率限制。
• 免费（已注册）：完整的 5.600+ 个报价，每天 10 次调用，可自助获取 API 密钥。
• API Pro：完整的 5.600+ 个报价，每天 1.000 次调用，可自助获取 API 密钥（免费 Beta 版）。

---

技术栈

• 前端：React 19 + Vite 8 + Tailwind CSS 4
• 后端：OVH Pro Hosting 上的 PHP 8.5（Apache + mod_rewrite）
• MCP 服务：Node.js + @modelcontextprotocol/sdk
• WebMCP：Chrome WebMCP 规范（W3C WebML CG）
• 数据：ARERA Portale Offerte，每晚同步

---

Discovery files

• /llms.txt — LLM site description
• /webmcp.json — WebMCP tool discovery
• /per-llm — machine-readable documentation
• /per-llm-examples — 15 agent conversation patterns
• /openapi.json — OpenAPI 3.0 spec

---

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

---