philips-hue

name	philips-hue
description	Philips Hue スマートライトの制御スキル。Hue BridgeのローカルCLIP API v2を使用して照明のON/OFF、明るさ調整、色変更、シーン制御を行う。「Hueの電気をつけて」「リビングを暖色にして」「全部の照明を消して」「ライトの一覧」などの依頼時に使用。

Philips Hue 制御スキル

環境変数

.env に以下を設定:

• HUE_BRIDGE_IP - Hue BridgeのローカルIP
• HUE_API_KEY - Hue APIキー

APIキーの取得方法

1. Hue Bridge と同じLANに接続
2. scripts/hue_control.py discover でBridge IPを発見
3. Hue Bridge の物理ボタンを押す
4. scripts/hue_control.py register でAPIキーを取得
5. .env に記録

使い方

# Bridge発見
python3 scripts/hue_control.py discover

# APIキー登録
python3 scripts/hue_control.py register

# デバイス一覧
python3 scripts/hue_control.py list

# ライトON/OFF
python3 scripts/hue_control.py on <light_id>
python3 scripts/hue_control.py off <light_id>

# 明るさ設定 (0-100)
python3 scripts/hue_control.py brightness <light_id> 80

# 色設定 (色温度 153-500 mirek)
python3 scripts/hue_control.py color_temp <light_id> 300

# 全ライトOFF
python3 scripts/hue_control.py all_off

API リファレンス

ローカル CLIP API v2 エンドポイント: https://<bridge_ip>/clip/v2/resource/

主要リソース:

• light - 個別ライト
• room - 部屋
• scene - シーン
• grouped_light - グループライト

認証ヘッダー: hue-application-key: <api_key>

SSL証明書はBridge自己署名のため verify=False で接続する。