switchr-api

SwitchBot API client for Node.js. Read temperature sensors and control devices.

Setup

1. Get API credentials from the SwitchBot app: Profile > Preferences > Developer Options
2. Create .env.local with your credentials (checked in order, first found is used):
   • .env.local (current directory)
   • ~/.config/switchr-api/.env.local
   • ~/.switchbot.env.local

SWITCHBOT_TOKEN=your-token-here
SWITCHBOT_SECRET=your-secret-here

Usage

import Switchr from "switchr-api";

const switchr = new Switchr();

// List devices
const { devices } = await switchr.getDevices();

// Get single temperature
const temp = await switchr.getTemperature(deviceId);
console.log(temp.temperature, temp.unit, temp.humidity, temp.battery);

// Get all temperatures
const all = await switchr.getAllTemperatures();

// Get device status
const status = await switchr.getStatus(deviceId);

License

MIT