SwitchBot OpenAPI
通过API控制SwitchBot智能家居设备
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：SwitchBot OpenAPI。 它的用途是：通过API控制SwitchBot智能家居设备 完整的 Skill 内容见：https://321skill.com/skills/switchbot-openapi/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'查询我客厅的SwitchBot窗帘状态'，它会调用OpenAPI获取设备列表并找到对应设备，返回当前开合百分比和电池电量。或者
对AI说：'把卧室灯调暗到50%'，它会发送控制命令并确认指令执行成功。
介绍
SwitchBot OpenAPI 是一个官方提供的接口封装，让你能够通过统一的 API 控制 SwitchBot 旗下的智能家居设备，包括窗帘、灯、传感器、机器人吸尘器等。它解决了用户在多个设备间手动切换 App 操作效率低下的问题，通过一次调用即可完成设备状态查询、指令下发等操作，适合需要自动化控制智能家居的场景。
使用方式非常简单：首先在 SwitchBot App 中获取 Token 和 Secret，然后在代码中引入该库并配置认证信息。之后你就可以通过 API 列出所有设备、获取设备状态、发送控制命令（如开关、调节亮度、调整窗帘开合度等），甚至查询环境传感器数据。所有响应都是 JSON 格式，便于集成到任何系统。
这个 Skill 主要面向智能家居开发者、智能体开发者以及后端工程师。如果你正在搭建一个智能家居控制中心、开发语音助手集成、或者需要将 SwitchBot 设备接入到自动化工作流（如 IFTTT、Home Assistant）中，这个工具将大大简化对接成本。
使用前请确保已在 SwitchBot App 中开启开发者模式并获取有效的 API 凭证。注意 API 调用频率有限制（每分钟 100 次），且某些设备的状态刷新存在延迟。建议不要在需要实时响应的场景（如安防报警）中完全依赖此 API，应结合本地设备状态做二次确认。
核心特点
与其它第三方非官方封装不同，SwitchBot OpenAPI 是官方维护的，文档和接口更新及时，支持最新的设备类型和功能，且认证方式更安全。
注意事项
不适合对实时性要求极高的场景（如毫秒级安防报警），且部分设备（如旧款传感器）可能不支持完整的 API 功能。
常见问题
如何获取 SwitchBot OpenAPI 的 Token 和 Secret？
在 SwitchBot App 的「设置-开发者选项」中开启开发者模式，即可生成 Token 和 Secret。
支持哪些设备？
支持所有 SwitchBot 官方设备，包括窗帘、灯、传感器、机器人、加湿器等，具体可查看官方设备列表。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/switchbot-openapi/raw/index.md 读取 SwitchBot OpenAPI 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/switchbot-openapi/raw/index.md（查看排版版本）