site-audit-ru
README.md
<p align="center"><img src="docs/img/cover.png" alt="Аудитор сайтов — аудит сайта и конкурентов" width="100%"></p>
<p align="center">
<a href="https://github.com/kozhevnikovai/auditor-saitov/actions/workflows/ci.yml"><img src="https://github.com/kozhevnikovai/auditor-saitov/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
<a href="https://github.com/kozhevnikovai/auditor-saitov/releases/latest"><img src="https://img.shields.io/github/v/release/kozhevnikovai/auditor-saitov?label=%D0%B2%D0%B5%D1%80%D1%81%D0%B8%D1%8F&color=161616" alt="Версия"></a>
<img src="https://img.shields.io/badge/%D0%BB%D0%B8%D1%86%D0%B5%D0%BD%D0%B7%D0%B8%D1%8F-MIT-16181D" alt="MIT">
<img src="https://img.shields.io/badge/Claude%20Desktop%20%C2%B7%20Claude%20Code%20%C2%B7%20CLI-5E6470" alt="Claude Desktop, Claude Code, CLI">
</p>
<p align="center"><b>Русский</b> · <a href="README.en.md">English</a></p>
# Аудитор сайтов — аудит сайта и конкурентов
Команда и npm-пакет называются `site-audit-ru`.
Дайте адрес своего сайта и 2–4 конкурентов. Через пару минут придёт отчёт: что мешает сайту приносить заявки, где конкуренты сильнее, что нарушает законы РФ и что исправить в первую очередь.
<p align="center"><img src="docs/img/demo.gif" alt="Отчёт: главное, сравнение с конкурентами, подробные находки, фильтр «Только проблемы»" width="100%"></p>
<sub>Настоящий отчёт по трём реальным сайтам доставки цветов. Домены, названия и телефоны мы замылили. Ролик на 45 секунд — [docs/video/promo.mp4](docs/video/promo.mp4).</sub>
## Установка за 3 шага
Нужен любой из браузеров: Google Chrome, Microsoft Edge (есть в каждой Windows), Яндекс Браузер или Chromium.
1. Скачайте **`site-audit-ru.mcpb`** со страницы [последнего релиза](https://github.com/kozhevnikovai/auditor-saitov/releases/latest).
2. Откройте файл двойным щелчком: Claude Desktop предложит установить расширение.
3. Напишите в чате: *«Сравни мой сайт example.ru с конкурентами a.ru и b.ru и составь план на две недели»*.
Claude проверит сайты, разберёт результаты как пять экспертов (SEO, UX, дизайн, техника, юрист) и даст заключение. Отчёты сохранятся в папку `site-audit` в домашней папке.
## Возможности
- **Сравнение с конкурентами, а не просто чек-лист.** Радар по пяти блокам, место среди сайтов и список «где конкуренты сильнее»: у них такая-то проверка в норме, а у вас — нет.
- **Законы РФ.** Политика ПДн, согласие у каждой формы, отдельный документ согласия (с 01.09.2025), галочки по умолчанию, cookie до согласия, зарубежные сервисы (Google Fonts, GA, reCAPTCHA, YouTube), ИНН и ОГРН, erid. Обычные SEO-сервисы этого не проверяют.
- **Сайт глазами Яндекса и посетителя.** Метрика, sitemap, микроразметка, LCP/CLS/TTFB, кнопка действия на первом экране, длина форм, кликабельный телефон, мессенджеры.
- **Стиль конкурента в цифрах.** Палитра в HEX, шрифты, шкала размеров, контраст текста, скриншоты для компьютера и телефона.
- **Цифры воспроизводимы.** Данные собирает детерминированный код, а не ИИ. ИИ только объясняет их и составляет план, если вы этого хотите.
- **Новое в 1.3.** Скорость у реальных посетителей из CrUX (по вашему бесплатному ключу Google), отчёт в PDF, проверка по расписанию на вашем компьютере, выгрузка в Google Таблицу без OAuth.
- **Локально и бесплатно.** Проверка идёт в вашем браузере (Chrome, Edge или Яндекс Браузер). Отчёт сохраняется у вас и сам не грузит внешние ресурсы. Наружу данные уходят, только если вы это включили: сводка — Claude (в режиме расширения), ИИ-заключение — по вашему ключу, webhook, Google Таблица, ключ CrUX.
### Отчёт
HTML-отчёт открывается в любом браузере. Его можно отправить клиенту одним файлом, распечатать или сохранить в PDF.
<p align="center"><img src="docs/img/report-compare.jpg" alt="Главное, карточки сайтов и сравнение" width="100%"></p>
- **Главное.** Итоговая оценка и вердикт, число ошибок и замечаний, место среди конкурентов, три главные проблемы.
- **Сравнение.** Радар и таблица по блокам, где конкуренты сильнее.
- **План действий.** 10 задач по убыванию важности, у каждой подсказка «как исправить».
- **Подробно.** Все находки по блокам с цветовыми статусами, адресами страниц и палитрой сайта.
- **Кнопки:** «Только проблемы», «Скачать HTML», «Печать / PDF».
<p align="center"><img src="docs/img/report-open.jpg" alt="Подробные находки с советами" width="49%"> <img src="docs/img/report-issues.jpg" alt="Фильтр «Только проблемы»" width="49%"></p>
Рядом с HTML сохраняются:
| Файл | Для чего |
|---|---|
| `report.html` | Отчёт для людей: открыть, отправить, распечатать |
| `report.md` | Markdown для Notion, Obsidian, GitHub, Telegram и чата с ИИ |
| `findings.csv` | Все находки для Excel и Google Таблиц (UTF-8, `;`, открывается двойным щелчком) |
| `summary.csv` | Оценки строкой на сайт: удобно копить историю |
| `report.xlsx` | Таблица с листами «Сводка», «Находки», «Технологии» — для Excel, Google Таблиц и Яндекс Таблиц (`--format xlsx`) |
| `report.pdf` | PDF для клиента или руководителя (`--format pdf`, печатает ваш браузер, без интернета) |
| `audit.json` | Все данные: для повторных отчётов, сравнения во времени и интеграций |
## Другие способы установки
### Claude Code — плагин с командой `/site-audit`
```text
/plugin marketplace add kozhevnikovai/auditor-saitov
/plugin install site-audit-ru@kozhevnikovai
/site-audit example.ru a.ru b.ru
```
Плагин запускает проверку и пять подагентов-экспертов параллельно, а затем собирает общее заключение.
### Командная строка — для регулярных проверок и автоматизации
Нужен Node.js 22.12 или новее.
```bash
npm install -g https://github.com/kozhevnikovai/auditor-saitov/releases/latest/download/site-audit-ru.tgz
site-audit-ru example.ru a.ru b.ru --open
```
Без установки, одной командой:
```bash
npx -y https://github.com/kozhevnikovai/auditor-saitov/releases/latest/download/site-audit-ru.tgz example.ru a.ru
```
### Другие ИИ-клиенты: Cursor, Codex, Windsurf
Это MCP-сервер, он работает в любом клиенте с поддержкой MCP:
```json
{
"mcpServers": {
"site-audit-ru": {
"command": "npx",
"args": ["-y", "https://github.com/kozhevnikovai/auditor-saitov/releases/latest/download/site-audit-ru.tgz", "mcp"]
}
}
}
```
Инструменты: `audit_sites` (проверка 1–5 сайтов), `get_details` (подробности по блоку), промпт `site_audit_expert`.
## Командная строка
```bash
site-audit-ru <ваш сайт> [конкуренты...] [параметры]
```
| Параметр | Что делает |
|---|---|
| `-p, --max-pages <n>` | Сколько страниц обойти на каждом сайте (по умолчанию 30) |
| `-f, --format <список>` | Форматы: `html,md,csv,xlsx,json,pdf` (по умолчанию `html,md,csv`, JSON сохраняется всегда) |
| `-o, --out <папка>` | Куда сохранить (по умолчанию `site-audit/<дата>-<сайт>`) |
| `--open` | Открыть HTML-отчёт после проверки |
| `--compare-last` | Сравнить с прошлым прогоном этого сайта: что исправлено, что появилось |
| `--baseline <audit.json>` | Сравнить с конкретным прошлым прогоном |
| `--ai` | Добавить заключение ИИ-экспертов в отчёт (нужен ключ API, см. ниже) |
| `--webhook <url>` | Отправить сводку POST-запросом в n8n, Make, Zapier, Albato или Битрикс24 |
| `--sheet <адрес>` | Дописать сводку и находки в вашу Google Таблицу — без входа в Google в программе (см. «Выгрузка в Google Таблицу») |
| `--crux-key <ключ>` | Скорость у реальных посетителей из Chrome UX Report Google (LCP, INP, CLS за 28 дней); бесплатный ключ, можно задать переменной `SITE_AUDIT_CRUX_KEY` |
| `--no-screenshots` | Без скриншотов |
| `--ignore-robots` | Не учитывать robots.txt (только для своего сайта) |
| `--allow-private` | Разрешить адреса локальной сети — для аудита внутреннего сайта или localhost. По умолчанию такие адреса заблокированы, чтобы чужой сайт не мог направить проверку внутрь вашей сети |
| `--chrome-path <путь>` | Путь к браузеру, если он не нашёлся сам |
Другие команды:
- `site-audit-ru report <audit.json> -f html,pdf` — пересобрать отчёты из сохранённых данных;
- `site-audit-ru schedule add|list|remove` — проверка по расписанию (ниже);
- `site-audit-ru crux <сайт>` — скорость у реальных посетителей (нужен ключ CrUX API);
- `site-audit-ru prompt` — вывести промпт экспертов (можно вставить в любой чат вместе с `report.md`);
- `site-audit-ru mcp` — запустить MCP-сервер.
### Мониторинг себя и конкурентов
Одна команда ставит проверку в Планировщик заданий Windows или в cron (macOS, Linux) — без сервера и аккаунтов:
```bash
npx site-audit-ru schedule add example.ru a.ru b.ru --every week --at 09:00 --webhook https://n8n.example.ru/webhook/site-audit
npx site-audit-ru schedule list
npx site-audit-ru schedule remove example.ru
```
Задание запускает ту же версию Аудитора, которой оно создано; после обновления поставьте задание заново. Каждый запуск сравнивается с прошлым (`--compare-last`): в отчёте — раздел «Изменения с прошлой проверки». Отчёты и журнал `schedule.log` — в папке `site-audit` в домашней папке. Проверка идёт, когда компьютер включён. В расписание принимаются адреса без параметров и спецсимволов — так в команду задания не попадёт ничего лишнего.
Сводка в webhook содержит оценки, пять главных проблем по каждому сайту, скорость у реальных посетителей (если задан ключ CrUX) и изменения. Из n8n или Make её легко отправить в Telegram или Битрикс24.
### Выгрузка в Google Таблицу
Без входа в Google в программе и без OAuth: таблица сама принимает строки через свой скрипт.
1. Откройте свою Google Таблицу → «Расширения» → «Apps Script», вставьте код из [docs/google-sheets.gs](docs/google-sheets.gs), сохраните.
2. «Начать развёртывание» → «Новое развёртывание» → «Веб-приложение»; выполнять от имени — «я», доступ — «все». Разрешите доступ к таблице.
3. Скопируйте адрес вида `https://script.google.com/macros/s/…/exec` и запускайте: `site-audit-ru example.ru --sheet <адрес>` (или `schedule add … --sheet <адрес>`).
После каждой проверки на листах «Сводка» и «Находки» появятся новые строки. Скрипт только дописывает строки в эту таблицу; адрес держите в секрете. Яндекс Таблицы такого приёма данных не поддерживают — для них есть `report.xlsx` (импорт файла).
### Заключение ИИ в CLI
Укажите ключ в переменной окружения и добавьте `--ai`:
```bash
# Anthropic (Claude)
export ANTHROPIC_API_KEY=...
# или любой OpenAI-совместимый API: OpenRouter, локальная Ollama и другие
export OPENAI_API_KEY=... OPENAI_BASE_URL=https://openrouter.ai/api/v1 SITE_AUDIT_AI_MODEL=<модель>
site-audit-ru example.ru a.ru --ai --open
```
Промпты экспертов лежат в [`prompts/`](prompts). Они общие для CLI, MCP-сервера и плагина.
## Что проверяется
<details><summary><b>SEO и скорость</b></summary>
HTTPS, robots.txt и sitemap (включая индекс sitemap), title и description (наличие, длина, дубли), ровно один H1, canonical, язык страницы, noindex, alt у изображений, микроразметка schema.org, Open Graph, битые страницы, «тонкие» страницы, TTFB, LCP, CLS, вес главной. Скорость подробно: блокировка страницы скриптами (TBT, самая долгая задача), синхронные скрипты в `<head>`, вес JS/CSS/картинок/шрифтов и сторонних скриптов, WebP/AVIF, `loading="lazy"`, картинки больше нужного, сжатие gzip/brotli, кэширование статики, битые ресурсы.
</details>
<details><summary><b>Структура и конверсия</b></summary>
Мобильная адаптация и горизонтальная прокрутка на телефоне, меню верхнего уровня, кнопка действия на первом экране, сколько кликов до формы, длина форм, кликабельный телефон и телефон в шапке, подписи у полей форм, `type="tel"` и autocomplete у телефона и почты, шрифт полей ≥ 16 px на телефоне, размер кнопок и ссылок для пальца, мессенджеры (Telegram, WhatsApp, VK, MAX), разделы доверия (цены, отзывы, кейсы, вопросы, контакты), глубина страниц, страницы-сироты из sitemap.
</details>
<details><summary><b>Визуальный стиль</b></summary>
Палитра (текст, фон, рамки) и акцентные цвета, шрифты, шкала размеров текста, доля мелкого текста, контраст текста к фону по WCAG (фон ищется по родительским элементам), скругления, ширина контента, скриншоты 1440 и 390 px.
</details>
<details><summary><b>Технологии</b></summary>
80+ сигнатур: Tilda, 1С-Битрикс, WordPress, InSales, Nethouse, Flexbe, Ecwid, Next.js и Nuxt, Яндекс Метрика, Google Analytics и GTM, Top.Mail.ru, пиксели VK и Meta, Roistat, Calltouch, CoMagic, Callibri, Alloka, Jivo, Carrot quest, Talk-Me, LiveTex, Битрикс24, amoCRM, RetailCRM, Marquiz, Яндекс Формы, оплата (ЮKassa, CloudPayments, Т-Касса, Robokassa, СБП, Долями), рассылки (Unisender, Mindbox), онлайн-запись (YCLIENTS, Dikidi), карты, видео, капчи, CDN; устаревший jQuery.
</details>
<details><summary><b>Законы РФ</b></summary>
Политика обработки ПДн (152-ФЗ, ст. 18.1), согласие у каждой формы с персональными данными (ищется и рядом с формой), отдельный документ согласия (с 01.09.2025), галочка согласия по умолчанию, уведомление о cookie и cookie аналитики до согласия, зарубежные сервисы (трансграничная передача), ИНН и ОГРН/ОГРНИП продавца, HTTPS для форм, маркировка рекламы (erid).
> Это автоматические сигналы, а не юридическое заключение. Перед изменениями сверьтесь с юристом.
</details>
## Вопросы
**Сколько длится проверка?** Около 2–5 минут на три сайта по 12 страниц. Зависит от скорости сайтов и вашего интернета.
**Нужен ли ключ ИИ?** Нет. Все проверки делает код. Ключ нужен только для заключения ИИ в командной строке (`--ai`) и для данных CrUX. В Claude Desktop и Claude Code заключение пишет сам Claude.
**Почему у конкурента нет оценки?** Сайт закрыт защитой от ботов (Qrator, DDoS-Guard и подобные). Мы не обходим защиту и честно помечаем: «проверка неполная».
**Можно ли проверять чужие сайты?** Да, проверка видит только то, что видит любой посетитель. Robots.txt соблюдается, обходится не больше 30 страниц.
**Это юридическое заключение?** Нет. Раздел «Законы РФ» показывает автоматические сигналы. Перед изменениями сверьтесь с юристом.
## Безопасность и этика
- Сборщик открывает страницы в headless-режиме вашего браузера через Playwright, ждёт, пока страница перестанет перезагружаться (JS-проверки), прокручивает главную, чтобы догрузились ленивые скрипты.
- Соблюдает `robots.txt`, обходит не больше 30 страниц, пропускает служебные разделы (вход, корзина, кабинет, поиск, фильтры), представляется в User-Agent как `site-audit-ru` со ссылкой на проект.
- Собирает только публичные данные, которые видит любой посетитель. Скриншоты и данные остаются на вашем компьютере.
**Ограничения.** Сайты под защитой от ботов (Qrator, DDoS-Guard, Servicepipe) помечаются как «проверка неполная» и не получают оценку. Скорость зависит от сети компьютера, с которого идёт проверка. Аналитика, которая загружается только после согласия на cookie, может не определиться.
## Разработка
```bash
npm install
npm test # 93 теста: тестовые сайты, отчёты, PDF, расписание, Google Таблица, webhook, ИИ на фейковом API, настоящий MCP-клиент
npm run build
node dist/cli.js test-site.ru --open
```
Структура: `src/crawl.ts` — обход, `src/extract.ts` — сбор данных на странице, `src/analyzers/` — пять блоков проверок, `src/report/` — HTML, Markdown, CSV, XLSX, webhook, сравнение, `src/mcp.ts` — MCP-сервер, `plugin/` — плагин Claude Code, `mcpb/` — расширение Claude Desktop, `prompts/` — промпты экспертов.
Новые проверки и сигнатуры технологий приветствуются: смотрите [CONTRIBUTING.md](CONTRIBUTING.md).
## Планы
- [ ] Браузерное расширение: аудит открытой страницы в один клик
- [x] Подробная скорость без Google: TBT, вес по типам, форматы картинок, сжатие и кэш (1.2)
- [x] Выгрузка в XLSX для Google и Яндекс Таблиц (1.2)
- [x] Core Web Vitals реальных посетителей из CrUX — по вашему ключу (1.3)
- [x] Отчёт в PDF (1.3)
- [x] Проверка по расписанию на вашем компьютере и выгрузка в Google Таблицу без OAuth (1.3)
- [ ] Яндекс Таблицы — когда появится приём данных без OAuth
- [ ] Проверка Яндекс Бизнеса и карточек в картах (по вашему аккаунту)
- [x] Больше сигнатур российских сервисов: оплата, рассылки, онлайн-запись (1.2)
## Скоро
Всё, что есть сейчас, остаётся бесплатным и открытым (MIT). Платная версия — «Аудитор сайтов для агентств и отделов маркетинга» — в разработке, этих возможностей пока нет:
- **Проверка на сервере** — сайт и конкуренты по расписанию, даже когда ваш компьютер выключен, уведомление о новых проблемах — *скоро*
- **Отчёт под вашим брендом** — логотип и цвета агентства, PDF — *скоро*
- **Весь сайт целиком** — больше 30 страниц, история изменений — *скоро*
- **Командный доступ и API** — *скоро*
Цена — от 990 ₽ в месяц. Тем, кто оставит заявку на ранний доступ, — скидка 50 % на первый год.
Нужно что-то из этого? [Оставьте заявку на ранний доступ](https://github.com/kozhevnikovai/auditor-saitov/issues/new?template=early-access.yml) — заявки влияют на порядок разработки.
## Другие инструменты kozhevnikovai
- [Протоколист](https://github.com/kozhevnikovai/protokolist) — запись встречи → протокол, локально
- [Тендерный помощник](https://github.com/kozhevnikovai/tender-pomoshnik) — разбор госзакупок 44-ФЗ и 223-ФЗ с цитатами
- [Бизнес-навыки](https://github.com/kozhevnikovai/biznes-navyki) — 12 навыков для Claude: КП, отзывы, претензии, вакансии, регламенты
Об уязвимостях — приватно, см. [SECURITY.md](SECURITY.md).
## Автор
Егор Кожевников — [github.com/kozhevnikovai](https://github.com/kozhevnikovai). Продукт № 002 линейки kozhevnikovai; № 001 — [ИИ-навыки для бизнеса в России](https://github.com/kozhevnikovai/biznes-navyki).
Лицензия MIT.
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo recent community issues