SwitchBot OpenAPI
通过官方OpenAPI控制与查询SwitchBot智能家居设备。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：SwitchBot OpenAPI。 它的用途是：通过官方OpenAPI控制与查询SwitchBot智能家居设备。 完整的 Skill 内容见：https://321skill.com/skills/switchbot-openapi-x-5/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我把书房的灯打开。”，它会通过SwitchBot API发送打开智能开关的指令。或者
对AI说：“客厅现在的温度是多少？”，它会查询连接的温湿度计并返回实时数据。
介绍
本Skill通过调用SwitchBot官方OpenAPI (v1.1)，为用户提供了在AI对话环境中直接控制与查询其SwitchBot智能家居设备的能力。它解决了用户需要离开对话环境、手动打开手机App或调用其他工具来控制设备的繁琐问题，将智能家居控制无缝集成到AI工作流中。
使用时，用户只需在对话中提出需求，例如“打开客厅的空调”或“查看卧室的温湿度”，该Skill便会自动处理与SwitchBot API的认证、请求和响应，将结果清晰地反馈给用户。整个过程无需用户手动处理API密钥或理解复杂的HTTP请求。
它非常适合智能家居爱好者、IoT开发者以及任何希望通过自然语言指令来便捷管理家中SwitchBot设备（如智能开关、温湿度计、窗帘机等）的用户。无论是进行日常控制、设备状态监控，还是自动化场景测试，都能提供便利。
使用前，用户需要在SwitchBot官方App中生成API Token和Secret密钥，并在Skill中妥善配置。请注意，该Skill的功能完全依赖于SwitchBot官方OpenAPI的可用性和设备在线状态，且目前仅支持官方API v1.1版本所涵盖的设备与指令。
核心特点
这是官方认证的OpenAPI集成，确保了指令的稳定性和设备兼容性；与需要模拟红外或蓝牙信号的第三方方案不同，它通过云端直接控制，响应更可靠。
注意事项
不支持非SwitchBot品牌设备，且功能受限于官方OpenAPI v1.1版本的能力范围。
常见问题
如何获取SwitchBot的API密钥？
需要在SwitchBot手机App中，进入“我的”-“偏好设置”-“开发者选项”生成Token和Secret。
支持控制哪些SwitchBot设备？
支持官方OpenAPI v1.1文档中列出的所有设备，如Bot、Curtain、Hub、Meter等。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/switchbot-openapi-x-5/raw/index.md 读取 SwitchBot OpenAPI 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/switchbot-openapi-x-5/raw/index.md（查看排版版本）