SwitchBot OpenAPI
通过官方OpenAPI控制与查询SwitchBot智能家居设备。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：SwitchBot OpenAPI。 它的用途是：通过官方OpenAPI控制与查询SwitchBot智能家居设备。 完整的 Skill 内容见：https://321skill.com/skills/switchbot-openapi-x-3/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“把我书房里的智能灯调成暖光模式”，它会通过SwitchBot API找到对应设备并发送调光指令。或者
对AI说：“检查一下卧室的温湿度计”，它会查询设备状态并返回当前的温度和湿度读数。
介绍
本Skill为开发者提供了通过SwitchBot官方OpenAPI（v1.1）控制其智能家居设备的标准化接口。它解决了用户需要手动集成或编写复杂代码来管理SwitchBot设备的问题，将繁琐的API调用封装为简单的对话指令。
使用时，用户只需在对话中提出需求，例如查询设备列表、获取状态或发送控制命令，Skill便会自动处理身份认证、API请求构造和响应解析等底层工作，将结果清晰地呈现给用户。
该Skill主要适合智能家居爱好者、物联网应用开发者以及希望将SwitchBot设备集成到自动化流程中的用户。无论是进行简单的远程开关操作，还是构建复杂的场景联动，都能从中获得便利。
使用前，用户需要在SwitchBot官方App中生成并配置好Open Token和Secret Key。请注意，该Skill的功能完全依赖于SwitchBot官方OpenAPI的可用性和设备兼容性，部分高级功能或新设备可能需要等待API更新支持。
核心特点
直接对接SwitchBot官方OpenAPI，确保功能与官方App同步，避免了使用非官方SDK可能存在的稳定性与兼容性问题；将API调用封装为自然语言交互，无需编写代码即可完成设备管理。
注意事项
不适合控制非SwitchBot品牌的智能设备，且功能受限于SwitchBot官方OpenAPI当前支持的设备类型与指令。
常见问题
如何使用这个Skill控制SwitchBot设备？
在对话中直接说出你的需求，例如“打开客厅的空调”或“列出我所有的SwitchBot设备”，Skill会调用API执行。
需要准备什么才能使用？
需要先在SwitchBot手机App中生成Open Token和Secret Key，并在Skill配置中填写。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/switchbot-openapi-x-3/raw/index.md 读取 SwitchBot OpenAPI 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/switchbot-openapi-x-3/raw/index.md（查看排版版本）