미홈(샤오미) 기기 관리자
mijiaAPI CLI를 통해 샤오미·미홈 스마트홈 기기를 대화로 조회·제어하는 스킬.
자동화·워크플로중급★ 127⑂ 15AI 점수 8/10마지막 업데이트: 2026. 2. 11.
무엇을 해주나
- 샤오미 계정에 QR 코드로 로그인하고, 등록된 집(home)과 기기 목록을 조회합니다.
- 기기의
did를 찾아 전원(on), 밝기(brightness), 색온도(color-temperature), 색상(color) 등의 속성을 읽고 씁니다. --get_device_info로 해당 모델이 지원하는 속성과 값 범위를 먼저 확인하는 안전한 순서를 안내합니다.- 미홈 앱에 저장된 씬(scene) 실행, 로그인 실패·기기 미검색·속성 설정 실패 등 흔한 문제의 해결법도 정리되어 있습니다.
이런 분께 추천
- 샤오미/미홈 스마트 조명, 플러그, 가전을 쓰면서 터미널이나 Claude Code에서 바로 제어하고 싶은 분
- 스마트홈 제어를 스크립트·자동화 워크플로에 끼워 넣고 싶은 개발자
- 미홈 앱을 열지 않고 기기 상태를 빠르게 점검하려는 분
활용 예시
- "거실 스탠드 켜줘" →
python -m mijiaAPI -l로 did 확인 후set --prop_name on --value True실행. - "침실 조명 밝기를 30으로 낮춰줘" →
--get_device_info로 범위 확인 후set --prop_name brightness --value 30. - "'귀가' 씬 실행해줘" →
python -m mijiaAPI --run_scene "回家"형태로 씬 트리거.
· · · 설치 가이드 · · ·
설치 없이 지금 한 번 써보기
아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.
이 파일의 지시를 읽고 그대로 따라서 나를 도와줘: https://raw.githubusercontent.com/dean2021/mijia-device-manager/HEAD/SKILL.md 내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)
Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.
↓ 쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 dean2021/mijia-device-manager 의 SKILL.m 폴더를 내 ~/.claude/skills/mijia-device-manager/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/dean2021/mijia-device-manager.git ~/.claude/skills/mijia-device-manager⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 파이썬(3.8 이상)과 pip이 설치되어 있는지 확인합니다:
python -V - 의존 패키지를 설치합니다:
pip install mijiaAPI - 스킬을 내려받습니다:
git clone https://github.com/dean2021/mijia-device-manager.git ~/.claude/skills/mijia-device-manager ~/.claude/skills/mijia-device-manager/SKILL.md파일이 있는지 확인합니다.- 최초 로그인을 진행합니다:
python -m mijiaAPI --list_homes→ 표시된 QR 코드를 미홈(Mi Home) 앱으로 스캔합니다. - Claude Code를 재시작하고 "미홈 기기 목록 보여줘"처럼 요청해 동작을 확인합니다.
- 로그인이 꼬이면
rm ~/.config/mijia-api/auth.json후 5단계를 다시 실행합니다.