Máy chủ MCP cho Google Search Console cho phép một tác tử AI như Claude, Claude Code, Codex hoặc Cursor truy cập Search Console API. Tác tử có thể lấy số lượt nhấp, lượt hiển thị, tỷ lệ nhấp và vị trí trung bình của bạn, kiểm tra xem một trang đã được lập chỉ mục hay chưa và liệt kê các sơ đồ trang web của bạn. Bạn hỏi bằng ngôn ngữ thông thường, ví dụ "những trang nào xếp hạng ở trang một nhưng không có lượt nhấp nào?", và tác tử sẽ chạy truy vấn rồi xử lý từng hàng dữ liệu. Hướng dẫn này so sánh ba cách thiết lập, giải thích những gì API không cung cấp và đi qua một lần audit đầu tiên mà bạn có thể tự đối chiếu với Search Console.
Câu trả lời ngắn gọn: tính đến ngày 9 tháng 11 năm 2026, Google không có máy chủ MCP chính thức cho Search Console. Google có phát hành một máy chủ MCP cho Google Analytics, còn thư mục của Claude lẫn ChatGPT đều không có trình kết nối Search Console nào từ Google, Anthropic hay OpenAI. Bạn có ba lựa chọn: một máy chủ cộng đồng miễn phí do bạn tự chạy, cần có dự án Google Cloud; một máy chủ được lưu trữ sẵn mà bạn đăng nhập bằng Google; hoặc một ứng dụng có trình kết nối tích hợp sẵn như Orkas, nơi bạn nhấp Kết nối. Cả ba đều đọc cùng một API, và API này không liệt kê mọi truy vấn: Google loại bỏ các truy vấn ẩn danh, vốn chiếm 46,77% lưu lượng truy cập trong một nghiên cứu của Ahrefs trên 887.534 tài sản Search Console.
Search Console MCP làm được gì và không làm được gì
Mọi máy chủ MCP cho Search Console, dù của cộng đồng hay thương mại, đều gọi cùng một Search Console API miễn phí. Khả năng của chúng phụ thuộc vào API đó, được liệt kê dưới đây theo tài liệu tham khảo API và giới hạn sử dụng của Google.
| Bạn cần gì | API | Giới hạn |
|---|---|---|
| Lượt nhấp, lượt hiển thị, CTR và vị trí theo truy vấn, trang, quốc gia, thiết bị, ngày hoặc giao diện tìm kiếm | Search Analytics | Lịch sử 16 tháng, trễ khoảng 2–3 ngày; tối đa 25.000 hàng mỗi yêu cầu và 50.000 hàng mỗi ngày cho mỗi loại hình tìm kiếm |
| URL đã được lập chỉ mục chưa, lần thu thập dữ liệu gần nhất và URL chính tắc mà Google chọn | URL Inspection | Một URL mỗi lần gọi; 2.000 lần gọi mỗi ngày cho mỗi tài sản |
| Sơ đồ trang web của bạn và lỗi của chúng | Sitemaps | Đọc chỉ cần quyền chỉ đọc; gửi hoặc xóa cần toàn quyền |
| Các tài sản bạn có thể xem | Sites | Thêm hoặc xóa tài sản cần toàn quyền |
Một số dữ liệu trong Search Console không có API, nên không máy chủ MCP nào lấy được:
- Dữ liệu về Thông tin tổng quan do AI tạo và Chế độ AI. Google đã mở báo cáo hiệu suất AI tạo sinh cho mọi trang web vào ngày 31 tháng 8 năm 2026, nhưng tài liệu tham khảo API không có loại hình tìm kiếm hay giao diện tìm kiếm nào cho báo cáo này.
- Các tùy chọn báo cáo mới hơn. Loại hình tìm kiếm đa phương thức và bộ lọc truy vấn thương hiệu cũng không có trong tài liệu tham khảo API.
- Kiểm tra trang đang hoạt động. Công cụ kiểm tra URL báo cáo phiên bản nằm trong chỉ mục của Google. Tài liệu API viết: "bạn không thể kiểm tra khả năng lập chỉ mục của một URL đang hoạt động."
- Nút "Request indexing". Nút này chỉ có trong Search Console. Indexing API riêng của Google, mà một số máy chủ gọi đến, về mặt chính thức chỉ dành cho trang tin tuyển dụng và trang phát trực tiếp.
Ba cách kết nối Search Console với Claude, Claude Code hoặc Codex
| Cách | Thiết lập | Dữ liệu của bạn đi đâu | Chi phí |
|---|---|---|---|
| Máy chủ cộng đồng do bạn tự chạy, ví dụ mcp-gsc | Dự án Google Cloud, API, thông tin xác thực và một mục cấu hình | Từ máy tính của bạn đến Google | Miễn phí |
| Máy chủ được lưu trữ sẵn, ví dụ mcpsearchconsole.com | Đăng nhập bằng Google, dán URL máy chủ vào ứng dụng AI của bạn | Qua máy chủ của nhà cung cấp | Gói miễn phí, sau đó là gói đăng ký |
| Trình kết nối tích hợp trong Orkas | Nhấp Kết nối, đăng nhập bằng Google | Từ máy tính của bạn đến Google | Trình kết nối miễn phí |
- Máy chủ cộng đồng miễn phí và có nhiều tính năng nhất. Máy chủ phổ biến nhất, AminForou/mcp-gsc, có 2.151 sao trên GitHub vào ngày 9 tháng 11 năm 2026. Mã nguồn của nó có 21 công cụ, gồm so sánh giữa các khoảng thời gian, kiểm tra hàng loạt tối đa 10 URL và, nếu bạn cho phép, gửi sơ đồ trang web. Cái giá phải trả là khâu thiết lập: bạn phải tự tạo thông tin xác thực Google. Một người bình luận trên r/TechSEO gọi Google Cloud là "điểm vướng duy nhất".
- Máy chủ được lưu trữ sẵn là cách nhanh nhất để dùng trong claude.ai hoặc ChatGPT trên web. Đây là máy chủ từ xa, nên bạn thêm chúng bằng URL. Trung tâm trợ giúp của Claude cho biết trình kết nối tùy chỉnh hoạt động trên mọi gói, nhưng "Người dùng gói Free chỉ được dùng một trình kết nối tùy chỉnh." mcpsearchconsole.com niêm yết gói miễn phí với 40 lượt lấy dữ liệu mỗi tháng cho ba tài sản, sau đó là 4,99 € mỗi tháng chưa gồm VAT. Dữ liệu Search Console của bạn đi qua nhà cung cấp, vì vậy hãy đọc điều khoản quyền riêng tư của họ trước.
- Trình kết nối tích hợp giúp bạn bỏ qua khâu thiết lập Google Cloud. Trong Orkas, bạn đăng nhập bằng Google và trình kết nối chạy trên máy tính của bạn. Nó chỉ đọc và có bốn công cụ, ít hơn các máy chủ cộng đồng.
Tự chạy máy chủ cộng đồng
Các bước dưới đây theo README của mcp-gsc phiên bản 0.4.2 (ngày 6 tháng 11 năm 2026). Chúng tôi không tạo dự án Google Cloud cho hướng dẫn này, vì vậy hãy xem README trước khi bắt đầu.
- Tạo thông tin xác thực Google. Trong Google Cloud console, tạo một dự án, bật Search Console API và tạo mã ứng dụng khách OAuth thuộc loại "Desktop app". Tải tệp JSON của nó xuống. Nếu cần tự động hóa, hãy tạo tài khoản dịch vụ thay thế, rồi thêm địa chỉ email của tài khoản đó vào Search Console trong Cài đặt → Người dùng và quyền, với quyền "Toàn quyền".
- Cài uv. Cách README khuyên dùng là chạy máy chủ bằng
uvx, công cụ này tự lo phần Python cho bạn. Nếu không có uv, bạn cần Python 3.11 trở lên. - Thêm máy chủ vào tác tử của bạn. Trong Claude Code:
Trong Codex:claude mcp add --env GSC_OAUTH_CLIENT_SECRETS_FILE=/path/to/client_secrets.json --transport stdio gsc -- uvx mcp-search-console
Chúng tôi đã kiểm tra cả hai lệnh với Claude Code 2.1.311 và Codex CLI 0.163.0. Với Claude Desktop hoặc Cursor, README cung cấp cấu hình JSON có đường dẫn đầy đủ đếncodex mcp add gsc --env GSC_OAUTH_CLIENT_SECRETS_FILE=/path/to/client_secrets.json -- uvx mcp-search-consoleuvx, vì ứng dụng mở từ Dock hoặc menu Start có thể không tìm thấy nó. - Đăng nhập một lần. Lần đầu sử dụng, một cửa sổ trình duyệt sẽ mở ra để bạn đăng nhập Google. Từ bản 0.4.2, máy chủ chỉ xin quyền chỉ đọc, trừ khi bạn đặt
GSC_ALLOW_DESTRUCTIVE=true.
Một điểm mà các hướng dẫn cộng đồng không nhắc tới: nếu màn hình xin phép OAuth của bạn được đặt là "External" và để ở trạng thái "Testing", tài liệu OAuth của Google cho biết mã làm mới sẽ hết hạn sau 7 ngày. Bạn sẽ phải đăng nhập lại mỗi tuần. Để tránh điều này, hãy phát hành ứng dụng sang trạng thái production hoặc dùng tài khoản dịch vụ. Ứng dụng đã phát hành có thể hiện cảnh báo "ứng dụng chưa được xác minh"; Google cho phép bỏ qua cảnh báo này với ứng dụng dùng cho mục đích cá nhân có dưới 100 người dùng.
Kết nối Search Console trong Orkas
Orkas là ứng dụng máy tính cho macOS và Windows, nơi nhiều tác tử AI cùng làm việc trong một cuộc trò chuyện. Trình kết nối Google Search Console được tích hợp sẵn, nên bạn không cần dự án Google Cloud.
- Cài Orkas và đăng nhập. Tải Orkas cho macOS hoặc Windows. Tài khoản mới nhận 500 tín dụng miễn phí cho các mô hình tích hợp của Orkas, nên bạn không cần khóa API để bắt đầu.
- Mở Trình kết nối. Nhấp Trình kết nối ở thanh bên và tìm Google Search Console. Bộ lọc Dữ liệu hoặc ô tìm kiếm sẽ đưa bạn đến đó.
- Nhấp Kết nối và đăng nhập bằng Google. Nhấp Kết nối, dùng tài khoản Google có quyền xem tài sản của bạn và cho phép quyền chỉ đọc. Thẻ sẽ chuyển sang mục Đã kết nối.
- Yêu cầu những gì bạn cần. Trong cuộc trò chuyện, gõ @ và chọn trình kết nối Google Search Console, hoặc chỉ cần mô tả công việc. Tác tử sẽ liệt kê các tài sản của bạn trước, rồi truy vấn tài sản mà bạn chỉ định.
- Chỉ đọc. Orkas chỉ xin Google phạm vi
webmasters.readonly. Bốn công cụ lần lượt liệt kê tài sản, truy vấn dữ liệu hiệu suất, liệt kê sơ đồ trang web và kiểm tra một URL. Vì chúng chỉ đọc, Orkas chạy chúng mà không yêu cầu bạn phê duyệt từng lệnh gọi. Chúng không thể gửi sơ đồ trang web hay yêu cầu lập chỉ mục, và mỗi truy vấn trả về tối đa 25.000 hàng. - Truy vấn đi thẳng đến Google. Trình kết nối chạy trên máy tính của bạn và gọi trực tiếp Search Console API. Chỉ có bước đăng nhập Google và làm mới mã thông báo là đi qua máy chủ của Orkas, nơi lưu thông tin xác thực Google của ứng dụng.
- SeoGeoAgent và các tác tử lập trình của bạn đều dùng được. SeoGeoAgent, tác tử SEO tích hợp của Orkas, dùng số lượt nhấp, lượt hiển thị và vị trí thực tế của bạn trong các lần audit sau khi Search Console được kết nối. Nếu bạn đã cài Claude Code, Codex, OpenCode, Hermes hoặc OpenClaw và kết nối nó trong Orkas, công cụ đó sẽ truy cập trình kết nối qua cầu nối công cụ của Orkas mà không cần tự thiết lập MCP.
- Cần quyền ghi? Dùng Thêm máy chủ MCP trên trang Trình kết nối để thêm một máy chủ cộng đồng dưới dạng lệnh cục bộ. Orkas cũng có trình kết nối cho Bing Webmaster Tools.
Lần audit đầu tiên mà bạn có thể kiểm chứng
Một yêu cầu đầu tiên tốt sẽ hỏi những con số mà bạn có thể đối chiếu với Search Console trong một phút, và buộc tác tử nói rõ dữ liệu không bao quát những gì. Hãy thay tài sản và hai URL bằng của bạn:
Dùng trình kết nối Google Search Console cho sc-domain:example.com. Với 28 ngày gần nhất có dữ liệu đầy đủ: 1) tổng lượt nhấp và lượt hiển thị theo ngày, và các hàng truy vấn bao phủ bao nhiêu phần trong số đó; 2) các trang xếp hạng ở vị trí từ 5 đến 15, có ít nhất 100 lượt hiển thị và tỷ lệ nhấp dưới 2%, sắp xếp theo lượt hiển thị; 3) trạng thái lập chỉ mục của https://example.com/new-page/ và https://example.com/old-page/. Ghi khoảng thời gian trên mỗi bảng và đừng ước tính bất cứ điều gì mà dữ liệu không cho thấy.
Chúng tôi đã chạy yêu cầu này bằng Claude Code trong Orkas vào ngày 9 tháng 11 năm 2026, và cả bốn công cụ của trình kết nối đều hoạt động. Chúng tôi không công bố số liệu Search Console của chính trang web mình, nên kết quả dưới đây là một ví dụ giả lập: số liệu hư cấu của một cửa hàng giả định tại example.com, cho thấy một câu trả lời cẩn thận trông như thế nào và cách kiểm tra từng phần.
- Tổng theo ngày (dữ liệu giả lập): 3.480 lượt nhấp và 151.200 lượt hiển thị. Đây là những con số đáng tin cậy cho toàn bộ trang web. Để tự kiểm tra, hãy mở Báo cáo hiệu suất, chọn cùng khoảng ngày tùy chỉnh và cùng loại hình tìm kiếm, rồi so sánh các con số tổng. Chúng phải gần khớp nhau. Nếu chênh lệch lớn, thường là do tác tử đã cộng các hàng truy vấn hoặc hàng trang lại thay vì lấy tổng theo ngày.
- Các hàng truy vấn (dữ liệu giả lập): 642 hàng, bao phủ 1.670 lượt nhấp, tức 48% tổng số. Phần còn lại đến từ các truy vấn mà Google ẩn danh hóa, vốn không có hàng nào trong báo cáo lẫn API. Tỷ lệ như vậy là bình thường: Ahrefs nhận thấy các truy vấn ẩn danh chiếm 46,77% lưu lượng truy cập vào tháng 4 năm 2025, và còn cao hơn ở nhiều trang web. Một tác tử cộng các hàng truy vấn lại rồi gọi đó là lưu lượng truy cập của bạn có thể sai lệch tới một nửa.
- Các trang có CTR thấp (dữ liệu giả lập): 9 trang ở vị trí 5 đến 15, có ít nhất 100 lượt hiển thị và CTR dưới 2%. Trang lớn nhất trong số đó,
/blog/linen-care/, có 2.140 lượt hiển thị ở vị trí trung bình 6,8 và 21 lượt nhấp, tức CTR 1,0%. Đây là những tiêu đề và mô tả nên xem trước tiên. Nếu trang web của bạn phục vụ các ngôn ngữ ở địa chỉ kết thúc bằng?lang=, mỗi phiên bản sẽ có một hàng trang riêng, nên hãy yêu cầu nhóm chúng lại. - Kiểm tra URL (dữ liệu giả lập): trang cũ đã được lập chỉ mục, trang mới thì chưa.
https://example.com/old-page/, đăng vào tháng 9, có trạng thái "Submitted and indexed", lần thu thập dữ liệu gần nhất vào ngày 3 tháng 10.https://example.com/new-page/, đăng hai ngày trước khi kiểm tra, có trạng thái "Discovered - currently not indexed". Để kiểm tra, hãy dán cùng URL đó vào ô kiểm tra ở đầu Search Console.
Năm điểm dễ vấp phải
- Coi các hàng truy vấn là tổng lưu lượng truy cập. Hướng dẫn về dữ liệu hiệu suất của Google cho biết truy vấn ẩn danh không có hàng nào: "nếu bạn cộng số lượt nhấp của tất cả các hàng, bạn sẽ không có được số lượt nhấp bằng với tổng trên biểu đồ." Để lấy tổng, hãy yêu cầu dữ liệu theo ngày và không lọc theo truy vấn.
- So sánh tổng theo trang với tổng của cả trang web. Khi nhóm theo trang, mỗi URL xuất hiện trong một kết quả được tính riêng. Khi nhóm theo tài sản, một kết quả chỉ được tính một lần cho cả trang web. Vì vậy, tổng lượt hiển thị của các hàng trang có thể lớn hơn tổng của cả trang web.
- Quên độ trễ. Dữ liệu "thường có sau 2-3 ngày". API trả về dữ liệu đã hoàn tất trừ khi được yêu cầu lấy dữ liệu mới, nên "7 ngày qua" kết thúc vài ngày trước hôm nay.
- Dùng sai tên tài sản. Tài sản miền được viết là
sc-domain:example.com. Tài sản là URL có tiền tố là địa chỉ đầy đủ kèm dấu gạch chéo ở cuối, ví dụhttps://example.com/. Hãy để tác tử liệt kê các tài sản của bạn trước rồi sao chép đúng tên mà nó trả về. - Yêu cầu quá nhiều một lúc. Mỗi yêu cầu trả về tối đa 25.000 hàng, và bảng chia theo truy vấn và trang trong 16 tháng sẽ nhanh chóng chạm mức đó. Hãy yêu cầu bản tóm tắt, dùng bộ lọc hoặc khoảng thời gian ngắn hơn, và để tác tử tự xử lý các hàng thay vì dán tất cả vào cuộc trò chuyện.
Bạn nên chọn cách nào?
| Tình huống của bạn | Lựa chọn |
|---|---|
| Bạn dùng claude.ai hoặc ChatGPT trên trình duyệt | Máy chủ được lưu trữ sẵn, thêm bằng URL |
| Bạn muốn có mọi công cụ, kể cả gửi sơ đồ trang web, và không ngại Google Cloud | Máy chủ cộng đồng như mcp-gsc |
| Bạn muốn Claude Code, Codex và một tác tử SEO đọc Search Console mà không cần Google Cloud | Trình kết nối tích hợp của Orkas |
| Trang web của bạn quá lớn so với 25.000 hàng mỗi yêu cầu | Xuất dữ liệu hàng loạt của Search Console sang BigQuery, ngoài MCP |
Câu hỏi
Google có máy chủ MCP chính thức cho Search Console không?
Không, tính đến ngày 9 tháng 11 năm 2026 thì không có. Search Console không có trong danh sách máy chủ MCP chính thức của Google, cũng không có trong danh sách MCP của Google Cloud. Google có phát hành một máy chủ MCP cho Google Analytics, nhưng máy chủ này không bao gồm dữ liệu Search Console.
Search Console MCP có miễn phí không?
Search Console API miễn phí, các máy chủ cộng đồng như mcp-gsc và trình kết nối của Orkas cũng vậy. Máy chủ được lưu trữ sẵn thường có gói miễn phí giới hạn theo tháng và một gói trả phí. Tác tử AI mà bạn kết nối vẫn có chi phí riêng, chẳng hạn gói Claude hoặc tín dụng Orkas.
Máy chủ MCP có thể gửi sơ đồ trang web hoặc yêu cầu lập chỉ mục không?
Máy chủ có thể gửi hoặc xóa sơ đồ trang web nếu có toàn quyền trong Search Console, và một số máy chủ cộng đồng có hỗ trợ việc này. Search Console API không có chức năng "Request indexing", nên không máy chủ nào làm được điều đó cho các trang thông thường. Trình kết nối của Orkas chỉ đọc và không làm việc nào trong hai việc này.
Vì sao số liệu từ MCP không khớp với Search Console?
Thường là vì tác tử đã cộng các hàng truy vấn, vốn bỏ sót các truy vấn ẩn danh, hoặc trộn tổng theo trang với tổng theo tài sản. Hãy yêu cầu tổng theo ngày, không lọc theo truy vấn, với cùng các ngày và loại hình tìm kiếm như trong báo cáo. Khi đó, các con số tổng phải gần khớp nhau.
Có dùng được với Claude Code và Codex không?
Có. Thêm máy chủ cộng đồng bằng claude mcp add hoặc codex mcp add, hoặc thêm máy chủ được lưu trữ sẵn bằng URL. Trong Orkas, Claude Code và Codex dùng trình kết nối Search Console tích hợp thông qua cầu nối công cụ của Orkas, không cần thiết lập gì trong hai công cụ đó.
Agentic SEO là gì? trình bày bức tranh lớn hơn: một tác tử thực hiện công việc SEO trên dữ liệu thực, còn con người phê duyệt những gì được xuất bản.