안녕하세요! 스마트한 일상을 설계하는 테크 블로거 스마트한수입니다. 오늘은 LG 가전을 사용하시는 분들이라면 눈이 번쩍 뜨일만한 주제를 가져왔습니다. 바로 LG ThinQ API를 활용해 내 가전을 Home Assistant(HA)에 완벽하게 연동하는 방법입니다.
LG ThinQ API 공식 개방: PAT 발급부터 Home Assistant 연동까지
2026년 현재, LG전자는 ThinQ Connect API를 통해 개발자와 파워 유저들에게 생태계를 적극적으로 개방하고 있습니다. 이제 단순한 제어를 넘어 실시간 데이터 수집과 진정한 자동화를 구현할 수 있게 되었습니다.
📋 포스팅 목차
- 준비 단계: LG ThinQ Developer PAT 발급 가이드
- 연동 단계: Home Assistant(HA)에 ThinQ 통합하기
- 심화 단계: MQTT를 활용한 실시간 데이터 대시보드 구축
- 확장 단계: Apple HomeKit Bridge로 시리(Siri) 음성 제어
- 인사이트: 안정적인 스마트홈 설계 전략
STEP 1. LG ThinQ PAT(개인 액세스 토큰) 발급받기
가장 먼저 HA와 LG 서버를 이어줄 '통행증'인 PAT를 발급받아야 합니다.
- LG ThinQ Developer 사이트(connect-pat.lgthinq.com)에 접속하여 로그인합니다.
- 'My Projects'에서 새 프로젝트를 생성합니다.
- API Scopes 설정 시 기기 목록, 상태 조회, 제어, 이벤트 구독 등 모든 권한을 반드시 체크해야 합니다.
- 생성된 토큰은 단 한 번만 노출되므로 반드시 따로 저장해두세요.
STEP 2. Home Assistant에 ThinQ 통합구성요소 설치
- HACS(Home Assistant Community Store)를 통해 LG ThinQ 리포지토리를 추가합니다.
- 설정 > 기기 및 서비스 > 통합구성요소 추가에서 'LG ThinQ'를 검색합니다.
- 발급받은 PAT 값과 지역 코드(ko-KR)를 입력하여 인증을 완료합니다.
📊 LG ThinQ API 연동 데이터 및 활용 가이드
| 가전 종류 | 주요 수집 데이터 (Entities) | 자동화 활용 예시 |
|---|---|---|
| 세탁기/건조기 | 현재 상태, 남은 시간, 문 열림 여부 | 완료 시 거실 스마트 조명을 파란색으로 점멸 |
| 에어컨 | 실내 온도, 전력 소비량, 희망 온도 | 누적 전력량 초과 시 절전 모드로 자동 전환 |
| 공기청정기 | 미세먼지(PM2.5) 수치, 필터 수명 | 먼지 수치 높을 시 외부 창문 닫기 알림 전송 |
| 코드제로 | 배터리 잔량, 먼지통 비움 상태 | 배터리 부족 시 충전 확인 푸시 알림 |
STEP 3. Apple HomeKit 연동 및 시리(Siri) 제어
아이폰 사용자라면 HA의 HomeKit Bridge 기능을 활용해 LG 가전을 홈 앱으로 가져올 수 있습니다. "시리야, 건조기 꺼줘" 한마디로 모든 제어가 가능해집니다.
💡 [인사이트: 스마트한수의 실전 노하우]
LG 가전 API 연동의 핵심은 '데이터의 시각화'와 '에너지 절약'입니다. 실시간 전력 사용량을 추적하여 피크 시간대 사용을 제한하는 루틴을 만들어 보세요. 단, PAT는 만료 주기가 있으므로 HA 대시보드에 토큰 만료 알림 센서를 만들어 두는 것을 추천합니다.
오늘 가이드가 여러분의 더 스마트한 집을 만드는 데 도움이 되었길 바랍니다. 궁금한 점은 댓글로 남겨주세요! 감사합니다.