WEB/CHECK

WEBSITE DIAGNOSTICS / OPERATOR MANUAL

Проверка SEO, security, social metadata и технического состояния сайта — в одном понятном отчёте.

TARGET       public website
ENGINE       Node.js
OUTPUT       readable diagnostic report
CHECKS       SEO / SECURITY / SOCIAL / TECHNICAL
DATABASE     not required

00 / Что такое WebCheck

WebCheck — небольшой инструмент для быстрой диагностики публичных сайтов.

Вместо огромного отчёта из десятков непонятных метрик он показывает:

общий балл сайта от 0 до 100;
отдельные оценки по четырём направлениям;
что уже настроено правильно;
что отсутствует;
что стоит исправить в первую очередь;
основные технические данные страницы.

Пример:

WEB/CHECK REPORT

OVERALL      84 / 100
SEO          91 / 100
SECURITY     68 / 100
SOCIAL       82 / 100
TECHNICAL    95 / 100

WebCheck не требует базы данных, регистрации пользователей или сложной настройки.

01 / Что проверяется

SEO

Проверка	Что означает
`Title`	Есть ли заголовок страницы
`Meta description`	Есть ли описание для поисковой выдачи
`Viewport`	Подготовлен ли сайт для мобильных устройств
`Canonical`	Указана ли основная версия URL
`robots.txt`	Есть ли правила для поисковых роботов
`sitemap.xml`	Есть ли карта сайта
`H1`	Найден ли основной заголовок страницы
`HTML lang`	Указан ли язык документа
`Charset`	Указана ли кодировка

Security

WebCheck проверяет базовые security-сигналы:

HTTPS
Content-Security-Policy
Strict-Transport-Security
X-Content-Type-Options
Referrer-Policy

WebCheck не является полноценным сканером уязвимостей и не пытается взламывать или атаковать сайт. Это диагностический инструмент для проверки публично доступных HTTP-данных.

Social

Проверяется готовность страницы к нормальному отображению ссылок в мессенджерах и социальных сетях:

og:title
og:description
og:image

Technical

WebCheck также показывает:

HTTP status;
время первого ответа;
количество редиректов;
размер загруженного HTML;
наличие favicon;
финальный URL после редиректов.

02 / Быстрый запуск

Что понадобится

Нужен только:

Node.js 18 или новее

Проверить установленную версию можно командой:

node -v

Например:

v22.18.0

Если команда node не найдена — сначала установите Node.js.

Windows — пошагово

Шаг 1

Скачайте проект и распакуйте папку WebCheck.

Внутри должно быть примерно так:

WebCheck/
├── public/
├── server.js
├── package.json
├── README.md
├── LICENSE
└── .gitignore

Шаг 2

Откройте папку проекта.

Нажмите правой кнопкой мыши по пустому месту и выберите:

Открыть в терминале

Либо вручную перейдите в папку через CMD:

cd C:\путь\до\WebCheck

Шаг 3

Запустите сервер:

npm start

Должно появиться:

WebCheck v0.2.1 running on http://localhost:3000

Шаг 4

Не закрывая терминал, откройте браузер и перейдите:

http://localhost:3000

Готово.

Теперь можно ввести, например:

example.com

или:

https://example.com

и запустить проверку.

Как выключить WebCheck

Вернитесь в терминал и нажмите:

Ctrl + C

03 / Нужно ли запускать npm install?

Нет.

На данный момент WebCheck не использует внешние npm-зависимости.

Поэтому после скачивания проекта достаточно:

npm start

Это сделано специально, чтобы проект оставался простым и легко запускался на новом компьютере.

04 / Как работает проверка

Схема работы:

┌─────────────┐
│   Browser   │
└──────┬──────┘
       │
       │ POST /api/check
       ▼
┌─────────────┐
│   WebCheck  │
│   Node.js   │
└──────┬──────┘
       │
       │ HTTP / HTTPS
       ▼
┌─────────────┐
│ Target site │
└──────┬──────┘
       │
       │ HTML + headers
       ▼
┌─────────────┐
│  Analyzer   │
└──────┬──────┘
       │
       ▼
 SCORE + CHECKLIST + RECOMMENDATIONS

Почему нужен backend?

Обычная HTML-страница в браузере не может надёжно загружать и анализировать произвольные сторонние сайты из-за ограничений CORS.

Поэтому WebCheck использует небольшой Node.js сервер.

05 / Защита backend

Поскольку пользователь может вводить собственный URL, WebCheck не должен бездумно открывать любой сетевой адрес.

В проект уже встроена базовая защита от SSRF.

WebCheck:

принимает только HTTP и HTTPS;
запрещает localhost;
запрещает приватные IPv4 диапазоны;
блокирует приватные и link-local IPv6;
проверяет IPv4-mapped IPv6;
сначала проверяет DNS;
подключается именно к проверенному IP;
заново проверяет каждый redirect;
ограничивает количество редиректов;
использует timeout;
ограничивает размер HTML.

PUBLIC INTERNET   ✓
LOCALHOST         ✕
192.168.x.x       ✕
10.x.x.x          ✕
PRIVATE NETWORK   ✕

Для большого публичного сервиса всё равно рекомендуется добавить rate limiting, reverse proxy и ограничения на уровне хостинга.

06 / Структура проекта

WebCheck/
│
├── public/
│   ├── index.html
│   ├── styles.css
│   ├── app.js
│   └── favicon.svg
│
├── server.js
├── package.json
├── README.md
├── LICENSE
└── .gitignore

`public/index.html`

Основная разметка интерфейса.

`public/styles.css`

Полностью отвечает за визуальный стиль WebCheck:

diagnostic-lab интерфейс;
сетку;
radar;
отчёт;
мобильную адаптацию.

`public/app.js`

Frontend-логика:

отправка URL на backend;
loading screen;
отображение результатов;
category score;
рекомендации;
копирование отчёта.

`server.js`

Главный backend проекта.

Он:

принимает URL;
проверяет адрес;
получает страницу;
анализирует HTML и headers;
проверяет дополнительные URL;
рассчитывает score;
возвращает JSON frontend-части.

07 / Как загрузить проект на GitHub

Вариант A — через сайт GitHub

Создайте новый репозиторий.

Рекомендуемое название:

WebCheck

Описание:

A clean website diagnostics tool for SEO, security, social metadata and technical health.

При создании репозитория

Если вы загружаете готовую папку WebCheck, не создавайте дополнительно:

README;
.gitignore;
LICENSE.

Они уже есть в проекте.

После создания репозитория:

нажмите Add file;
выберите Upload files;
перетащите содержимое папки WebCheck;
дождитесь загрузки;
нажмите Commit changes.

Важно: загружайте содержимое папки WebCheck, а не ZIP-архив как единственный файл.

После загрузки структура на GitHub должна выглядеть примерно так:

public/
server.js
package.json
README.md
LICENSE
.gitignore

Вариант B — через Git

Откройте терминал внутри папки WebCheck:

git init
git add .
git commit -m "Initial WebCheck release"
git branch -M main
git remote add origin YOUR_REPOSITORY_URL
git push -u origin main

Где:

YOUR_REPOSITORY_URL

нужно заменить на URL созданного репозитория.

08 / GitHub Pages

Важно

Полная версия WebCheck не будет работать только на GitHub Pages.

Причина:

GitHub Pages = static hosting
WebCheck      = frontend + Node.js backend

На GitHub Pages можно разместить только внешний интерфейс, но функция:

POST /api/check

работать не будет.

Для полноценной онлайн-версии понадобится сервер или хостинг с поддержкой Node.js.

При этом сам исходный код проекта можно и нужно хранить на GitHub.

09 / Локальный режим разработки

Для обычного запуска:

npm start

Для автоматического перезапуска сервера после изменений:

npm run dev

npm run dev использует встроенный режим node --watch.

10 / Частые проблемы

Страница не открывается

Проверьте, что терминал всё ещё запущен и в нём есть:

WebCheck v0.2.1 running on http://localhost:3000

Затем откройте именно:

http://localhost:3000

Команда npm не найдена

Скорее всего Node.js не установлен или терминал был открыт до установки Node.js.

Проверьте:

node -v
npm -v

При необходимости перезапустите терминал.

Старый дизайн после обновления

В браузере нажмите:

Ctrl + F5

Это принудительно обновит CSS и JavaScript без старого кэша.

Сайт не проверяется

WebCheck работает только с публично доступными сайтами.

Локальные адреса и приватные сети блокируются специально:

localhost
127.0.0.1
192.168.x.x
10.x.x.x

Также целевой сервер может блокировать автоматические HTTP-запросы.

Порт 3000 уже занят

Можно запустить WebCheck на другом порту.

Windows CMD

set PORT=8080 && npm start

После этого откройте:

http://localhost:8080

PowerShell

$env:PORT=8080
npm start

11 / API

WebCheck использует один основной endpoint:

POST /api/check

Пример тела:

{
  "url": "https://example.com"
}

Пример упрощённого ответа:

{
  "host": "example.com",
  "score": 84,
  "categoryScores": {
    "seo": 91,
    "security": 68,
    "social": 82,
    "technical": 95
  }
}

12 / Ограничения текущей версии

WebCheck v0.2.1 — это быстрый диагностический инструмент.

Он пока не выполняет:

JavaScript rendering страницы;
Lighthouse audit;
Core Web Vitals из реальных пользователей;
глубокое сканирование всего сайта;
проверку всех внутренних ссылок;
поиск уязвимостей;
анализ JavaScript bundle;
полноценный accessibility audit.

Большая часть текущих проверок выполняется по HTML и HTTP headers главной страницы.

13 / Roadmap

[ ] OpenGraph visual preview
[ ] Twitter / X card diagnostics
[ ] Broken links scanner
[ ] Lighthouse integration
[ ] Core Web Vitals
[ ] Better HTML parser
[ ] JSON report export
[ ] PDF report export
[ ] Scan history
[ ] Shareable report
[ ] Rate limiting
[ ] Docker image

14 / Philosophy

WebCheck строится вокруг трёх принципов:

CLEAR

Результат должен быть понятен без чтения документации по SEO.

FAST

Проверка не должна превращаться в тяжёлый аудит на несколько минут.

USEFUL

Если WebCheck показывает проблему — пользователь должен понимать, что с ней делать.

15 / License

Проект распространяется по лицензии MIT.

Полный текст находится в:

LICENSE

WEB/CHECK
SCAN → UNDERSTAND → IMPROVE

Built as an independent CayPlayProjects experiment.

Name		Name	Last commit message	Last commit date
Latest commit History 2 Commits
public		public
.gitattributes		.gitattributes
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
package.json		package.json
server.js		server.js

Folders and files

Latest commit

History

Repository files navigation