homebridge-smartprugio — プルジオ（PuRUGIO）スマートホーム連携プラグイン

Library
homebridge-smartprugio — プルジオ（PuRUGIO）スマートホーム連携プラグイン

homebridge-smartprugio — プルジオ（PuRUGIO）スマートホーム連携プラグイン

이 리포지토리는 푸르지오 스마트홈의 비공식 API를 이용해 보일러(난방)와 전등을 Homebridge経由でHomeKitから操作できるプラグインです。非公式APIとアプリから取得したトークンを用いるため、製造元の仕様変更やアカウント制限などのリスクがある旨を明示しています。シンプルな構成で導入が比較的容易な点も特徴です。（約300字）

https://github.com/max-jang/homebridge-smartprugio

概要

homebridge-smartprugioは、韓国のマンションブランド「푸르지오（Prugio / プルジオ）」のスマートホーム非公式APIを使い、ボイラー（暖房）と照明をHomebridge経由でApple HomeKitから制御できるプラグインです。非公式なAPI・トークンに依存するため動作保証はなく、製造元のポリシー変更やサーバー仕様の変更で機能が止まる可能性があることを明記しています。基本的なオン/オフ制御に重点を置いた軽量な実装で、HomebridgeユーザーがPrugioデバイスをHomeKitエコシステムに統合する際のブリッジとして機能します。

GitHub

リポジトリの統計情報

  • スター数: 2
  • フォーク数: 0
  • ウォッチャー数: 2
  • コミット数: 6
  • ファイル数: 6
  • メインの言語: JavaScript

主な特徴

  • 非公式APIを利用して푸르지오スマートホームの照明（LIGHTS）とボイラー（HEATING）をHomeKitで操作可能
  • シンプルな構成（index.js と config.json など）で導入が容易
  • スマートホームアプリから抽出したトークンを用いる方式で、既存アカウントでの連携が可能
  • 製造元の仕様変更リスクやアカウント制限リスクを利用者に明示

技術的なポイント

本プラグインはHomebridge向けプラグインの典型的な構成を採用し、Node.js上で動作するJavaScript製です。index.jsがエントリポイントになっており、HomebridgeのAPIを使用してアクセサリ（またはプラットフォーム）を登録し、푸르지오の非公式APIエンドポイントへHTTPリクエストを送ってデバイスの状態取得・制御を行います。認証はスマートホーム公式アプリから抽出したトークンを利用する方式で、トークンの有効期限やリフレッシュ処理はREADMEで注意喚起されています。エラーハンドリングや再試行ロジックは最小限に留めており、製造元APIのレスポンス変化に弱いため、実運用では監視とログ確認が重要です。package.json（リポジトリ内に含まれている可能性が高い）で依存ライブラリ（axiosやrequest相当のHTTPクライアント）が管理される想定で、Homebridgeのバージョン互換性やNodeの推奨バージョンへの注意も必要です。また、非公式APIとトークンを使用するため、セキュリティ面（トークンの保存場所・アクセス権限）やアカウント停止リスクをユーザーが理解したうえで利用する設計になっています。拡張性としては、現在サポートしているデバイスタイプに加え、温度設定やスケジュール管理、状態同期の改善などをindex.jsに機能追加することで対応可能です。

プロジェクトの構成

主要なファイルとディレクトリ：

  • .gitignore: file
  • README.md: file
  • config.json: file
  • image: dir
  • index.js: file

…他 1 ファイル

各ファイルの役割（推定）

  • index.js: Homebridgeプラグインのエントリポイント。アクセサリ/プラットフォームの登録とAPI呼び出しロジックを含む。
  • config.json: ユーザーがHomebridgeのconfigに追加するためのサンプル設定またはプラグインの初期設定ファイル。
  • README.md: 導入手順、注意事項、非公式API利用に関する警告を記載。
  • image ディレクトリ: ドキュメントやREADMEで使うスクリーンショットやアイコン等を格納。
  • .gitignore: ノードモジュールや個人設定ファイルを除外。

まとめ

非公式API利用のリスクを理解した上でHomeKitにPrugio機器を統合したい人向けの軽量プラグイン。

リポジトリ情報：

READMEの抜粋：

homebridge-smartprugio

푸르지오 스마트홈 비공식 API로 보일러/전등을 Homebridge(HomeKit)에서 제어하는 플러그인

푸르지오 스마트홈(비공식 API)과 Homebridge를 연동해 보일러(난방)와 전등을 HomeKit에서 제어하는 플러그인입니다。

클리앙 글(https://www.clien.net/service/board/cm_iot/15914856)를 참고하여 개발했습니다。

⚠️ 비공식 API를 사용합니다. 제조사 정책/서버 변경에 따라 동작이 중단될 수 있습니다。

⚠️ 스마트홈 앱에서 추출한 비공식 API 및 토큰을 사용합니다。해당 사용에 따른 책임과 모든 위험(계정 제한/차단, 서비스 장애 등)은 사용자에게 있습니다。

⚠️ 제조사의 요청이 있을 경우 본 저장소는 비공개로 전환되거나 삭제될 수 있습니다。

특징

  • 전등(LIGHTS): 전원 ON/OFF 제어
  • 보일러(HEATING): 전원 ON/…