小牛电动车监控 (v3)
通过 NIU MCP API 一键查询电动车实时状态，无需账号密码，仅需 API Key。
前置准备
获取 API Key
- 打开小牛 App →「我的」→「API-Key 管理」
- 创建或复制 API Key
- 配置到
config.json
配置
编辑 config.json：
{
"api_key": "你的API-Key"
}
运行
# 文本输出
python3 scripts/niu_monitor.py
# JSON 输出（适合脚本调用）
python3 scripts/niu_monitor.py --json
输出字段
| 字段 | 说明 |
|---|---|
| batteryLevel | 电量百分比 (0-100) |
| isCharging | 是否充电中 |
| chargingRemainingTime | 充满剩余时间（分钟，充电中有效） |
| estimatedRange | 预估续航（km） |
| totalMileage | 总里程（km） |
| location | 车辆位置 |
| lastUpdate | 数据更新时间 |
自动功能
- 满电检测：电量 ≥99% 时自动记录满电里程和时间
- 骑行计算：从满电后开始累计骑行距离
- 预警提醒：≥60km 提醒充电，≥70km 警告停止骑行
- 充电豁免：检测到电量上升或充电中时自动忽略骑行警告
- 历史记录：保留最近 100 条数据
API 说明
| 项目 | 值 |
|---|---|
| 端点 | GET https://ai-mcp.niu.com/claw/scooter_info?key={API_KEY} |
| 认证 | API Key（URL 参数） |
| 超时 | 15 秒 |
文件结构
niu-scooter-api/
├── SKILL.md # 本文档
├── config.json # API Key 配置
├── charge_state.json # 状态文件（自动生成）
└── scripts/
└── niu_monitor.py # 监控脚本
定时任务（可选）
# 创建 cron 定时任务（每天 7/12/19 点执行）
cronjob(action='create', schedule='0 7,12,19 * * *',
name='小牛电动车监控',
script='niu_monitor.py',
no_agent=True,
deliver='origin')
注意事项
- 脚本依赖
requests库 - API 调用无需小牛账号密码，仅需 API Key
- 满电检测以 99% 为标准（非 100%）
- 充电中自动豁免骑行距离警告
