📊 GSC New Keys Analyzer PRO

Скрипт на базе Streamlit для SEO-специалистов, который автоматизирует поиск новых поисковых запросов через Google Search Console API.

Инструмент сравнивает два периода (месяца) и находит запросы, по которым ваши страницы начали ранжироваться только в последнем периоде. Это помогает быстро находить точки роста и «хвосты» для дооптимизации контента.

✨ Основные возможности

• Парсинг Sitemap: Автоматически извлекает все URL сайта для детальной проверки каждого.
• Интеллектуальное сравнение: Вычисляет разницу между множествами запросов за два периода.
• Метрики эффективности: Для каждого нового ключа выводятся Показы, Клики и Средняя позиция.
• Точность данных: Средняя позиция округляется до десятых (например, 12.4).
• Удобный интерфейс: - Сортировка страниц по количеству найденных новинок (Топ-50).
  • Результаты в виде раскрывающихся списков.
  • Готовое текстовое поле для копирования списка ключей одним кликом.
• Умные периоды: По умолчанию установлены два последних полных месяца (учитывая задержку данных в GSC API).

🛠 Технический стек

• Python 3.10+
• Streamlit (UI)
• Pandas (Data Processing)
• Google API Python Client (GSC API Connection)

🚀 Быстрый старт

1. Подготовка Google API

1. Создайте проект в Google Cloud Console.
2. Включите Google Search Console API.
3. Создайте Service Account, создайте ключ в формате JSON и скачайте его.
4. Переименуйте файл в credentials.json и положите в корень папки со скриптом.
5. Важно: Скопируйте email сервисного аккаунта и добавьте его в настройках вашего ресурса Google Search Console (Настройки -> Пользователи -> Добавить пользователя) с правами "Полный доступ".

2. Установка зависимостей

pip install streamlit pandas google-api-python-client requests

📋 Инструкция по использованию

1. Ввод данных:
   • Вставьте прямую ссылку на ваш sitemap.xml в соответствующее поле в боковой панели (Sidebar).
   • Убедитесь, что формат ссылки верный (например, https://site.com/sitemap.xml).
2. Автоопределение ресурса:
   • Скрипт автоматически извлечет домен из первой найденной ссылки в Sitemap и определит адрес ресурса в GSC. Вам не нужно вводить его вручную.
3. Настройка периодов:
   • По умолчанию установлены два последних полных месяца (например, Январь 2026 против Декабря 2025).
   • Важно: Мы не используем текущий месяц (февраль) по умолчанию, так как данные в GSC API появляются с задержкой в 2-3 дня, и сравнение будет некорректным. При необходимости вы можете изменить месяцы вручную.
4. Запуск процесса:
   • Нажмите кнопку "Запустить глубокий анализ".
   • Следите за прогресс-баром. Скрипт обрабатывает каждый URL индивидуально, чтобы получить максимально точные данные по ключам.
5. Изучение результатов:
   • Результаты появятся в виде списка Топ-50 страниц, отсортированных по количеству «новинок».
   • Кликните на заголовок с URL, чтобы раскрыть детали.
   • Внутри вы увидите таблицу с метриками (Показы, Клики, Позиция) и текстовое поле, из которого можно одним движением скопировать список ключей.

⚙️ Техническая логика

• Сравнение: Скрипт выполняет запросы к API для каждого URL за оба периода. Новыми считаются только те запросы, которые имеют статистику в выбранном месяце, но полностью отсутствовали в базовом.
• Форматирование: Позиции в таблице принудительно округляются до десятых долей (например, 14.2), а показатели показов и кликов отображаются как целые числа с разделителями тысяч для удобства чтения.