Đưa dữ liệu Search Console vào trợ lý của bạn.
mcp-gsc kết nối Google Search Console với Claude, ChatGPT, Cursor hoặc MCP client khác.
- Chế độ đề xuất
- Read-only
- Xác thực
- Google OAuth
- Cách chạy
- npm / Worker
- Giấy phép
- MIT
npm · Google Search Console MCP
Cài GSC MCP cục bộ bằng npm
npm khởi động máy chủ Streamable HTTP trên máy của bạn. Cần cấu hình Google OAuth và thông tin xác thực trước khi chạy; đây không phải kết nối chỉ với một lần nhấp.
1. Chuẩn bị quyền truy cập Google
Node.js ^22.18.0 / >=24.11.0+npm- Dùng tài khoản Google có quyền truy cập thuộc tính Search Console cần phân tích.
- Tạo OAuth client trên Google Cloud, bật API cần thiết và đăng ký chính xác URI chuyển hướng cục bộ.
- Đặt ba biến môi trường này theo hướng dẫn đúng phiên bản. TOKEN_ENCRYPTION_KEY phải là base64 hợp lệ của đúng 32 byte ngẫu nhiên.
GOOGLE_CLIENT_IDGOOGLE_CLIENT_SECRETTOKEN_ENCRYPTION_KEY
Đăng ký chính xác URI này trong Google Cloud. Máy chủ, cổng và đường dẫn phải khớp; localhost không giống 127.0.0.1.
http://127.0.0.1:8080/google/callback localhost ≠ 127.0.0.1
2. Khởi chạy máy chủ cục bộ
Sau khi cấu hình thông tin xác thực trong terminal, chạy gói npm. Nếu chỉ phân tích, hãy chọn thiết lập chỉ đọc phù hợp với shell.
Mặc định launcher dùng readwrite. Để chỉ phân tích, chọn readonly trước khi cấp quyền Google; các công cụ ghi sẽ không được đăng ký.
Lệnh Bash / zsh
export GSC_ACCESS_MODE=readonly
npx -y @digestseo/mcp-gsc PowerShell
$env:GSC_ACCESS_MODE = 'readonly'
npx -y @digestseo/mcp-gsc Điểm cuối cục bộ · Streamable HTTP
http://127.0.0.1:8080/mcp 3. Kết nối MCP client
Giữ launcher đang chạy và kết nối client trên cùng máy với endpoint Streamable HTTP cục bộ, không phải stdio.
Claude Code
claude mcp add --transport http gsc http://127.0.0.1:8080/mcp Kết nối Codex CLI / IDE
codex mcp add gsc --url http://127.0.0.1:8080/mcp Cursor
Trong Cursor, thêm máy chủ MCP Streamable HTTP tên gsc với URL này (Cursor chạy cục bộ).
http://127.0.0.1:8080/mcp ChatGPT / Claude.ai
ChatGPT và Claude trên đám mây không thể truy cập 127.0.0.1 trên máy của bạn. Dùng Worker HTTPS riêng hoặc đường hầm MCP bảo mật được hỗ trợ, tùy quyền của tài khoản.
Cần truy cập từ xa?Cần truy cập từ xa?
Tự triển khai trên Cloudflare Workers vẫn được hỗ trợ, nhưng cần cấu hình Cloudflare và Google OAuth. Ví dụ bên dưới dùng Bash; xem toàn bộ các bước trong SETUP.md.
Giới thiệu sản phẩm
mcp-gsc là gì?
Chạy gói npm qua HTTP loopback trên máy cục bộ hoặc tự triển khai Cloudflare Worker để có endpoint HTTPS từ xa. Cả hai đều dùng Google OAuth.
Launcher cục bộ mặc định lưu trạng thái phiên đã mã hóa tại ~/.mcp-gsc/state; Worker dùng bộ nhớ của tài khoản Cloudflare của bạn. Đây không phải dịch vụ kết nối do DigestSEO quản lý.
Nhập báo cáo Web: multimodal để xem hiệu suất của từng trang. Công cụ không nhận diện hoặc nén hình ảnh. Phân tích Google Lens và tìm kiếm đa phương thức.
So sánh khả năng được tìm thấy qua Google của các tài khoản bạn được phép quản lý, không phải lượt thích hoặc lượt xem trong ứng dụng. So sánh hiệu suất nội dung mạng xã hội trên Google.
Công cụ
Chức năng của máy chủ
Công cụ phân tích tìm kiếm, kiểm tra URL, sitemap, lập chỉ mục và chẩn đoán SEO.
Danh sách bao gồm công cụ ghi tùy chọn. GSC_ACCESS_MODE=readonly chỉ cung cấp công cụ không thay đổi dữ liệu; Google giới hạn Indexing API cho một số loại nội dung hợp lệ.
get_capabilitiesLiệt kê các khả năng hiện có và trạng thái xác thực.
list_sitesLiệt kê những tài sản Search Console mà tài khoản đã kết nối truy cập được.
query_search_analyticsTruy vấn lượt nhấp, lượt hiển thị, CTR và thứ hạng trong khoảng thời gian tùy chọn.
inspect_urlLấy báo cáo kiểm tra URL trực tiếp và chi tiết lập chỉ mục.
list_sitemapsLiệt kê các sitemap đã gửi kèm trạng thái thu thập và cảnh báo.
add_siteThêm một tài sản Search Console vào tài khoản đã kết nối.
delete_siteGỡ một tài sản Search Console khỏi tài khoản.
submit_sitemapGửi một sitemap cho tài sản Search Console.
delete_sitemapGỡ một sitemap đã gửi khỏi tài sản.
get_sitemapLấy trạng thái chi tiết của một sitemap đã gửi.
identify_quick_winsTìm những truy vấn nhiều lượt hiển thị đang xếp ở vị trí 8–20.
detect_cannibalizationTìm những truy vấn mà nhiều trang cùng cạnh tranh mức hiện diện.
detect_content_decayXác định các trang sụt giảm lượt nhấp từ tìm kiếm nhiều nhất.
request_indexingYêu cầu lập chỉ mục qua Indexing API của Google. Hiện Google giới hạn API này cho các trang có dữ liệu có cấu trúc JobPosting hoặc trang phát trực tiếp có BroadcastEvent bên trong VideoObject. API này không dùng để gửi trang web thông thường.
list_indexed_pagesLiệt kê những trang đã nhận được lượt hiển thị trong Search Console.
compare_performanceSo sánh lượt nhấp, lượt hiển thị, CTR và thứ hạng giữa các giai đoạn.
weekly_digestTạo báo cáo SEO hằng tuần bằng ngôn ngữ dễ hiểu.
Triển khai
Cần truy cập từ xa?
Tự triển khai trên Cloudflare Workers vẫn được hỗ trợ, nhưng cần cấu hình Cloudflare và Google OAuth. Ví dụ bên dưới dùng Bash; xem toàn bộ các bước trong SETUP.md.
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 deployCài GSC MCP cục bộ bằng npm
Mã nguồn mở, tự lưu trữ. Làm theo hướng dẫn Google OAuth hoặc triển khai Worker của riêng bạn.