Перенесіть дані Search Console до свого асистента.
mcp-gsc підключає Google Search Console до Claude, ChatGPT, Cursor та інших MCP-клієнтів через Google OAuth.
- Рекомендований режим
- Read-only
- Автентифікація
- Google OAuth
- Варіанти запуску
- npm / Worker
- Ліцензія
- MIT
npm · Google Search Console MCP
Встановіть GSC MCP локально через npm
npm запускає сервер Streamable HTTP на вашому комп'ютері. Спочатку потрібні Google OAuth і налаштовані облікові дані; це не підключення одним натисканням.
1. Підготуйте доступ Google
Node.js ^22.18.0 / >=24.11.0+npm- Використовуйте обліковий запис Google з доступом до потрібного ресурсу Search Console.
- Створіть клієнт OAuth у Google Cloud, увімкніть необхідні API та зареєструйте точний локальний URI перенаправлення.
- Задайте ці три змінні середовища за посібником відповідної версії. 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
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 обмежено відповідними типами вмісту.
get_capabilitiesПерелічує доступні можливості та стан автентифікації.
list_sitesПерелічує ресурси Search Console, доступні підключеному акаунту.
query_search_analyticsЗапитує кліки, покази, CTR і позицію за довільні періоди.
inspect_urlОтримує актуальні звіти перевірки URL і подробиці індексації.
list_sitemapsПерелічує надіслані карти сайту зі станом сканування та попередженнями.
add_siteДодає ресурс Search Console до підключеного акаунта.
delete_siteВилучає ресурс Search Console з акаунта.
submit_sitemapНадсилає карту сайту для ресурсу Search Console.
delete_sitemapВилучає надіслану карту сайту з ресурсу.
get_sitemapОтримує докладний стан однієї надісланої карти сайту.
identify_quick_winsЗнаходить запити з високими показами на позиціях від 8 до 20.
detect_cannibalizationЗнаходить запити, за якими за видимість конкурують кілька сторінок.
detect_content_decayВизначає сторінки з найбільшим падінням кліків із пошуку.
request_indexingЗапитує індексацію через Indexing API від Google. Наразі Google обмежує цей API сторінками зі структурованими даними JobPosting або сторінками трансляцій із BroadcastEvent усередині VideoObject. Для звичайних сторінок він недоступний.
list_indexed_pagesПерелічує сторінки, які отримали покази в Search Console.
compare_performanceПорівнює кліки, покази, CTR і позицію між періодами.
weekly_digestСтворює щотижневий SEO-звіт простою мовою.
Розгортання
Потрібен віддалений доступ?
Самостійне розгортання на Cloudflare Workers залишається доступним. Потрібні налаштування Cloudflare й Google OAuth. Приклад нижче використовує Bash; повна інструкція — у SETUP.md.
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.