ecobee

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

ecobee Skill

ecobee Skill

Overview

概述

Enables Claude to interact with ecobee for controlling smart thermostats, managing room sensors, setting schedules, and optimizing home comfort and energy efficiency.
让Claude能够与ecobee交互,实现智能恒温器控制、房间传感器管理、日程设置,以及优化家居舒适度和能源效率。

Quick Install

快速安装

bash
curl -sSL https://canifi.com/skills/ecobee/install.sh | bash
Or manually:
bash
cp -r skills/ecobee ~/.canifi/skills/
bash
curl -sSL https://canifi.com/skills/ecobee/install.sh | bash
或者手动安装:
bash
cp -r skills/ecobee ~/.canifi/skills/

Setup

配置

Configure via canifi-env:
bash
undefined
通过canifi-env进行配置:
bash
undefined

First, ensure canifi-env is installed:

首先,确保已安装canifi-env:

canifi-env set ECOBEE_EMAIL "your-email@example.com"
undefined
canifi-env set ECOBEE_EMAIL "your-email@example.com"
undefined

Privacy & Authentication

隐私与认证

Your credentials, your choice. Canifi LifeOS respects your privacy.
你的凭证,由你掌控。 Canifi LifeOS尊重你的隐私。

Option 1: Manual Browser Login (Recommended)

选项1:手动浏览器登录(推荐)

If you prefer not to share credentials with Claude Code:
  1. Complete the Browser Automation Setup using CDP mode
  2. Login to the service manually in the Playwright-controlled Chrome window
  3. Claude will use your authenticated session without ever seeing your password
如果你不想与Claude Code共享凭证:
  1. 使用CDP模式完成浏览器自动化配置
  2. 在Playwright控制的Chrome窗口中手动登录该服务
  3. Claude将使用你的已认证会话,全程不会获取你的密码

Option 2: Environment Variables

选项2:环境变量

If you're comfortable sharing credentials, you can store them locally:
bash
canifi-env set SERVICE_EMAIL "your-email"
canifi-env set SERVICE_PASSWORD "your-password"
Note: Credentials stored in canifi-env are only accessible locally on your machine and are never transmitted.
如果你愿意共享凭证,可以将其存储在本地:
bash
canifi-env set SERVICE_EMAIL "your-email"
canifi-env set SERVICE_PASSWORD "your-password"
注意:存储在canifi-env中的凭证仅能在你的本地设备上访问,绝不会被传输。

Capabilities

功能特性

  • Control thermostat temperature and mode
  • Manage room sensor occupancy
  • Set comfort schedules
  • View energy reports
  • Configure vacation and away modes
  • 控制恒温器温度和模式
  • 管理房间传感器占用状态
  • 设置舒适日程
  • 查看能源报告
  • 配置度假和离家模式

Usage Examples

使用示例

Example 1: Temperature Control

示例1:温度控制

User: "Set the ecobee to 70 degrees"
Claude: I'll adjust your ecobee thermostat to 70 degrees.
用户:"把ecobee调到70华氏度"
Claude:我会把你的ecobee恒温器调整到70华氏度。

Example 2: Schedule Management

示例2:日程管理

User: "Set my ecobee to eco mode on weekdays"
Claude: I'll configure your ecobee schedule for eco mode during weekdays.
用户:"让我的ecobee在工作日切换到节能模式"
Claude:我会为你的ecobee配置工作日的节能模式日程。

Example 3: Sensor Check

示例3:传感器检查

User: "Which rooms are currently occupied?"
Claude: I'll check your ecobee sensors for current occupancy status.
用户:"哪些房间目前有人?"
Claude:我会检查你的ecobee传感器,查看当前的占用状态。

Authentication Flow

认证流程

  1. Navigate to ecobee.com via Playwright MCP
  2. Click "Log In" button
  3. Enter ecobee credentials
  4. Handle verification if required
  5. Maintain session for subsequent requests
  1. 通过Playwright MCP导航至ecobee.com
  2. 点击"登录"按钮
  3. 输入ecobee凭证
  4. 如有需要,完成验证步骤
  5. 维持会话以用于后续请求

Error Handling

错误处理

  • Login Failed: Retry authentication up to 3 times, then notify via iMessage
  • Session Expired: Re-authenticate automatically
  • Verification Required: Complete email verification
  • Rate Limited: Implement exponential backoff
  • Device Offline: Report thermostat connectivity
  • 登录失败:最多重试3次认证,然后通过iMessage通知
  • 会话过期:自动重新认证
  • 需要验证:完成邮件验证
  • 速率限制:实现指数退避策略
  • 设备离线:报告恒温器连接状态

Self-Improvement Instructions

自我改进说明

When encountering new UI patterns:
  1. Document ecobee web portal changes
  2. Update selectors for new layouts
  3. Track new sensor capabilities
  4. Monitor energy feature updates
当遇到新的UI模式时:
  1. 记录ecobee门户网站的变更
  2. 更新适配新布局的选择器
  3. 追踪新的传感器功能
  4. 监控能源功能的更新

Notes

注意事项

  • Room sensors for multi-zone comfort
  • Smart Recovery learns heating/cooling times
  • HomeKit, Alexa, and Google compatible
  • Energy reports track usage patterns
  • 房间传感器支持多区域舒适控制
  • Smart Recovery功能可学习加热/制冷时间
  • 兼容HomeKit、Alexa和Google助手
  • 能源报告可追踪使用模式