Перейти до основного вмісту
Google Search Console · MCP
Google Search Console · MCP

Перенесіть дані Search Console до свого асистента.

mcp-gsc підключає Google Search Console до Claude, ChatGPT, Cursor та інших MCP-клієнтів через Google OAuth.

Рекомендований режим
Read-only
Автентифікація
Google OAuth
Варіанти запуску
npm / Worker
Ліцензія
MIT
Google Search Console MCP українською | DigestSEO
mcp-gsc підключає Google Search Console до Claude, ChatGPT, Cursor та інших MCP-клієнтів через Google OAuth.

npm · Google Search Console MCP

Встановіть GSC MCP локально через npm

npm запускає сервер Streamable HTTP на вашому комп'ютері. Спочатку потрібні Google OAuth і налаштовані облікові дані; це не підключення одним натисканням.

1. Підготуйте доступ Google

  1. Node.js ^22.18.0 / >=24.11.0 + npm
  2. Використовуйте обліковий запис Google з доступом до потрібного ресурсу Search Console.
  3. Створіть клієнт OAuth у Google Cloud, увімкніть необхідні API та зареєструйте точний локальний URI перенаправлення.
  4. Задайте ці три змінні середовища за посібником відповідної версії. TOKEN_ENCRYPTION_KEY має бути коректним base64 рівно 32 випадкових байтів.
    GOOGLE_CLIENT_IDGOOGLE_CLIENT_SECRETTOKEN_ENCRYPTION_KEY

Зареєструйте цей URI точно в Google Cloud. Хост, порт і шлях мають збігатися; localhost та 127.0.0.1 не взаємозамінні.

http://127.0.0.1:8080/google/callback

localhost ≠ 127.0.0.1

Повний посібник (SETUP.md)

2. Запустіть локальний сервер

Після налаштування даних у терміналі запустіть пакет npm. Для аналітики використайте режим лише читання для вашої оболонки.

Початковий режим — readwrite. Для аналізу встановіть readonly до авторизації Google; інструменти запису не реєструватимуться.

Команди Bash / zsh

export GSC_ACCESS_MODE=readonly
npx -y @digestseo/mcp-gsc

PowerShell

$env:GSC_ACCESS_MODE = 'readonly'
npx -y @digestseo/mcp-gsc

Локальна адреса · Streamable HTTP

http://127.0.0.1:8080/mcp

3. Підключіть клієнт MCP

Залиште процес запущеним і підключіть клієнт на тому самому комп'ютері до локального Streamable HTTP, а не stdio.

Claude Code

claude mcp add --transport http gsc http://127.0.0.1:8080/mcp

Підключіть Codex CLI / IDE

codex mcp add gsc --url http://127.0.0.1:8080/mcp

Cursor

У Cursor додайте MCP-сервер Streamable HTTP з назвою gsc та цією URL-адресою (локальний Cursor).

http://127.0.0.1:8080/mcp

ChatGPT / Claude.ai

Хмарні ChatGPT і Claude не можуть звернутися до 127.0.0.1 на вашому ПК. Скористайтеся власним HTTPS Worker або доступним захищеним MCP-тунелем, якщо це дозволено вашим обліковим записом.

Потрібен віддалений доступ?

Потрібен віддалений доступ?

Самостійне розгортання на Cloudflare Workers залишається доступним. Потрібні налаштування Cloudflare й Google OAuth. Приклад нижче використовує Bash; повна інструкція — у SETUP.md.

Про продукт

Що таке mcp-gsc?

mcp-gsc — це сервер Model Context Protocol для власного хостингу, який з’єднує ваш ШІ-клієнт напряму з офіційним API Google Search Console.

Пакет npm працює локально через loopback HTTP; для віддаленого HTTPS можна розгорнути власний Cloudflare Worker. Обидва варіанти використовують Google OAuth.

Локальний запуск зберігає зашифрований стан сеансу в ~/.mcp-gsc/state за замовчуванням; Worker використовує сховище вашого облікового запису Cloudflare. Це не керований конектор DigestSEO.

Імпортуйте звіт Web: multimodal, щоб переглянути покази й кліки сторінок. Інструмент не розпізнає фотографії. Аналіз Google Lens і мультимодального пошуку.

Порівнюйте видимість авторизованих облікових записів у пошуку Google, а не вподобання або перегляди в застосунках. Порівняйте результати контенту соцмереж у Google.

Інструменти

Можливості, які надає сервер

Спеціалізовані інструменти охоплюють аналітику, перевірку URL, карти сайту, індексацію, SEO-діагностику та щотижневий огляд ефективності.

Список містить необов'язкові інструменти запису. GSC_ACCESS_MODE=readonly надає лише інструменти без змін; Google Indexing API обмежено відповідними типами вмісту.

01get_capabilities

Перелічує доступні можливості та стан автентифікації.

02list_sites

Перелічує ресурси Search Console, доступні підключеному акаунту.

03query_search_analytics

Запитує кліки, покази, CTR і позицію за довільні періоди.

04inspect_url

Отримує актуальні звіти перевірки URL і подробиці індексації.

05list_sitemaps

Перелічує надіслані карти сайту зі станом сканування та попередженнями.

06add_site

Додає ресурс Search Console до підключеного акаунта.

07delete_site

Вилучає ресурс Search Console з акаунта.

08submit_sitemap

Надсилає карту сайту для ресурсу Search Console.

09delete_sitemap

Вилучає надіслану карту сайту з ресурсу.

10get_sitemap

Отримує докладний стан однієї надісланої карти сайту.

11identify_quick_wins

Знаходить запити з високими показами на позиціях від 8 до 20.

12detect_cannibalization

Знаходить запити, за якими за видимість конкурують кілька сторінок.

13detect_content_decay

Визначає сторінки з найбільшим падінням кліків із пошуку.

14request_indexing

Запитує індексацію через Indexing API від Google. Наразі Google обмежує цей API сторінками зі структурованими даними JobPosting або сторінками трансляцій із BroadcastEvent усередині VideoObject. Для звичайних сторінок він недоступний.

15list_indexed_pages

Перелічує сторінки, які отримали покази в Search Console.

16compare_performance

Порівнює кліки, покази, CTR і позицію між періодами.

17weekly_digest

Створює щотижневий SEO-звіт простою мовою.

Розгортання

Потрібен віддалений доступ?

Самостійне розгортання на Cloudflare Workers залишається доступним. Потрібні налаштування Cloudflare й Google OAuth. Приклад нижче використовує Bash; повна інструкція — у SETUP.md.

~/digestseo · deploy
git clone https://github.com/AKzar1el/mcp-gsc.git
cd mcp-gsc && npm install
npx wrangler login
cp wrangler.example.jsonc wrangler.jsonc
npx wrangler deploy

Поставте зірку репозиторію та відкрийте Search Console у Claude.

Відкритий код для самостійного розміщення. Налаштуйте Google OAuth за посібником або розгорніть власний Worker.