Files
buryan-infra/ops/audits/VENDOR-DOC-SOURCES-2026-11-14.md
T

4.5 KiB

Где искать документацию вендоров: разбор источников и API (14.11.2026)

Владелец попросил найти варианты самому: может, есть API или другие пути. Ниже — что проверено и что из этого работает.

Официальные сайты

Источник Что есть PDF
hitrolink.tech WordPress + WooCommerce, каталог 104 товара нет: WP media API отдаёт только картинки (159 jpeg, 483 png) и 3 видео; карты вложений в sitemap нет
hitrolink.com.ru «Официальный поставщик в России», OpenCart нет: /downloads → 403 (дилерский), /docs → 404, ссылка href="docs" на /service ведёт в никуда
hitrolink.com глобальный сайт PDF-ссылок нет

Дистрибьюторы и магазины

Сайт Что оказалось PDF
snk-s.ru дистрибьютор, 36 карточек hti-* 23 PDF — добавлены
avicon.ru «Официальный дистрибьютор AV-оборудования и ВКС», 8 товаров бренда 9 PDF — добавлены
avikon.ru парковка домена (Руцентр, «домен продаётся») —
avikon.com польская компания, Hitrolink нет —
tele-vek.ru «официальный диллер», 60 страниц обойдено 0
voip-shop.ru магазин, 5 карточек 0

API и архивы — что проверено

Способ Результат
WordPress REST API hitrolink.tech/wp-json/wp/v2/media работает, но PDF нет (только изображения и видео)
sitemap-index.xml Avicon + sitemap-files.xml работает; в файловой карте 15 файлов, Hitrolink среди них нет
Wayback Machine (archive.org/wayback/available) API отвечает, но для hitrolink.tech снапшотов нет
Common Crawl index (index.commoncrawl.org) коллекции есть (последняя CC-MAIN-2026-43), но запросы по домену отдают 502/504 — сервис недоступен
Поисковые API (Yandex XML, Bing) требуют ключей, которых у нас нет

Вывод: публичного API с документацией вендора нет. Единственный систематический путь — обход каталогов дистрибьюторов.

Инструмент: сканер дистрибьюторов

Написал ops/scripts/dist-scan.py — переиспользуемый сканер:

python3 ops/scripts/dist-scan.py <хост> [начальные_пути...]

Что делает: обходит сайт (до 60 страниц), находит карточки вендора (hitrolink, hti-*), собирает PDF-ссылки, пишет список в /tmp/dist-scan-<хост>.txt.

Ловушка: часть CMS отдаёт ссылки в процентах (avicon.ru%2Fcatalog%2F…) — сканер их раскодирует, иначе находит 1 страницу вместо 19.

Проверка на Avicon: 19 карточек, 4 PDF (на страницах, куда дошёл обход).

Текущее состояние очереди

queue-hitrolink-dist.jsonl — 32 файла
  snk-s.ru  — 23
  avicon.ru — 9

Все помечены official: false, requires_confirmation: true, источник в поле source.host.

Что можно сделать дальше

  1. Дилерский доступ к hitrolink.com.ru/downloads — если у владельца есть аккаунт, это официальный источник и пометка не нужна.
  2. Письмо вендору — Hitrolink как производитель обязан дать даташиты по запросу; это тоже официальный канал.
  3. Новые сайты — сканер готов: достаточно назвать домен, обход и добавление в очередь делаются одной командой.