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 Trong Antigravity

1. Mở Agent panel (sidebar)
2. Click ⋯ → Manage MCP Servers
3. Click View raw config
4. Thêm:

{
  "mcpServers": {
    "search-console": {
      "command": "npx",
      "args": ["-y", "search-console-mcp"]
    }
  }
}

5. Save → Quay lại Manage MCP Servers → Click Refresh

Bước 3: Thêm Bing (Tùy chọn)

{
  "mcpServers": {
    "search-console": {
      "command": "npx",
      "args": ["-y", "search-console-mcp"],
      "env": {
        "BING_API_KEY": "YOUR_BING_API_KEY"
      }
    }
  }
}

Lấy API key tại: Bing Webmaster Tools Settings. Mỗi user có key riêng.

Bước 4: Thêm GA4 (Tùy chọn)

npx search-console-mcp setup --engine=ga4

Wizard sẽ:

1. Yêu cầu đường dẫn Service Account JSON
2. Liệt kê GA4 properties khả dụng
3. Chọn property phù hợp

⚠️ GA4 yêu cầu Service Account (không dùng OAuth). Email SA phải được thêm làm Viewer trong GA4 Admin → Property Access Management.

Config đầy đủ (GSC + Bing + GA4):

{
  "mcpServers": {
    "search-console": {
      "command": "npx",
      "args": ["-y", "search-console-mcp"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "C:\\Users\\YOU\\.config\\seo-kit\\service_account.json",
        "BING_API_KEY": "YOUR_BING_API_KEY"
      }
    }
  }
}

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_* — OAuth được quản lý tự động bởi npx search-console-mcp setup và lưu trong OS Keychain.

Xử Lý Sự Cố

Rate Limits

Kỹ Năng Liên Quan