Search Console MCP

Tích hợp search-console-mcp — MCP server cung cấp 30+ tools cho Google Search Console, Bing Webmaster Tools, và Google Analytics 4.

📌 Đây là extension optional (Tier 1+). Tất cả chức năng GSC cốt lõi đều có sẵn qua Python scripts. MCP bổ sung thêm SEO Intelligence, Bing, GA4, và Cross-Platform analysis.

Tổng Quan

Cài Đặt

Bước 1: Setup OAuth

npx search-console-mcp setup

Lệnh này sẽ:

1. Khởi động server cục bộ
2. Mở trình duyệt → trang xác thực Google
3. Cấp quyền truy cập Search Console
4. Tự động lưu token vào OS Keychain

🔒 Token được lưu trong trình quản lý credentials của hệ điều hành (macOS Keychain, Windows Credential Manager, Linux Secret Service). Fallback: mã hóa AES-256-GCM.

Bước 2: Cấu Hình Biến Môi Trường (.env)

Kể từ phiên bản v3.9.x, bạn không cần phải sửa cấu hình JSON thô của Antigravity nữa. Mọi thông tin xác thực đều được đọc trực tiếp từ tệp .env ở thư mục gốc của bạn.

Mở tệp .env trong thư mục dự án và thiết lập các trường sau:

# Google Search Console Service Account Key (Chuỗi JSON của file key hoặc đường dẫn tuyệt đối đến file JSON)
# Ví dụ 1: GSC_SERVICE_ACCOUNT_KEY={"type": "service_account", ...}
# Ví dụ 2: GSC_SERVICE_ACCOUNT_KEY=C:\path\to\service_account.json
GSC_SERVICE_ACCOUNT_KEY=

# Bing Webmaster Tools API Key (Lấy tại Bing Webmaster Tools Settings -> API)
BING_API_KEY=

# Google Analytics 4 Property ID (Bắt buộc nếu dùng GA4 tools)
GA_PROPERTY_ID=

Bước 3: Cơ chế Nạp Cấu Hình Tự Động

Tệp cấu hình MCP của hệ thống nằm tại .agents/mcp_config.json đã được cấu hình sẵn với nội dung động:

{
  "mcpServers": {
    "search-console": {
      "command": "npx",
      "args": [
        "-y",
        "@nicholasharrigan/search-console-mcp@latest"
      ],
      "description": "Google Search Console, Bing Webmaster Tools, and GA4 analytics MCP server",
      "required": false,
      "env": {
        "GSC_SERVICE_ACCOUNT_KEY": "${GSC_SERVICE_ACCOUNT_KEY}",
        "BING_API_KEY": "${BING_API_KEY}",
        "GA_PROPERTY_ID": "${GA_PROPERTY_ID}"
      }
    }
  }
}

Antigravity sẽ tự động phát hiện và thay thế các placeholder ${GSC_SERVICE_ACCOUNT_KEY}, ${BING_API_KEY}, và ${GA_PROPERTY_ID} bằng giá trị bạn đã điền trong .env khi khởi chạy, giúp bảo vệ an toàn thông tin nhạy cảm của bạn không bị lộ ra bên ngoài.

Xác Nhận Cài Đặt

npx search-console-mcp accounts list

Kết quả mẫu:

✓ Google: seo@yourcompany.com (3 properties)
✓ Google: personal@gmail.com (2 properties)
✓ Bing: bing-user@outlook.com (1 site)
✓ GA4: seo-kit@project.iam.gserviceaccount.com (1 property)

Danh Sách 30+ MCP Tools

Google Search Console (7 tools)

SEO Intelligence (6 tools) — chỉ có qua MCP

Bing Webmaster Tools (7 tools) — chỉ có qua MCP

Google Analytics 4 (6 tools)

Cross-Platform Intelligence (5 tools) — chỉ có qua MCP

Script vs MCP — Khi Nào Dùng Cái Nào?

Quy tắc tag dữ liệu: MCP data → [VERIFIED:GSC-MCP], Script data → [VERIFIED:GSC-Script]. Cả hai đều là nguồn xác thực.

Multi-Account

Thêm Tài Khoản

# Chạy setup cho mỗi tài khoản Google
npx search-console-mcp setup

Mỗi lần chạy sẽ mở trình duyệt cho tài khoản Google mới. Server tự động chọn tài khoản đúng dựa trên siteUrl bạn truy vấn.

Quản Lý Tài Khoản

# Liệt kê tài khoản
npx search-console-mcp accounts list

# Đăng xuất tài khoản mặc định
npx search-console-mcp logout

# Đăng xuất tài khoản cụ thể
npx search-console-mcp logout user@gmail.com

Agency Workflow

Sau khi login + config Bing:

Account: seo@agency.com
  Google: sc-domain:client-a.com, sc-domain:client-b.com
  Bing: client-a.com, client-b.com
  GA4: properties/123456789 (client-a.com)

Truy vấn trực tiếp bất kỳ property nào — auto-routing tự chọn tài khoản đúng.

Thêm Domain Mới

1. Verify domain trong Google Search Console
2. (Tùy chọn) Thêm vào Bing Webmaster Tools
3. MCP tự phát hiện — không cần thay đổi config

Biến Môi Trường

Không cần GSC_OAUTH_* hay GOOGLE_APPLICATION_CREDENTIALS thủ công nữa — OAuth và Service Account được quản lý tích hợp, tự động nạp qua tệp .env ở thư mục gốc của bạn.

Xử Lý Sự Cố

Rate Limits

Kỹ Năng Liên Quan