Ultimate SEO + GEO
mykpono/ultimate-seo-geoLLM-агностичный агент для SEO и оптимизации под AI-поиск. Полный аудит сайта с оценкой, генерация schema, анализ E-E-A-T, оптимизация под Google AI Overviews, ChatGPT и Perplexity. Три режима: Аудит → План → Исполнение. Работает в Claude Code, Cursor, Codex и других инструментах.
Установка
pip install -r requirements.txtREADME
Ultimate SEO + GEO — LLM-агностичный SEO-агент
Окончательный агент для SEO и оптимизации под генеративные поисковые системы (GEO) для AI-инструментов разработки. LLM-агностичный — работает на любой платформе, которая читает AGENTS.md. Выполняет полный аудит сайта с оценкой находок, генерирует готовые к развёртыванию исправления и оптимизирует контент как для Google Search, так и для AI-поисковиков (Google AI Overviews, AI Mode, ChatGPT Search, Perplexity). Экспортирует отчёты в HTML и Excel.
Работает с любым AGENTS.md-совместимым инструментом: Claude Code, Cursor, OpenAI Codex, Gemini CLI, GitHub Copilot, Windsurf, Cline, Aider, Devin и другими.
Автор: Myk Pono · Lab · LinkedIn
Что умеет
Передайте URL — получите оценённый аудит, приоритизированный план действий и исполняемые исправления, а не расплывчатые советы.
Три режима, один скилл:
| Режим | Что делает | Результат |
|---|---|---|
| Аудит | Загружает сайт, выполняет все проверки, оценивает находки | SEO Health Score (0–100) + приоритизированные находки |
| План | Преобразует находки в поэтапную дорожную карту | Таблица внедрения с усилием/влиянием/ответственным |
| Исполнение | Генерирует реальные исправления и верифицирует их | JSON-LD, переписанные мета-теги, карты редиректов, robots.txt |
Большинство запросов запускают все три режима последовательно. Переходите к режиму 2, если у вас уже есть результаты аудита; к режиму 3 — если точно знаете, что исправлять.
Для кого и что делает встроенный отчёт
Создан для разработчиков, основателей и маркетологов, использующих AI-агенты, которым нужны скриптовые проверки и управляемые исправления. python scripts/generate_report.py <url> агрегирует множество диагностик в один HTML/Excel-экспорт; по умолчанию ряд проверок использует исходный URL и скромные лимиты обхода (не полный обход в стиле Screaming Frog). Для более широкого охвата ссылок и канонических URL используйте --crawl-deep (ограниченная глубина/страницы; медленнее и создаёт бо́льшую нагрузку на целевой хост). Для JS-рендеримых сайтов или очень больших аудитов опциональные расширения (Firecrawl, DataForSEO) описаны в references/optional-extensions-mcp.md. Установка: pip install -r requirements.txt (опциональные API-ключи для PageSpeed и расширений).
Покрытие
SEO (21 модуль)
- Технический SEO — Core Web Vitals (LCP/INP/CLS), обходимость, индексируемость, рендеринг JavaScript, заголовки безопасности, mobile-first
- On-Page SEO — Title-теги, мета-описания, H1, URL, канонические теги
- Контент и E-E-A-T — Оценка качества контента, учётные данные авторов, сигналы опыта, читаемость, обнаружение тонкого контента, обрезка/обновление контента
- Schema Markup — Все активные типы Schema.org с учётом устаревших (HowTo, SpecialAnnouncement удалены), генерация и валидация JSON-LD
- Ключевые слова и контент-стратегия — Исследование ключевых слов, тематические кластеры, контентные пробелы, маппинг воронки (TOFU/MOFU/BOFU)
- Линкбилдинг — Аудит внутренних ссылок, обнаружение страниц-сирот, анализ анкорного текста, иерархия качества внешних ссылок
- Локальный SEO — Google Business Profile, согласованность NAP, стратегия отзывов, LocalBusiness schema, построение цитат
- Международный SEO — Аудит hreflang, валидация языковых кодов, двунаправленные обратные теги
- Программатический SEO — Контроль качества страниц в масштабе, защита от тонкого контента, оптимизация шаблонов
- Миграции сайтов — Чеклисты до/во время/после миграции, валидация карт редиректов, инструмент Change of Address
- Аналитика и отчётность — Настройка GA4/GSC, диагностика падения трафика, бенчмарки CTR, ежемесячное обслуживание
GEO (оптимизация под AI-поиск)
- Охват платформ — Google AI Overviews, Google AI Mode, ChatGPT Search, Perplexity, Bing Copilot
- Оценка цитируемости — Оптимизация на уровне пассажей (блоки ответов 134–167 слов), размещение ответа в первых 60 словах
- Стратегия упоминания бренда — Корреляционные данные YouTube/Reddit/Wikipedia/LinkedIn, настройка сущности Wikidata
- Управление AI-краулерами — Конфигурация
robots.txtдля GPTBot, OAI-SearchBot, PerplexityBot, ClaudeBot - llms.txt — Генерация шаблона для нового AI-стандарта контента
- RSL 1.0 — Машиночитаемое AI-лицензирование (стандарт декабря 2025)
Совместимость платформ
| Платформа | Как загружает инструкции | Выполнение скриптов | Установка |
|---|---|---|---|
| OpenAI Codex | AGENTS.md загружается автоматически (лимит 32 КиБ) | Полное (доступ к shell) | Клонировать репозиторий, начать работу |
| Google Gemini CLI | GEMINI.md → импортирует AGENTS.md | Полное (доступ к shell) | Клонировать репозиторий, начать работу |
| Claude Code | Маркетплейс плагинов + SKILL.md | Полное (доступ к shell) | /plugin install (см. ниже) |
| Cursor IDE | AGENTS.md + .cursor/rules/ + автообнаружение скилла | Полное (доступ к shell) | Клонировать репозиторий или установить скилл |
| GitHub Copilot | AGENTS.md + .github/copilot-instructions.md | Полное (режим агента) | Клонировать репозиторий, начать работу |
| Windsurf | AGENTS.md загружается автоматически | Полное (доступ к shell) | Клонировать репозиторий, начать работу |
| Cline | AGENTS.md загружается автоматически | Полное (доступ к shell) | Клонировать репозиторий, начать работу |
| Aider / Devin / Goose / Amp | AGENTS.md загружается автоматически | Полное (доступ к shell) | Клонировать репозиторий, начать работу |
| ChatGPT Custom GPT | Загруженные инструкции + файлы знаний | Ограниченное (без скриптов) | См. chatgpt/README.md |
| Claude Desktop (claude.ai) | Загрузить SKILL.md в Project Knowledge | Без доступа к shell | Ручная загрузка |
AGENTS.md — это кросс-инструментальный стандарт (Linux Foundation, 20+ инструментов). Один файл охватывает все AGENTS.md-совместимые платформы.
Установка
Любой AGENTS.md-совместимый инструмент (Codex, Gemini CLI, Copilot, Windsurf, Cline, Aider и др.)
Клонируйте репозиторий в ваш проект или рабочую директорию. Инструмент автоматически обнаружит AGENTS.md:
git clone https://github.com/mykpono/ultimate-seo-geo.git
cd ultimate-seo-geo
pip install -r requirements.txt # опционально, для скриптовЗатем просто начните работу — агент загрузит инструкции автоматически.
Claude Code
claude plugin install mykpono/ultimate-seo-geo
Или вручную:
git clone https://github.com/mykpono/ultimate-seo-geo.git ~/.claude/plugins/ultimate-seo-geoCursor IDE
Клонируйте репозиторий или установите скилл через маркетплейс. Cursor автоматически подхватит AGENTS.md и правила из .cursor/rules/.
Claude Desktop / claude.ai
- Откройте
SKILL.mdиз репозитория - Скопируйте содержимое
- Вставьте в Project Knowledge вашего проекта
Быстрый старт
Полный аудит
Проведи полный SEO + GEO аудит https://example.com
Только технический SEO
Проверь технические SEO-проблемы на https://example.com — сосредоточься на Core Web Vitals и crawlability
Оптимизация под AI-поиск
Оптимизируй этот контент для Google AI Overviews и ChatGPT Search: [вставьте контент]
Генерация schema
Сгенерируй JSON-LD schema для этой страницы: [вставьте URL или контент]
Генерация отчёта (требует Python)
python scripts/generate_report.py https://example.com
# Глубокий обход (медленнее):
python scripts/generate_report.py https://example.com --crawl-deepСтруктура репозитория
ultimate-seo-geo/
├── AGENTS.md # Основные инструкции (все AGENTS.md-совместимые инструменты)
├── SKILL.md # Claude Code / Claude Desktop версия
├── GEMINI.md # Точка входа для Gemini CLI
├── .cursor/rules/ # Правила для Cursor IDE
├── .github/copilot-instructions.md # Инструкции для GitHub Copilot
├── scripts/ # 20+ диагностических скриптов Python
│ ├── generate_report.py # Главный генератор отчётов (HTML + Excel)
│ ├── technical_seo.py
│ ├── core_web_vitals.py
│ ├── schema_validator.py
│ ├── geo_citability.py
│ └── ...
├── references/
│ ├── optional-extensions-mcp.md # Firecrawl, DataForSEO интеграции
│ └── ...
├── chatgpt/
│ └── README.md # Инструкции для ChatGPT Custom GPT
├── requirements.txt
└── CHANGELOG.md
Диагностические скрипты
20+ скриптов Python для автоматизированных проверок:
| Скрипт | Что проверяет |
|---|---|
generate_report.py | Агрегированный HTML/Excel отчёт |
technical_seo.py | Crawlability, индексируемость, редиректы |
core_web_vitals.py | LCP, INP, CLS через PageSpeed API |
schema_validator.py | JSON-LD валидация и генерация |
geo_citability.py | Оценка цитируемости для AI-поиска |
hreflang_audit.py | Международный SEO, валидация языковых тегов |
internal_links.py | Граф внутренних ссылок, страницы-сироты |
content_quality.py | E-E-A-T сигналы, тонкий контент |
robots_analyzer.py | Конфигурация robots.txt, AI-краулеры |
llms_txt_generator.py | Генерация llms.txt |
Полный список: см. директорию scripts/.
Лицензия
MIT — см. LICENSE.