feat(tradein): yandex_detail.py — Product JSON-LD + DOM detail parser #466

Merged
lekss361 merged 1 commit from feat/tradein-yandex-detail-parser into main 2026-05-23 13:45:10 +00:00

1 commit

Author SHA1 Message Date
lekss361
f9e0b6bcbe feat(tradein): yandex_detail.py — Product JSON-LD + DOM detail parser
Stage 4 of YandexRealtyScraper v1 (Wave 4 / Worker A — parallel with
yandex_newbuilding.py and yandex_valuation.py).

Module: app/services/scrapers/yandex_detail.py
- YandexDetailScraper(BaseScraper) — async fetch_detail(offer_url)
- DetailEnrichment Pydantic model (offer_id, price/title/rooms/area/floor,
  description, sale_type, views, publish_date, agency block, metro stations,
  photos 8 sizes, newbuilding linkage, NLP best-effort fields)
- Helpers: _find_section_text(h2/h3 -> next siblings), _parse_metro_stations,
  _extract_relative_date, _extract_seller_name, _parse_title

Price source: Product JSON-LD offers.price (exact int) — falls back to None
if missing. Photos: 8 sizes from Product.image[] array.
NLP: parse_house_type / RE_YEAR / RE_METRO_WALK from description text
(best-effort — None when not present).

Tests: 35 unit tests against hand-crafted fixture HTML. All pass. Ruff clean.
2026-05-23 16:38:02 +03:00