API ВЕГА
English

dotTide

dotTide — MCP-сервер и инструмент командной строки с доступом только на чтение. Он предоставляет Claude, Cursor, Codex и другим ИИ-агентам статистику по всем вашим сайтам. dotTide получает данные из Google Search Console и Google Analytics 4 (GA4), в том числе из нескольких аккаунтов Google, а также статистику WordPress.org, Firefox Add-ons и GitHub. Кроме того, он сохраняет еженедельный снимок данных для скриптов и ИИ-агентов.

dotTide ничего не добавляет на ваши сайты. Он только считывает уже имеющиеся данные, а ключи остаются на вашем компьютере.

Зачем нужен dotTide

Если ваши сайты связаны с разными аккаунтами Google, чтобы проверить их статистику, приходится поочерёдно входить в каждый аккаунт. Еженедельная проверка постепенно превращается в ежемесячную, а ИИ-агенты работают с устаревшими данными. Статистика плагинов, расширений и репозиториев хранится в других сервисах.

dotTide собирает все эти данные с помощью одного ключа с правами только на чтение и предоставляет их в едином формате: в Claude, через командную строку и в еженедельном JSON-файле.

Возможности

  • sites: список всех настроенных сайтов, сведения о том, какой ключ даёт доступ к каждому из них, а также проверка доступа к Search Console, GA4 и Bing по запросу.

  • search_queries: клики, показы, CTR и средняя позиция по поисковым запросам или страницам за любой период. Можно сравнить данные с предыдущим периодом и задать фильтры по стране, устройству и типу поиска.

  • traffic: сеансы GA4 по источнику и каналу. Переходы от ИИ-ассистентов (ChatGPT, Perplexity, Copilot, Gemini, Claude и других) учитываются отдельно, вместе с целевыми страницами, на которые они привели посетителей (landing_pages). Доступно только для сайтов с GA4.

  • store_stats: актуальная общедоступная статистика, для которой не нужен ключ: плагины WordPress.org, Firefox Add-ons и звёзды GitHub.

  • opportunities: список направлений для дальнейшей работы: запросы, близкие к выходу на более высокие позиции; страницы и запросы, теряющие клики; страницы и запросы, позиции которых снижаются (slipping_pages, slipping_queries); а также запросы на первой странице результатов с низким CTR для занимаемой позиции. Если последний список пуст из-за того, что слишком мало запросов попадает на первую страницу, поле low_ctr_note объясняет причину и показывает количество запросов в каждом диапазоне позиций. Добавьте названия брендов в профиль в поле brand_terms, чтобы запросы с ними не учитывались при поиске низкого CTR: такие запросы обычно получают гораздо больше кликов на верхних позициях.

  • page_queries: запросы, по которым посетители переходят на конкретную страницу, и доля трафика страницы, которую Google скрывает из-за анонимизации запросов.

  • competing_pages: запросы, по которым показы распределяются между двумя или более вашими страницами. Сначала выводятся запросы с наибольшим пересечением.

  • index_health: состояние каждой карты сайта и проверка того, попадают ли самые важные страницы в индекс Google, а также простой список проблем, требующих устранения.

  • core_web_vitals: показатели LCP, INP и CLS по реальным пользователям с оценками Google при наличии достаточного объёма данных, а также результаты лабораторного теста из PageSpeed Insights.

  • bing_queries: клики, показы и позиции по запросам из Bing Webmaster Tools. Bing используется в Copilot.

  • discover: находит все доступные ключу ресурсы Search Console и GA4 и добавляет их в профиль. Для каждого домена также предлагает значение brand_terms, оставляя его закомментированным до вашей проверки.

  • Готовые подсказки: еженедельная проверка, список дальнейших задач и проверка индексации. Они доступны в Claude и других MCP-клиентах как команды.

  • Еженедельный снимок: данные за последнюю полную неделю в сравнении с предыдущей. Для каждого профиля создаётся отдельный JSON-файл, который могут использовать скрипты и ИИ-агенты.

Как работает доступ

Переносить сайты в новый аккаунт Google не нужно. Создайте сервисный аккаунт Google, а затем предоставьте его адресу электронной почты доступ к сайтам из соответствующих аккаунтов Google:

  • Search Console: роль «Пользователь с ограниченным доступом».

  • GA4: роль «Читатель».

Сервисный аккаунт имеет права только на чтение. Вы можете отозвать его доступ к любому сайту одним нажатием. Подключение Bing необязательно: для него используется один API-ключ из Bing Webmaster Tools, который даёт доступ ко всем вашим сайтам в этом сервисе. Ключ хранится в системном хранилище секретов: в связке ключей macOS, Диспетчере учётных данных Windows или Linux Secret Service.

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

Вам понадобится macOS, Windows или Linux, а также uv. Клонировать репозиторий не нужно: при первом запуске uvx загрузит dotTide.

  • Создайте начальный профиль, затем добавьте в него слаг плагина, слаг расширения или имя пользователя GitHub в раздел [stores]:
uvx dottide init
  • Убедитесь, что dotTide запускается. Для просмотра статистики магазинов настройка Google не требуется:
uvx dottide store_stats

  • Настройте доступ к Google по инструкции Настройка Google. Настройка займёт около десяти минут, а добавление каждого сайта — ещё примерно минуту.

  • Сохраните ключ, найдите сайты с помощью dotTide и проверьте доступ:

.json uvx dottide discover --write uvx dottide sites">

uvx dottide import-key dottide-main ~/Downloads/<downloaded-key>.json
uvx dottide discover --write
uvx dottide sites

  • Необязательно: добавьте статистику Bing, следуя инструкции Настройка Bing. Это займёт около пяти минут.

  • Подключите dotTide к Claude Code:

claude mcp add --scope user dottide -- uvx dottide

Чтобы обновить dotTide, один раз выполните uvx dottide@latest sites. После этого команда uvx dottide будет запускать новую версию.

Документация

  • Настройка Google: создание сервисного аккаунта с пошаговыми инструкциями и предоставление ему доступа к сайтам.

  • Настройка Bing: необязательное подключение статистики Bing Webmaster Tools с помощью одного API-ключа.

  • Конфигурация: профили, описание всех полей, ключи и переменные окружения.

  • Использование dotTide: инструменты и их параметры, MCP-клиенты, еженедельный снимок и его формат, а также решения распространённых проблем.

  • Как запросить статистику у ИИ-агента: примеры запросов для еженедельных проверок, поиска контента для обновления, анализа переходов от ИИ-ассистентов и статистики магазинов, а также сохранённая команда Claude Code.

  • Подключение ИИ-клиентов: Claude Code, Claude Desktop, Cursor, Windsurf, VS Code, Codex, Gemini CLI, Grok и агенты без MCP.

Полезно знать

  • Данные Search Console становятся окончательными примерно через три дня, поэтому периоды по умолчанию заканчиваются за три дня до текущей даты.

  • Все разрешения Google, которые запрашивает dotTide, дают доступ только на чтение. Ни один инструмент не может изменять данные.

  • GitHub ограничивает число анонимных запросов до 60 в час с одного IP-адреса. Если вы достигли этого ограничения, задайте DOTTIDE_GITHUB_TOKEN со значением токена, имеющего права только на чтение.

Участие в разработке

См. CONTRIBUTING.md. Сообщения об уязвимостях направляйте через SECURITY.md.

Лицензия

Код распространяется по лицензии MIT License. Название и значок dotTide лицензией не покрываются, поэтому при распространении собственной копии используйте свои название и значок.