Умная лампа отвечает на HTTP- или UDP-запросы только после включения режима локального управления — без него любой парсинг состояния (яркость, цветовая температура, статус питания) упрётся в отказ соединения. Именно с этой проверки начинается любая интеграция: прежде чем писать скрипт, убедитесь, что лампа вообще принимает локальные команды, а не работает исключительно через облако производителя.
Под парсингом для лампы обычно понимают две разные задачи: программное получение телеметрии с самого устройства (статус, параметры света, потребление) и сбор данных о лампах с внешних источников — например, цен и характеристик из интернет-магазинов. В этой статье разберём оба сценария, но основной фокус — на первом, потому что именно он вызывает больше всего вопросов у пользователей Yeelight, Tuya-совместимых устройств и систем умного дома.
Как устроен обмен данными с умной лампой
Большинство умных ламп общаются с внешним миром по одному из трёх каналов: облачный API производителя, локальный API внутри домашней сети и проприетарный протокол поверх UDP или TCP. Облачный вариант требует регистрации разработчика и токена доступа, зато работает из любой точки мира. Локальный — быстрее и не зависит от интернета, но его нужно явно активировать в приложении лампы.
Ответ устройства почти всегда приходит в формате JSON, и именно его разбор называют парсингом. Типичный ответ содержит поля вроде power, bright, ct (цветовая температура) и rgb. Набор полей зависит от модели и прошивки, поэтому универсальной схемы не существует — структуру ответа нужно смотреть в документации конкретного протокола или просто вывести сырой ответ и изучить его.
Подготовка: включение локального управления
Для ламп Yeelight локальный режим включается в официальном приложении: настройки устройства, пункт в духе «LAN Control» / «Управление по локальной сети». Название пункта может отличаться в зависимости от версии приложения, поэтому сверьтесь с инструкцией к своей модели. Без этого переключателя порт лампы просто не слушает входящие соединения.
Устройства на платформе Tuya устроены иначе: локальный доступ возможен через local key — ключ шифрования, который привязан к устройству. Его получают через облачный кабинет разработчика Tuya, и процедура периодически меняется. Если вы планируете такой путь, будьте готовы сверяться с актуальной документацией платформы.
- 🔌 Подключите лампу и компьютер к одной Wi-Fi сети — локальный API недоступен между разными подсетями.
- 📱 Включите режим локального управления в приложении производителя, если он предусмотрен моделью.
- 🔑 Для Tuya-устройств заранее получите local key и узнайте IP-адрес лампы.
- 🧭 Узнайте IP лампы через список клиентов роутера или сканер сети.
⚠️ Внимание: сброс лампы к заводским настройкам почти всегда отзывает ключи доступа и отключает локальный режим. После любого сброса токены и local key придётся получать заново.
Парсинг состояния лампы через локальный API
После активации локального режима лампа Yeelight принимает TCP-команды на известном порту в текстовом формате JSON-RPC. Запрос состояния выглядит как команда get_prop со списком нужных свойств. Проверить связь можно даже без скрипта — утилитой telnet или nc, отправив команду вручную и посмотрев сырой ответ.
{"id":1,"method":"get_prop","params":["power","bright","ct"]}В ответ лампа пришлёт JSON с массивом значений в том же порядке, что и запрошенные свойства. Парсинг сводится к стандартному разбору JSON любым языком — в Python это json.loads(). Не забывайте, что порядок значений привязан к порядку параметров запроса: если поменяете местами поля, поменяется и порядок в ответе.
☑️ Проверка перед написанием скрипта
Для Python существуют готовые библиотеки — например, yeelight — которые берут на себя соединение и парсинг. Это удобно, но полезно сначала разобрать протокол вручную: тогда ошибки вида «пустой ответ» или «соединение сброшено» перестанут быть загадкой.
Облачный API и его ограничения
Облачный парсинг нужен, когда устройство недоступно локально — например, вы управляете лампой в другой квартире. Здесь данные проходят через серверы производителя, а доступ оформляется через токен или OAuth. Ответ тоже приходит в JSON, но добавляются задержки и лимиты на частоту запросов.
Главный риск облачного подхода — зависимость от чужой инфраструктуры. Производитель может изменить формат ответа, закрыть эндпоинт или ограничить регион, и ваш парсер сломается без предупреждения. Поэтому для стабильной автоматизации локальный доступ предпочтительнее, а облако разумно использовать как запасной канал.
Сравнение способов получения данных
| Способ | Скорость | Зависимость от интернета | Сложность настройки |
|---|---|---|---|
| Локальный API (Yeelight LAN) | Высокая | Нет | Низкая |
| Tuya local key | Высокая | Нет | Средняя |
| Облачный API | Средняя | Да | Средняя |
| Готовые библиотеки / Home Assistant | Высокая | Зависит от интеграции | Низкая |
Выбор зависит от задачи: для разового скрипта проще взять готовую библиотеку, для постоянной автоматизации — поднять локальное подключение, а для удалённого доступа без настройки сети — облако. Комбинировать способы тоже никто не запрещает.
Парсинг цен и характеристик ламп с сайтов
Второй смысл запроса — сбор данных о лампах как товаре: цены, мощность, тип цоколя, наличие. Здесь работают классические инструменты веб-парсинга: requests и BeautifulSoup для статичных страниц, Playwright или Selenium для страниц, где данные подгружаются JavaScript.
Перед написанием парсера откройте инструменты разработчика в браузере и посмотрите, откуда приходят данные. Часто цена подтягивается отдельным XHR-запросом к внутреннему API магазина — и парсить этот JSON напрямую куда надёжнее, чем выковыривать цифры из HTML-разметки, которая меняется при каждом редизайне.
⚠️ Внимание: массовый парсинг магазинов может нарушать условия использования сайтов. Проверьте robots.txt и правила площадки, ограничьте частоту запросов и указывайте честный User-Agent.
Почему парсер перестаёт работать через пару недель
Чаще всего причина в смене HTML-структуры сайта или ротации токена устройства. Делайте селекторы устойчивыми — привязывайтесь к смысловым атрибутам, а не к порядку элементов, и логируйте сырые ответы, чтобы быстро находить, где именно сломался разбор.
Типичные ошибки и их диагностика
Самая частая жалоба — «лампа не отвечает». Диагностику ведите от простого к сложному: сначала ping по IP, затем проверка порта, затем отправка тестовой команды вручную. Если ping проходит, а команда нет — вероятнее всего, локальный режим выключен или лампа получила новый IP после перезагрузки роутера.
Вторая группа проблем — ошибки разбора JSON. Они возникают, когда устройство присылает нестандартный ответ: уведомление о смене состояния вместо ответа на запрос. Лампы Yeelight, например, сами рассылают уведомления при изменении параметров, и парсер должен уметь отличать их от ответов на свои команды — по полю method в сообщении.
- 🔄 Закрепите IP лампы в настройках роутера (резервирование DHCP), иначе адрес «уплывёт».
- 🧩 Проверяйте поле
idв ответе, чтобы сопоставлять ответы со своими запросами. - ⏱️ Добавьте таймауты: зависший сокет без таймаута повесит весь скрипт.
- 📋 Логируйте сырой ответ перед парсингом — это экономит часы отладки.
⚠️ Внимание: не отправляйте команды в цикле без пауз — устройства имеют ограничение на частоту запросов, и при превышении лампа может временно перестать отвечать.
FAQ: частые вопросы о парсинге для лампы
Можно ли парсить лампу без приложения производителя?
Частично. Локальный режим всё равно включается через официальное приложение хотя бы один раз, дальше скрипты работают автономно. Полностью обойти приложение обычно нельзя — оно нужно для первичной привязки к Wi-Fi.
Что делать, если лампа отвечает пустой строкой?
Проверьте, включён ли локальный режим, совпадает ли подсеть у лампы и компьютера, и не сменился ли IP. Затем отправьте команду вручную через telnet или nc, чтобы отделить проблему сети от ошибки в коде.
Подходит ли этот подход для любых умных ламп?
Нет. Наличие локального API зависит от модели и прошивки: одни лампы работают только через облако, другие поддерживают локальное управление. Перед покупкой устройства под свои скрипты проверьте документацию конкретной модели.
Чем парсить данные о лампах с сайта магазина?
Для статичных страниц достаточно requests и BeautifulSoup. Если контент подгружается скриптами, используйте Playwright или найдите внутренний JSON-API сайта через инструменты разработчика — это надёжнее разбора HTML.
Безопасно ли открывать локальный доступ к лампе?
В пределах домашней сети — да, при условии защищённого Wi-Fi. Не пробрасывайте порт лампы в интернет через роутер: локальный API обычно не имеет авторизации, и устройство станет доступно любому.