Wingate SEO

Open-source, self-hosted Google Search Console + Google Analytics 4 MCP-сервер для ChatGPT и других MCP-клиентов. Анализируйте собственные SEO-данные, не платя за очередной SEO-дашборд.

Wingate SEO MCP подключает MCP-клиент к свойствам Google, которыми вы уже владеете. Он объединяет данные Search Console, вовлеченность GA4, карты сайта и проверку URL, сравнение периодов и детерминированную SEO-диагностику в одном сервисе только для чтения.

Издатель: Wingnut Innovations
Версия: 0.5.1
Лицензия: MIT

Зачем это использовать?

• Задавайте вопросы о своих данных GSC и GA4 на естественном языке.

• Храните учетные данные и привязку свойств на вашей инфраструктуре.

• Замените рутинную работу с дашбордами на воспроизводимые результаты и расчеты.

• Анализируйте события, вовлеченность на целевых страницах, возможности CTR, изменения рейтингов, снижение и каннибализацию.

• Начинайте с намеренно ограниченной, доступной только для чтения границы безопасности.

Вы предоставляете свои собственные учетные данные Google и предоставляете этому аккаунту доступ только к тем свойствам, которые хотите анализировать. Wingate SEO MCP не включает в себя размещенные аккаунты, встроенный доступ к Google, платные шлюзы, телеметрию, рекламу или подписки.

Инструменты MCP только для чтения

Публичный сервер открывает ровно 11 инструментов:

В публичном наборе нет Search Console, Google Indexing, GA4 Admin, отправки sitemap или других инструментов записи.

Требования

• Node.js 20, 22 или 24

• npm

• Проект Google Cloud с включенными необходимыми API

• Учетные данные JSON сервисного аккаунта пользователя, предоставленные пользователем, с доступом к вашим GSC- и GA4-свойствам

• MCP-клиент, который может получить доступ к локальному Streamable HTTP-конечному документу

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

git clone https://github.com/wingnutinnovations-tech/wingate-seo-mcp.git
cd wingate-seo-mcp
npm install

Используйте .env.example как шаблон и задайте те же переменные окружения в оболочке, которая запускает команды. Проект не загружает .env автоматически. Храните загруженный JSON-файл служебного аккаунта за пределами репозитория.

GOOGLE_SERVICE_ACCOUNT_FILE=/absolute/path/to/google-service-account.json
WINGATE_SITES_FILE=./config/sites.local.json

Время выполнения MCP v0.5.0, запущенное командой npm start, требует явных учетных данных служебного аккаунта. Укажите переменную GOOGLE_SERVICE_ACCOUNT_FILE (предпочтительно), GOOGLE_APPLICATION_CREDENTIALS или GOOGLE_SERVICE_ACCOUNT_JSON. Он не переключается на подключенный метаданные Google или рабочую нагрузку.

npm run doctor
npm run discover:google

Создайте игнорируемый локальный реестр сайтов, используя свойства, полученные обнаружением:

npm run setup -- --output config/sites.local.json \
  --gsc sc-domain:example.com \
  --ga4 123456789 \
  --origin https://example.com \
  --key example-site \
  --name "Example Site"

Выполните ограниченные живые чтения, затем запустите сервер:

npm run live:smoke -- --site example-site --inspect-origin
npm start

Конечные точки по умолчанию:

http://127.0.0.1:3000/healthz
http://127.0.0.1:3000/mcp

Подробное пошаговое руководство см. в Google setup и live onboarding.

Настройка Google API

Включите эти API в вашем проекте Google Cloud:

• Google Search Console API

• API проверки URL Search Console

• Google Analytics Data API

• Google Analytics Admin API

Предоставьте аккаунту службы доступ к каждой собственности Search Console и как минимум права просмотра для каждой собственности GA4. Время выполнения запросов только:

• https://www.googleapis.com/auth/webmasters.readonly

• https://www.googleapis.com/auth/analytics.readonly

API Analytics Admin используется только для обнаружения доступных свойств и веб-потоков GA4. MCP-сервер не изменяет настройки GA4 Admin.

Сопоставление сайтов

Каждая запись локального реестра сопоставляет стабильный siteKey с одной собственностью Search Console, дополнительной собственностью GA4 и корнем сайта. Скопируйте config/sites.example.json для формы, или запустите npm run setup для генерации и валидации config/sites.local.json.

Локальные реестры игнорируются Git. Никогда не отправляйте реальные сопоставления свойств, если читатели репозитория не должны знать, какие сайты вы обслуживаете.

Подключение MCP-клиента

Запустите сервер и укажите на него MCP-клиент, поддерживающий Streamable HTTP, на локальном /mcp-эндпоинте. Используйте поддерживаемое клиентское подключение или независимо проверенную транспортную границу. Этот репозиторий не содержит интернет-туннель или слой аутентификации.

Перед отправкой данных проведите проверку инструментов и убедитесь, что существует ровно 11 инструментов, и каждый обозначен только для чтения. См. Подключение MCP-клиента.

Примеры вопросов

• «Какие страницы потеряли клики в этом месяце?»

• «Найдите запросы с рейтингом 4–20 с низким CTR.»

• «Какие органические целевые страницы имеют лучшую вовлеченность?»

• «Сработал ли мой лид?»

• «Сравните последние 28 дней с предыдущими 28 днями.»

Конфиденциальность и безопасность

В Wingate SEO MCP нет незаписываемой телеметрии. Он не отправляет аналитику использования в Wingnut Innovations или третьим лицам.

Данные покидают вашу машину или сервер только в тех случаях, когда:

• коннектор вызывает Google API с использованием ваших учетных данных и прав доступа; или

• ваш настроенный MCP-клиент отправляет запросы на этот сервер и получает от него ответы.

По умолчанию сервер привязывается к 127.0.0.1. Не открывайте его для общего доступа в Интернет без независимо проверенной пограничной и транспортной аутентификации. Не размещайте учетные данные, локальные реестры или команды в промптах или исходном коде. См. SECURITY.md.

Устранение неполадок

• Не удается прочитать файл с учетными данными: используйте абсолютный путь и храните JSON за пределами репозитория.

• Ошибка 403 от Google: включите соответствующий API и предоставьте доступ служебному аккаунту к этому ресурсу.

• Свойство GA4 не найдено: предоставьте хотя бы доступ читателя, затем перезапустите npm run doctor.

• Неопределенное сопоставление: укажите --ga4 явно; обнаружение никогда не выбирает слабое совпадение автоматически.

• Строка события не найдена: GA4 не наблюдалось сопоставимой строки события для данной даты/фильтра; отсутствие одной строки само по себе не является диагностикой инструментации.

• MCP-клиент не может подключиться: проверьте npm start, /healthz, привязку к локальным амперам, а также настройки локальной сети или раздельно защищенного транспорта клиента.

Разработка и валидация

npm run ci

Выполняет проверки синтаксиса, TypeScript, модульные/интеграционные тесты, производственную сборку и обнаружение MCP. CI настроен на Node.js 20, 22, 24.

Docker-упаковка намеренно отложена до момента появления небольшого проверяемого образа и non-root политики выполнения; путь самодостаточности Node/npm является исходными вариантами v0.5.0 версии.

Дорожная карта и поддержка

См. дорожную карту. Wingate SEO MCP бесплатен и имеет открытый исходный код. Если код экономит ваше время или подписку на SEO-инструмент, вы можете при желании поддержать продолжительную разработку. Никакой финансовый провайдер не настроен в v0.5.0.

Лицензия, происхождение и независимость

Wingate SEO MCP лицензирован под лицензией MIT. Отобранные клиентские и методы: адаптировано и существенно переписано из источников с копией MIT, указанных в UPSTREAM.md, UPSTREAM_IMPORT_MANIFEST.json и THIRD_PARTY_NOTICES.md.

Wingate SEO MCP — независимый проект, опубликованный Wingnut Innovations. Он не сотрудничает, не одобрен и не спонсирован Google или OpenAI. Google Search Console, Google Analytics, GA4, ChatGPT и OpenAI являются товарными знаками их владельцев.