SwitchBot OpenAPI
通过官方API控制查询SwitchBot智能设备
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：SwitchBot OpenAPI。 它的用途是：通过官方API控制查询SwitchBot智能设备 完整的 Skill 内容见：https://321skill.com/skills/switchbot-openapi-x-4/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'帮我查询所有SwitchBot设备的当前状态'，它会自动调用OpenAPI列出所有设备及其运行状态（如窗帘开合百分比、温度、湿度等）。再比如
对AI说：'把客厅空调调到26度制冷模式'，它会解析指令并发送对应的红外遥控命令。
介绍
SwitchBot OpenAPI 是一个基于官方 v1.1 接口的 Skill，用于远程控制 SwitchBot 旗下的智能家居设备（如窗帘电机、灯泡、空调伴侣、传感器等），并实时查询设备状态。它封装了设备发现、命令发送、状态获取等核心操作，让你无需手动编写 HTTP 请求即可快速集成智能家居控制能力。
使用方式非常直接：你只需向 AI 描述想要控制的设备或希望查询的状态，Skill 会自动调用对应的 API 完成操作。例如，说“关闭客厅的灯”或“查询卧室温度”，它会解析指令、调用 API 并返回结果。整个过程无需你记忆复杂的 API 参数或设备 ID。
这个 Skill 特别适合智能家居玩家、物联网开发者以及希望通过 AI 助手统一管理家庭设备的用户。无论你是想用自然语言控制灯光窗帘，还是希望将设备状态集成到自动化工作流中，它都能提供稳定、官方的底层支持。
使用前需要准备 SwitchBot 账号和 API Token，并确保设备已通过 SwitchBot Hub 连接至互联网。建议在首次使用前先通过官方 APP 完成设备绑定，避免因网络或权限问题导致操作失败。另外，OpenAPI 对调用频率有一定限制，高频轮询场景注意控制请求间隔。
核心特点
与第三方非官方库相比，这是 SwitchBot 官方发布的 OpenAPI，接口稳定、更新及时，且支持所有官方文档中列出的设备类型和命令，无需担心兼容性问题。
注意事项
不适用于未接入 SwitchBot Hub 的蓝牙设备，且需要设备处于联网状态才能远程控制。
常见问题
如何获取 SwitchBot API Token？
在 SwitchBot APP 中进入「设置」→「开发者选项」→「获取 Token」，然后复制保存即可。
支持哪些设备类型？
支持窗帘电机、灯泡、灯带、空调伴侣、温湿度传感器、接触传感器、人体传感器、智能插座等主流设备。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/switchbot-openapi-x-4/raw/index.md 读取 SwitchBot OpenAPI 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/switchbot-openapi-x-4/raw/index.md（查看排版版本）