От рутины аудита к предсказуемым результатам

SEO Scripts — CLI-набор для SEO-специалистов

Одиннадцать SEO-инструментов на одном Python-ядре, доступные двумя способами: из командной строки (CLI seohead) и как MCP-сервер для ИИ-агентов вроде Claude. Есть и локальный HTTP-API. Никакого десктоп-приложения и GUI — работает везде, где есть Python. Открытый код на GitHub.

GitHubIssues
Для кого

Кому SEO Scripts реально экономит время

Для тех, кому важны скорость, точность и воспроизводимость: меньше ручных ошибок на тысячах URL и больше времени на стратегию — без расплывчатых «полуручных» пайплайнов.

SEO-специалисты и SEO lead

Когда нужно быстро закрывать рутину и оставлять больше времени на стратегию.

  • Повторяемые задачи одной командой — можно ставить в скрипты и планировщик.
  • Ускорение первичных проверок и подготовка выгрузок в отчёты.
  • Удобно в связке с GA4 / GSC / Excel.

Кто работает с ИИ-агентами

Когда SEO-задачи хочется делегировать Claude или другому MCP-клиенту.

  • Инструменты доступны агенту как MCP: парсинг, редиректы, sitemap, медиа, кластеры.
  • Агент сам вызывает нужный инструмент и получает структурированный результат.
  • В комплекте — готовые SEO-скиллы для Claude Code.

Вебмастера и тех. специалисты

Когда важны управляемые файлы, понятные артефакты и контроль технических изменений.

  • Редиректы, sitemap-обходы, парсинг HTML/мета/JSON-LD без лишней ручной работы.
  • Сценарии загрузки и оптимизации медиа для релизов.
  • Экспорт, который можно сразу отдавать в разработку или в CI.

Одиннадцать инструментов — одна экосистема под SEO-процесс

У каждого инструмента узкая задача; вместе они дают сквозной поток: выход одного шага часто становится входом следующего без лишнего ручного копирования. Любой инструмент можно вызвать из CLI или как MCP-команду.

01

Redirect Builder

Пары URL → готовые правила Apache/Nginx с 301/302, синтаксисом под тысячи строк и проверкой типовых ошибок; отдельная команда следует по живым цепочкам редиректов.

  • Миграции и смена ЧПУ без потери ссылочного веса: автоматизация вместо многочасового ручного набора правил.
  • Чистый конфиг для сервера: меньше циклов, синтаксических ошибок и «тонущих» URL после релиза.
  • Выход: файл правил редиректов под выкладку и приёмку.

02

Image Optimizer

Сжатие и конвертация в современные форматы (WebP и др.) для лёгких страниц; пресеты, resize и бэкапы через Sharp/SVGO.

  • Ускорение загрузки и более предсказуемые метрики производительности без ручной обработки сотен файлов.
  • Пакетная подготовка ассетов перед деплоем: форматы, размеры и отчёт «до/после» по килобайтам.
  • Выход: оптимизированный набор файлов и сравнение по объёму.

03

SEO Parser

Массовый сбор мета, заголовков H1–H6, текста, ссылок и JSON-LD — базовый слой данных для любого аудита; браузероподобные запросы с поддержкой gzip/brotli.

  • Первый этап аудита за короткое время вместо ручного обхода: основа для отчётов, тикетов и связки с другими инструментами.
  • Снимок «что реально отдаёт страница» до и после релиза без ручного разбора верстки.
  • Выход: структурированный Markdown/JSON для команды и отчётности.

04

Image Downloader

Массовая загрузка по списку URL: правильное расширение по content-type, пропуск уже скачанного, понятная структура папок.

  • Мост между парсингом и оптимизацией: забрать медиа для аудита, конкурентного разбора или фиксации визуала.
  • Локальное зеркало ассетов в понятной структуре для staging и последующей обработки.
  • Выход: каталог файлов и manifest для следующего шага пайплайна.

05

Keyword Clusterer

Семантические группы запросов (K-Means, DBSCAN, Agglomerative) на десятки тысяч фраз — экспорт в CSV/XLSX. Использует Python 3 + scikit-learn на хосте.

  • От хаоса ключей к тематическим кластерам: IA, посадочные и контент-план с опорой на данные, а не интуицию.
  • Карта смысловых групп для шаблонов каталогов, фильтров и приоритизации разработки.
  • Выход: таблица кластеров для архитектуры и редакционного плана.

06

Prompt Library

Готовые SEO-скиллы и промпты для Claude Code: шаблоны с переменными под повторяемые сценарии, поставляются вместе с инструментом.

  • Ускорение черновиков и проверок с ИИ без разрозненных заметок — как «слой навыков» поверх инструментов.
  • Стандартные формулировки ТЗ, чеклистов и техпримечаний для релизов.
  • Выход: набор скиллов/промптов, готовых к подключению в Claude Code или wiki.

07

Sitemap Analyser

Рекурсивный разбор sitemap.xml (index/urlset, gzip): дерево URL, дубликаты и основа для проверки индексации.

  • Диагностика карты сайта: меньше устаревших и проблемных URL в подсказках краулеру.
  • Сверка генератора sitemap с реальной архитектурой и приоритетами разделов.
  • Выход: MD/JSON для отчёта и задач разработки.
Все команды

Полный список: 11 инструментов, CLI и MCP

Каждый инструмент доступен одной командой seohead и как MCP-инструмент для ИИ-агента.

SEO ParserМета, заголовки, JSON-LD, ссылки, текст.
CLIseohead parse --url …MCPseo_parse
Redirect BuilderПравила Apache/Nginx из пар URL.
CLIseohead redirects-generateMCPseo_redirects_generate
Redirect CheckerОбход живой цепочки редиректов.
CLIseohead redirects-check --url …MCPseo_redirects_check
Sitemap AnalyserРазбор sitemap (index/urlset, gzip).
CLIseohead sitemap-crawl --url …MCPseo_sitemap_crawl
Image DownloaderМассовая загрузка по списку URL.
CLIseohead images-downloadMCPseo_images_download
Image OptimizerСжатие/конвертация JPG/PNG/WebP/SVG.
CLIseohead images-optimizeMCPseo_images_optimize
Keyword ClustererКластеры запросов (K-Means/DBSCAN).
CLIseohead keywords-clusterMCPseo_keywords_cluster
Robots Analyserrobots.txt: правила, sitemap, доступность.
CLIseohead robots-check --url …MCPseo_robots_check
Header InspectorSEO-заголовки ответа, HTTP-версия, TTFB.
CLIseohead headers-check --url …MCPseo_headers_check
Link CheckerБитые ссылки и ссылки на редиректы.
CLIseohead links-check --url …MCPseo_links_check
hreflang ValidatorИзвлечение и валидация hreflang.
CLIseohead hreflang-check --url …MCPseo_hreflang_check

Важно

SEO Scripts развивается с активным применением AI-инструментов: генерация черновиков логики, ускорение рефакторинга, подготовка документации. Финальные решения проходят ручную проверку, но проект остаётся живым и постоянно улучшается.

Инструмент публикуется «как есть». Можно форкнуть репозиторий, открыть PR или написать мне в LinkedIn — с радостью посмотрю идеи и обсудим, что добавить в следующих апдейтах.

Этапы развития

Этапы разработки и что уже внедрено

Итерации от отдельных скриптов к единому ядру и headless-запуску: сбор данных → обработка → экспорт артефактов для команды и ИИ-агентов.

Stage 01Платформо-независимое ядро

Логика инструментов вынесена в общий TypeScript-модуль, не зависящий от способа запуска, с линтом и тестами.

done
Stage 02Инструменты редиректов и медиа

Подключены Redirect Builder и блок работы с изображениями для массовых операций.

done
Stage 03Парсинг и sitemap-проход

Добавлены SEO Parser и Sitemap Analyser с экспортируемыми результатами для аудитов.

done
Stage 04Кластеризация и библиотека скиллов

Семантический модуль и набор SEO-скиллов/промптов для Claude Code вошли в общий набор.

done
Stage 05Headless-пивот: CLI + MCP + HTTP

Убрали десктоп-GUI, оставили ядро и обернули его в CLI seohead, MCP-сервер для ИИ и локальный HTTP-API.

done
Stage 06Стабилизация и edge-cases

Текущий фокус — надёжность на нестандартных URL и форматах, точность экспортов и удобство вызова из скриптов и агентов.

in progress
Roadmap

Что планируется дальше

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

Эргономика CLI и флагов

Понятнее вывод, единообразные флаги, дружелюбные ошибки для запуска из скриптов и планировщиков.

в работе

Техстабильность и edge-cases

Больше покрытий на нестандартные URL, форматы файлов, таймауты и ошибки экспорта.

в работе

Пакет гайдов по инструментам

Серия блог-разборов «как использовать инструмент X в реальном SEO-процессе».

запланировано

Внешний вклад комьюнити

Issue-шаблоны и предложения новых инструментов через GitHub Issues/PR.

открыто
FAQ

Ответы по категориям: запуск, инструменты, данные, open source

Установка и рабочий режим
Да. CLI и MCP-сервер работают локально без обязательной облачной зависимости — сеть нужна только инструментам, которые ходят в веб (парсинг, обход sitemap).
Нет. Python нужен только для инструмента Keyword Clusterer. Всё остальное работает на одном Node.js.
Клонируйте репозиторий, выполните npm install и npm run build, затем node out/cli.js --help. Для первого прогона попробуйте parse и redirects-generate. Чтобы вызывать из Claude — npm run mcp.
Развёртывание

Быстрый старт из репозитория

Запустить, протестировать или доработать инструмент локально. Команды доступны через бинарь seohead после установки пакета:

pip install "seohead-scripts[all]"
seohead --help

# Пример: разобрать страницу
seohead parse --url https://example.com

Keyword Clusterer — Python

Кластеризация выполняется во внешнем Python-воркере: нужен интерпретатор Python, изолированное окружение и повторяемый набор версий библиотек. Команды ниже — для macOS/Linux; на Windows активация окружения — .venv\Scripts\activate.

python3 -m venv .venv
source .venv/bin/activate
pip install scikit-learn numpy nltk
pip freeze > requirements-clusterer.txt
python -m nltk.downloader stopwords

Файл requirements-clusterer.txt или явные пины версий приложите к задаче: без них другой компьютер даст другой результат. Убедитесь, что SEO Scripts видит нужный Python (PATH в сессии пользователя).

MCP-сервер и HTTP-API

Тот же инструмент можно поднять как MCP-сервер для ИИ-агентов (Claude и любой MCP-клиент) или как локальный HTTP-API:

# MCP-сервер по stdio — для Claude и других MCP-клиентов
seohead mcp

# Локальный HTTP-API поверх ядра
seohead serve

Для подключения к Claude Code пропишите MCP-сервер в конфиге клиента (команда запуска — seohead mcp). Инструменты станут доступны агенту как MCP-команды: парсинг, редиректы, sitemap, robots.txt, заголовки, ссылки, hreflang, медиа, кластеризация.

Технические требования

  • Python 3.10+ — для CLI, MCP-сервера и HTTP-API
  • Extra «cluster» (scikit-learn) — только для инструмента Keyword Clusterer
  • Кросс-платформенно: работает на macOS, Linux и Windows