Συνδέστε το Search Console με οποιονδήποτε client MCP

Το endpoint

Ο διακομιστής βρίσκεται στο /mcp στον τομέα της εφαρμογής και χρησιμοποιεί Streamable HTTP στην έκδοση πρωτοκόλλου 2025-06-18. Οι clients στέλνουν POST JSON-RPC, ένα αίτημα initialize και έπειτα tools/list. Δεν χρειάζεται καμία εγκατάσταση ούτε τοπικός proxy στη διαδρομή.

• Authorization: Bearer με κλειδί της μορφής apk_live_ συν 32 δεκαεξαδικούς χαρακτήρες
• Τα κλειδιά εμφανίζονται μία φορά κατά τη δημιουργία και αποθηκεύονται μόνο ως SHA-256 hash
• Κάθε κλήση ενημερώνει τη χρονοσφραγίδα τελευταίας χρήσης του κλειδιού και τον μετρητή αιτημάτων

Τα εργαλεία

Ομαδοποιημένα ανά λειτουργία, με σαφή ονόματα ώστε ένα μοντέλο να επιλέγει το σωστό εργαλείο. Ένα κλειδί μόνο για ανάγνωση δεν φτάνει ποτέ σε εργαλείο που γράφει ή καταναλώνει πιστώσεις έρευνας.

• Ανακάλυψη: list_properties, search_analytics
• Απόδοση: top_queries, top_pages, top_countries, compare_periods
• Διάγνωση: content_decay, cannibalization, ctr_benchmark, page_poaching, rank_changes, new_lost_rankings
• Ευρετηρίαση: url_inspection, sitemaps
• Χρονολόγιο: annotations, και create_annotation με κλειδί εγγραφής
• Αναλυτικά: ga4_overview, ga4_breakdown, ga4_key_events
• Έρευνα: λέξεις-κλειδιά, SERP, backlinks, παρακολούθηση θέσεων και έλεγχοι ιστότοπου, που καταναλώνουν πιστώσεις έρευνας
• Content engine: content_list_tasks, content_claim, content_get_brief, content_submit, content_publish και τα εργαλεία εξωφύλλου, για να γράφετε από την ουρά

Οι ημερομηνίες είναι προαιρετικές

Παραλείψτε το εύρος σε οποιοδήποτε εργαλείο και ο διακομιστής χρησιμοποιεί τις τελευταίες 28 σταθεροποιημένες ημέρες, λαμβάνοντας υπόψη την καθυστέρηση αναφοράς του Search Console, με το παράθυρο σύγκρισης να ορίζεται από προεπιλογή στην προηγούμενη περίοδο ίδιας διάρκειας. Ο client δεν χρειάζεται ποτέ να γνωρίζει τη σημερινή ημερομηνία για να θέσει μια λογική ερώτηση.

Πεδία πρόσβασης και όρια ρυθμού

Ένα κλειδί είναι είτε μόνο για ανάγνωση είτε για ανάγνωση και εγγραφή. Ένα κλειδί μόνο για ανάγνωση δεν μπορεί καθόλου να προσπελάσει εργαλείο εγγραφής, και κάθε μεταβολή με κλειδί εγγραφής καταγράφεται σε αρχείο ελέγχου.

• 60 αιτήματα ανά λεπτό ανά κλειδί, 1.000 ανά ώρα ανά λογαριασμό
• Η υπέρβαση του ορίου επιστρέφει HTTP 429 με Retry-After σε δευτερόλεπτα
• Ανακαλέστε ένα μεμονωμένο κλειδί χωρίς να επηρεάσετε τον υπόλοιπο λογαριασμό

REST, αν προτιμάτε

Τα εργαλεία Search Console και GA4 είναι διαθέσιμα και ως διαδρομές GET και POST κάτω από το /v1, με ένα παραγόμενο έγγραφο OpenAPI 3.1 στο /v1/openapi.json, που λειτουργεί και ως προδιαγραφή function-calling. Ίδια κλειδιά, ίδια δικαιώματα, ίδια όρια.