Kết nối Search Console với bất kỳ MCP client nào

Endpoint

Server nằm tại /mcp trên domain của app và giao tiếp bằng Streamable HTTP ở phiên bản protocol 2025-06-18. Client gửi POST JSON-RPC, gửi một yêu cầu initialize, sau đó tools/list. Không cần cài đặt gì và không có proxy cục bộ nào trong luồng xử lý.

• Authorization: Bearer với key có dạng apk_live_ cộng thêm 32 ký tự hex
• Key chỉ được hiển thị một lần lúc tạo và chỉ được lưu dưới dạng hash SHA-256
• Mỗi lần gọi sẽ cập nhật thời điểm dùng gần nhất và bộ đếm request của key

Các công cụ

Được nhóm theo chức năng, với tên rõ ràng để mô hình chọn đúng công cụ. Khóa chỉ đọc không bao giờ truy cập được công cụ ghi dữ liệu hay tiêu tốn tín dụng nghiên cứu.

• 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, và create_annotation trên key có quyền ghi
• Analytics: ga4_overview, ga4_breakdown, ga4_key_events
• Nghiên cứu: từ khóa, SERP, backlink, theo dõi thứ hạng và kiểm tra website, có tiêu tốn tín dụng nghiên cứu
• Content engine: content_list_tasks, content_claim, content_get_brief, content_submit, content_publish và các công cụ ảnh bìa, để viết từ hàng đợi

Ngày là tùy chọn

Bỏ qua khoảng thời gian ở bất kỳ tool nào và server sẽ dùng 28 ngày đã ổn định gần nhất, có tính đến độ trễ báo cáo của Search Console, với khoảng so sánh mặc định là giai đoạn trước đó có cùng độ dài. Client không bao giờ cần biết ngày hôm nay để đặt một câu hỏi hợp lý.

Scope và giới hạn tốc độ

Một key là chỉ đọc hoặc đọc và ghi. Key chỉ đọc hoàn toàn không thể truy cập tool ghi, và mọi thay đổi trên key có quyền ghi đều được ghi audit log.

• 60 request mỗi phút cho mỗi key, 1.000 request mỗi giờ cho mỗi tài khoản
• Vượt giới hạn sẽ trả về HTTP 429 kèm Retry-After tính bằng giây
• Hủy một key riêng lẻ mà không ảnh hưởng đến phần còn lại của tài khoản

REST, nếu bạn muốn

Các công cụ Search Console và GA4 cũng có dưới dạng route GET và POST tại /v1, kèm tài liệu OpenAPI 3.1 được tạo tự động tại /v1/openapi.json, đồng thời dùng làm đặc tả function calling. Cùng khóa, cùng phạm vi, cùng giới hạn.