Skip to main content
Glama
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.