Перевірте, що сайт насправді віддає, перш ніж назвати його порожнім

👀 Помилка

9 вересня 2026 ми дійшли висновку, що сайт із корпоративними даними «не має корисних даних». Висновок зробили, прочитавши одну сторінку — головну. Той самий сайт віддавав рейтинг тисячі найкращих записів із джерелами й каталог із 56 138 профілів. Головна сторінка не згадувала жодного з цих чисел так, щоб це впіймав швидкий погляд. Вердикт був хибним, і його сказали впевнено.

Помилка загальна. Головна сторінка — це історія, яку сайт розказує про себе. Чи віддає сайт те, що обіцяє, — питання до сторінок за нею.

🔬 Що робить перевірка поверхні

Ми замінили звичку командою. Для домену вона читає sitemap і файл robots, відвідує адреси з них і записує для кожної сторінки статус і значення, визначені в контракті. Контракт перелічує іменовані значення та вираз, який зчитує їх із видимого тексту, з якого прибрано скрипти й розмітку. Значенням може бути надруковане число або кількість збігів, наприклад скільки посилань певного типу є на сторінці.

Результат записується у файл для цього домену, а команда завершується з кодом помилки, коли якесь значення порушує своє правило. Серйозність має три рівні: info просто повідомляється, warn і error провалюють прогін.

Сьогодні в репозиторії є контракти для 7 поверхонь, а тестів для перевіряльника — 21.

⚖️ Друге правило: 200 — це не дані

Сторінка, що відповідає статусом 200, усе одно може бути порожньою. Ми якось бачили, як кожен розділ дашборда відповідав 200 із нулями, бо базовий знімок даних був порожній. Приймання йде за вмістом, наприклад кількість більша за нуль, а не за кодом статусу. Те саме значення на двох сторінках мусить мати одне визначення. Якщо дві сторінки показують одну величину під різними назвами і між ними немає переходу, це дефект, про який треба повідомити.

🛠️ Практика: напишіть свій перший контракт

1. Виберіть один сайт і випишіть п'ять фактів, які він заявляє: кількість продуктів, кількість рейтингів, дату останнього оновлення.
2. Для кожного факту знайдіть сторінку, яка має його показувати, і напишіть регулярний вираз, що зчитує число з видимого тексту.
3. Додайте правило: значення мусить існувати й бути вищим за поріг, який ви оберете.
4. Напишіть невеликий скрипт, який забирає sitemap і файл robots, відвідує кожну сторінку один раз із ввічливою затримкою й застосовує контракт.
5. Зберігайте результат разом із часом прогону. Ніколи не перезаписуйте його мовчки. Тримайте останній прогін для порівняння.
6. Вирішіть, які збої є попередженнями, а які помилками, і зробіть так, щоб скрипт повертав правильний код виходу.

✅ Перевірте себе

• Поруште правило навмисно, наприклад вказавши на неіснуючу сторінку. Скрипт завершується з помилкою, а збережений файл показує, яке значення не пройшло.
• Файл результату перелічує кожну відвідану адресу та статус кожної з них.
• Дві сторінки, що показують ту саму величину, дають те саме число.
• Колега може відтворити ваш вердикт, запустивши команду, а не довіряючи вашому опису.

🚧 Коли це не працює

• Сторінки, які рендерить скрипт. Якщо числа з'являються лише після запуску JavaScript, звичайне завантаження їх не побачить. Використайте крок рендерингу або точку доступу до даних.
• Стіни логіну. Перевірка не може оцінити те, до чого не дісталася. Скажіть про це у звіті.
• Зміна верстки. Регулярний вираз ламається, коли змінюється формулювання. Переглядайте контракти, коли сторінки змінюються.
• Важкі сайти. Обхід десятків тисяч сторінок потребує бюджету й затримки. Беріть вибірку і вказуйте, що це вибірка.
• Сенс. Перевірка доводить, що значення існує. Вона не доводить, що воно правдиве. Для правди потрібне джерело.

📊 Докази

➡️ Далі

Прочитайте, як ми позначаємо джерела й дати, у Джерела та перевірка, і як тримати твердження прив'язаними до доказів, у Оцінювання AI.

Джерела

• Джерела, дати й що означає «перевірено»: як ми позначаємо докази.
• Оцінювання AI: чому «воно каже, що готово» не є прийманням: приймання за перевірками.
• Чому AI-агенти вигадують, і як перевірити відповідь: перевірка відповідей.
• Зв'язки, зворотні посилання й граф знань: як сторінки посилаються одна на одну.