Property Listings

Показывает объекты недвижимости и предложения об аренде карточками в десктопном приложении.

Метаданные навыка


Источник	Опциональный — устанавливается командой `hermes skills install official/productivity/property-listings`
Путь	`optional-skills/productivity/property-listings`
Версия	`0.1.0`
Автор	Teknium (teknium1), Hermes Agent
Лицензия	MIT
Платформы	linux, macos, windows
Теги	`property`, `rental`, `real-estate`, `listings`, `desktop`, `cards`

Справочник: полный SKILL.md

инфо

Ниже приведено полное определение навыка, которое Hermes загружает при его активации. Именно эти инструкции видит агент, когда навык включён.

Навык Property Listings

Показывает найденные объекты недвижимости листаемыми карточками прямо в транскрипте десктопного Hermes. Это рецепт подачи, а не сервис поиска объявлений и не инструмент инвестиционной оценки.

Когда использовать

Показываете результаты поиска жилья или аренды, сравниваете короткий список, меняете порядок объектов.
Продолжаете разговор об уже показанном объекте: оставайтесь в карточках, чтобы короткий список оставался сравнимым.
Вне десктопного приложения используйте обычный Markdown со ссылками на источники — прочие клиенты рендерить блоки listing не обязаны.

Требования

Разговор в десктопном Hermes для нативных карточек; бэкенд при этом может быть и локальным, и удалённым.
Данные об объекте — от пользователя либо проверенные через web_search, web_extract или доступные в этой сессии инструменты браузера.
Для оформления карточек не нужны ни дополнительные ключи API, ни зависимости.

Как запускать

Поставьте этот опциональный навык из каталога навыков или через terminal:

hermes skills install official/productivity/property-listings

Перед показом объявлений загрузите его через skill_view(name="property-listings"). Установка не достраивает индекс навыков уже идущего разговора: чтобы навык находился сам, начните новый разговор — либо загрузите установленный навык явно.

Быстрый справочник

Выдайте блок кода с языком listing, внутри которого лежит корректный JSON. Для одного объекта — объект, для сравнения — массив объектов или { "listings": [...] }.

Поле	Формат и смысл
`address`	Обязательное непустое поле: адрес или заголовок объекта.
`price`	Отформатированная строка с валютой и, если это аренда, периодом.
`beds`, `baths`	Положительные числа; неизвестное значение лучше опустить.
`size`	Площадь с единицами измерения.
`note`	Почему на этот объект стоит посмотреть.
`facts`	Массив коротких проверенных характеристик или удобств.
`catches`	Массив рисков и вопросов, которые надо выяснить до просмотра.
`images`	Прямые HTTPS-адреса фотографий в порядке показа; первая — главная.
`links`	Массив ссылок на страницы объекта вида `{ "label": "Source", "url": "https://..." }` — не на выдачу поиска.

Порядок действий

Соберите адрес, цену, характеристики, фотографии и канонический адрес страницы объекта. Отделяйте проверенные факты от неизвестного: цены, удобства и адреса фотографий выдумывать нельзя.
Дубли одного объекта с разных порталов сведите в одну карточку, сохранив полезные ссылки на источники. Даты сведений и оговорки о доступности оставьте в тексте вокруг карточки.
Блок listing выдавайте для каждого показанного объекта — в том числе в продолжениях разговора и при смене порядка. Факты держите короткими, всё нерешённое отправляйте в catches.
Перед отправкой проверьте JSON. Этот выдуманный пример показывает все поля; его значения и адреса замените проверенными данными объявления:

{
  "address": "12 Example Lane",
  "price": "$2,400/mo",
  "beds": 3,
  "baths": 2.5,
  "size": "1,600 sqft",
  "note": "Fits the requested space and budget.",
  "facts": ["12-month lease", "Covered parking"],
  "catches": ["Verify pet policy and total move-in fees"],
  "images": ["https://example.com/property/front.jpg", "https://example.com/property/kitchen.jpg"],
  "links": [{"label": "Listing details", "url": "https://example.com/property/12"}]
}

Подводные камни

Карточку составляют из собранных данных. Её не тянут по адресу объявления и не встраивают страницу портала.
Скудной карточке достаточно одного адреса. Неизвестные поля пропускайте, а не заполняйте догадками.
Берите прямые удалённые адреса картинок — не локальные пути, не data-URL и не страницы поисковой выдачи. Просроченные или закрытые картинки из галереи просто исчезнут, а текст и ссылки останутся важны.
В одном блоке — не больше 24 объектов, 40 фотографий на объект и 12 записей в facts, catches и links. Текстовые поля рендерер обрезает до 400 символов.
Сломанный JSON или карточка без опознавательных признаков превращаются в обычный блок кода. И наоборот: корректная карточка ещё не доказывает, что само объявление свежее и достоверное.

Проверка

У каждого показанного объекта есть адрес и проверенная ссылка на источник, а неизвестное названо неизвестным.
Десктоп показывает адрес, цену, характеристики, факты, подвохи и ссылки нативной карточкой.
Фотографии складываются в галерею, по щелчку открывается лайтбокс. От трёх фотографий собирается мозаика «главная плюс дополнительные», остальные снимки листаются там же.
Карточка не отрисовалась — сверьте язык блока и JSON, а затем оставьте читаемый Markdown-вариант с теми же фактами и ссылками.