Chuyển đến nội dung chính
Google Search Console · MCP
Google Search Console · MCP

Đư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
MCP Google Search Console bằng tiếng Việt | DigestSEO
mcp-gsc kết nối Google Search Console với Claude, ChatGPT, Cursor hoặc MCP client khác.

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

  1. Node.js ^22.18.0 / >=24.11.0 + npm
  2. 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.
  3. 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ộ.
  4. Đặ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

SETUP.md · npm v0.4.38

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ệ.

01get_capabilities

Liệt kê các khả năng hiện có và trạng thái xác thực.

02list_sites

Liệt kê những tài sản Search Console mà tài khoản đã kết nối truy cập được.

03query_search_analytics

Truy 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.

04inspect_url

Lấy báo cáo kiểm tra URL trực tiếp và chi tiết lập chỉ mục.

05list_sitemaps

Liệt kê các sitemap đã gửi kèm trạng thái thu thập và cảnh báo.

06add_site

Thêm một tài sản Search Console vào tài khoản đã kết nối.

07delete_site

Gỡ một tài sản Search Console khỏi tài khoản.

08submit_sitemap

Gửi một sitemap cho tài sản Search Console.

09delete_sitemap

Gỡ một sitemap đã gửi khỏi tài sản.

10get_sitemap

Lấy trạng thái chi tiết của một sitemap đã gửi.

11identify_quick_wins

Tìm những truy vấn nhiều lượt hiển thị đang xếp ở vị trí 8–20.

12detect_cannibalization

Tìm những truy vấn mà nhiều trang cùng cạnh tranh mức hiện diện.

13detect_content_decay

Xác định các trang sụt giảm lượt nhấp từ tìm kiếm nhiều nhất.

14request_indexing

Yê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.

15list_indexed_pages

Liệt kê những trang đã nhận được lượt hiển thị trong Search Console.

16compare_performance

So sánh lượt nhấp, lượt hiển thị, CTR và thứ hạng giữa các giai đoạn.

17weekly_digest

Tạ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.

~/digestseo · deploy
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 deploy

Cà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.