Bawa data Search Console ke asisten Anda.
mcp-gsc menghubungkan Google Search Console ke Claude, ChatGPT, Cursor, atau klien MCP lain. Tanyakan kueri, halaman, performa, sitemap, dan inspeksi URL dengan Google OAuth.
- Mode disarankan
- Read-only
- Metode autentikasi
- Google OAuth
- Pilihan jalankan
- npm / Worker
- Lisensi
- MIT
npm · Google Search Console MCP
Instal GSC MCP secara lokal dengan npm
npm menjalankan server Streamable HTTP pada komputer Anda. Google OAuth dan kredensial harus disiapkan terlebih dahulu; ini bukan koneksi satu klik.
1. Siapkan akses Google
Node.js ^22.18.0 / >=24.11.0+npm- Gunakan akun Google yang memiliki akses ke properti Search Console yang ingin dianalisis.
- Buat klien OAuth di Google Cloud, aktifkan API yang diperlukan, dan daftarkan URI pengalihan lokal yang tepat.
- Atur tiga variabel lingkungan ini sesuai panduan versi yang sama. TOKEN_ENCRYPTION_KEY harus berupa base64 valid dari tepat 32 byte acak.
GOOGLE_CLIENT_IDGOOGLE_CLIENT_SECRETTOKEN_ENCRYPTION_KEY
Daftarkan URI yang persis sama di Google Cloud. Host, port, dan jalur harus cocok; localhost berbeda dari 127.0.0.1.
http://127.0.0.1:8080/google/callback localhost ≠ 127.0.0.1
2. Jalankan server lokal
Setelah kredensial diatur di terminal, jalankan paket npm. Untuk analitik saja, gunakan pengaturan hanya baca sesuai shell Anda.
Mode bawaan launcher adalah readwrite. Pilih readonly sebelum otorisasi Google untuk analitik; alat pengubah data tidak akan didaftarkan.
Perintah Bash / zsh
export GSC_ACCESS_MODE=readonly
npx -y @digestseo/mcp-gscPowerShell
$env:GSC_ACCESS_MODE = 'readonly'
npx -y @digestseo/mcp-gscEndpoint lokal · Streamable HTTP
http://127.0.0.1:8080/mcp 3. Hubungkan klien MCP
Biarkan launcher aktif dan hubungkan klien pada komputer yang sama ke endpoint Streamable HTTP, bukan stdio.
Claude Code
claude mcp add --transport http gsc http://127.0.0.1:8080/mcpHubungkan Codex CLI / IDE
codex mcp add gsc --url http://127.0.0.1:8080/mcpCursor
Di Cursor, tambahkan server MCP Streamable HTTP bernama gsc dengan URL ini (Cursor lokal).
http://127.0.0.1:8080/mcp ChatGPT / Claude.ai
ChatGPT dan Claude berbasis cloud tidak dapat mengakses 127.0.0.1 di komputer Anda. Gunakan Worker HTTPS milik sendiri atau tunnel MCP aman yang tersedia sesuai izin akun.
Perlu akses jarak jauh?Perlu akses jarak jauh?
Cloudflare Workers tetap tersedia untuk hosting mandiri melalui HTTPS, dengan konfigurasi Cloudflare dan Google OAuth. Contoh di bawah memakai Bash; lihat SETUP.md untuk langkah lengkap.
Tentang
Apa itu mcp-gsc?
mcp-gsc adalah server Model Context Protocol yang dapat di-self-host dan menghubungkan klien AI Anda langsung ke Google Search Console API resmi.
Jalankan paket npm di komputer sendiri melalui HTTP loopback, atau deploy Worker Cloudflare sendiri untuk endpoint HTTPS. Keduanya menggunakan Google OAuth.
Launcher lokal secara default menyimpan status sesi terenkripsi di ~/.mcp-gsc/state; Worker memakai penyimpanan akun Cloudflare Anda. Ini bukan konektor yang dihosting DigestSEO.
Impor laporan Web: multimodal untuk melihat tayangan dan klik per halaman. Alat ini tidak memindai foto atau mengubah gambar. Analisis Google Lens dan penelusuran multimodal.
Bandingkan penemuan akun media sosial Anda di Google menggunakan ekspor yang diizinkan, bukan suka atau penayangan dalam aplikasi. Bandingkan kinerja konten media sosial di Google.
Alat
Kemampuan server
Alat terfokus mencakup analitik, inspeksi URL, sitemap, pengindeksan, diagnosis SEO, dan ringkasan performa mingguan.
Daftar ini mencakup alat tulis opsional. GSC_ACCESS_MODE=readonly hanya mengaktifkan alat tanpa perubahan; Google Indexing API dibatasi untuk jenis konten tertentu.
get_capabilitiesDaftar kemampuan yang tersedia dan status autentikasi.
list_sitesDaftar properti Search Console yang dapat diakses akun terhubung.
query_search_analyticsTanyakan klik, tayangan, CTR, dan posisi untuk rentang tanggal khusus.
inspect_urlAmbil laporan inspeksi URL langsung dan detail pengindeksan.
list_sitemapsDaftar sitemap yang dikirim beserta status crawl dan peringatannya.
add_siteTambahkan properti Search Console ke akun terhubung.
delete_siteHapus properti Search Console dari akun.
submit_sitemapKirim sitemap untuk properti Search Console.
delete_sitemapHapus sitemap yang dikirim dari properti.
get_sitemapAmbil status terperinci untuk satu sitemap yang dikirim.
identify_quick_winsTemukan kueri dengan tayangan tinggi yang berada di posisi 8–20.
detect_cannibalizationTemukan kueri yang diperebutkan oleh beberapa halaman.
detect_content_decayIdentifikasi halaman dengan penurunan klik pencarian terbesar.
request_indexingMeminta pengindeksan melalui Indexing API Google. Google saat ini membatasi API ini untuk halaman yang berisi data terstruktur JobPosting atau halaman siaran langsung yang berisi BroadcastEvent di dalam VideoObject. API ini tidak tersedia untuk pengiriman halaman web secara umum.
list_indexed_pagesDaftar halaman yang menerima tayangan di Search Console.
compare_performanceBandingkan klik, tayangan, CTR, dan posisi antarperiode.
weekly_digestBuat laporan SEO mingguan dengan bahasa sederhana.
Deploy
Perlu akses jarak jauh?
Cloudflare Workers tetap tersedia untuk hosting mandiri melalui HTTPS, dengan konfigurasi Cloudflare dan Google OAuth. Contoh di bawah memakai Bash; lihat SETUP.md untuk langkah lengkap.
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 deployBeri bintang pada repo dan bawa Search Console ke Claude.
Open source dan dapat dihosting sendiri. Ikuti panduan Google OAuth atau deploy Worker sendiri.