SwitchBot OpenAPI

通过官方OpenAPI控制与查询SwitchBot智能家居设备

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:SwitchBot OpenAPI。
它的用途是:通过官方OpenAPI控制与查询SwitchBot智能家居设备
完整的 Skill 内容见:https://321skill.com/skills/switchbot-openapi-x-7/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

‘帮我打开书房的空调,并设置为26度制冷模式。’,它会通过SwitchBot API找到你书房对应的空调设备,并发送开机和设置温度、模式的指令。或者

对AI说:‘客厅现在的温度和湿度是多少?’,它会查询客厅温湿度计的状态并返回给你。

介绍

这个Skill解决了用户需要通过AI助手直接管理和查询SwitchBot智能家居设备状态的问题。它通过集成SwitchBot官方的OpenAPI (v1.1),让用户能够用自然语言指令来操作设备。

使用时,用户只需在对话中提及想要控制的SwitchBot设备或想要查询的状态,AI助手便会调用相应的API接口,执行命令或返回设备信息。例如,用户可以说“打开客厅的灯”或“卧室的温湿度是多少”。

该Skill非常适合智能家居爱好者、家庭自动化用户以及任何希望通过语音或对话界面便捷管理SwitchBot设备的人群。它省去了手动打开手机App的步骤,实现了更自然的交互方式。

使用前,用户需要在SwitchBot App中生成API Token和Secret,并配置到Skill中。请注意,此Skill依赖于SwitchBot官方API的可用性和网络连接,且只能控制已绑定到同一SwitchBot账户下的设备。

核心特点

这是基于SwitchBot官方OpenAPI (v1.1)开发的官方集成方案,确保了设备控制的稳定性和功能完整性,与第三方或非官方方案相比具有更高的可靠性。

注意事项

不适合控制非SwitchBot品牌或未绑定到同一账户下的智能家居设备。

常见问题

如何获取SwitchBot的API Token和Secret?

需要在手机上下载并登录SwitchBot App,在‘我的’->‘偏好设置’->‘开发者选项’中开启并生成。

这个Skill可以控制哪些SwitchBot设备?

理论上支持所有可以通过SwitchBot官方OpenAPI (v1.1)控制的设备,如开关、窗帘、温湿度计、插座等,具体请查阅官方文档。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/switchbot-openapi-x-7/raw/index.md 读取 SwitchBot OpenAPI 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。