Hubungkan Search Console ke MCP client mana pun

Endpoint

Server berada di /mcp pada domain aplikasi dan menggunakan Streamable HTTP dengan versi protokol 2025-06-18. Client mengirim POST JSON-RPC, mengirim permintaan initialize, lalu tools/list. Tidak ada yang perlu diinstal dan tidak ada local proxy di jalurnya.

• Authorization: Bearer dengan key berformat apk_live_ ditambah 32 karakter heksadesimal
• Key hanya ditampilkan satu kali saat dibuat dan disimpan hanya dalam bentuk hash SHA-256
• Setiap panggilan memperbarui stempel waktu terakhir digunakan dan penghitung permintaan pada key

Tool

Dikelompokkan menurut fungsinya, dengan nama yang jelas agar model memilih tool yang tepat. Kunci hanya-baca tidak pernah menjangkau tool yang menulis atau memakai kredit riset.

• Discovery: list_properties, search_analytics
• Performance: top_queries, top_pages, top_countries, compare_periods
• Diagnosis: content_decay, cannibalization, ctr_benchmark, page_poaching, rank_changes, new_lost_rankings
• Indexing: url_inspection, sitemaps
• Timeline: annotations, dan create_annotation pada write key
• Analytics: ga4_overview, ga4_breakdown, ga4_key_events
• Riset: kata kunci, SERP, backlink, pelacakan peringkat, dan audit situs, yang memakai kredit riset
• Content engine: content_list_tasks, content_claim, content_get_brief, content_submit, content_publish, dan tool sampul, untuk menulis dari antrean

Tanggal bersifat opsional

Jika rentang tanggal tidak disertakan pada tool mana pun, server akan menggunakan 28 hari terakhir yang datanya sudah stabil, dengan memperhitungkan jeda pelaporan Search Console, dan jendela pembanding secara default menggunakan periode sebelumnya dengan panjang yang sama. Client tidak perlu mengetahui tanggal hari ini untuk mengajukan pertanyaan yang masuk akal.

Scope dan rate limit

Sebuah key bersifat read-only atau read and write. Key read-only sama sekali tidak dapat mengakses write tool, dan setiap mutasi pada write key akan dicatat dalam audit log.

• 60 permintaan per menit per key, 1.000 per jam per akun
• Melebihi batas akan mengembalikan HTTP 429 dengan Retry-After dalam detik
• Cabut satu key saja tanpa memengaruhi bagian lain dari akun

REST, jika Anda lebih suka

Tool Search Console dan GA4 juga tersedia sebagai rute GET dan POST di bawah /v1 dengan dokumen OpenAPI 3.1 yang dihasilkan otomatis di /v1/openapi.json, yang juga berfungsi sebagai spesifikasi function calling. Kunci, cakupan, dan batas yang sama.