Claude Code Search Console: Chạy GSC Trong 3 Phút (2026)

Mình mất khoảng 90 phút mỗi tuần chỉ để mở 4 tab GSC khác nhau, xuất CSV, rồi compile lại trong Sheets trước khi thực sự bắt đầu phân tích. Sau khi cài Claude Code Search Console skill (claude-search-console) và chạy một lệnh /gsc-report sc-domain:ongboit.com, toàn bộ quá trình đó rút còn dưới 3 phút, kết quả là file HTML tự chứa với KPI cards, sparklines, phát hiện keyword cannibalization và action plan theo mức độ ưu tiên.

Bài này hướng dẫn từng bước cài đặt, xác thực OAuth, và cách tận dụng 11 slash command trong workflow Claude Code hàng ngày. Nếu bạn đang dùng Google Search Console thủ công, đây là upgrade đáng làm nhất trong tháng.

Skill Claude-Search-Console Làm Được Gì Cho Workflow SEO Của Bạn?

Skill Claude Code Search Console kết nối trực tiếp GSC API thay vì dùng dashboard theo kiểu truyền thống: mở tab Performance, mở tab Coverage, xuất từng CSV riêng, rồi compile lại, skill này kết nối trực tiếp Google Search Console API và thực hiện 11 truy vấn song song chỉ với một lệnh duy nhất.

Kết quả đầu ra là file HTML tự chứa, không cần server, mở thẳng trong trình duyệt. File này bao gồm KPI cards tổng quan, biểu đồ sparkline theo ngày, phân tích theo thiết bị và quốc gia, danh sách trang có vấn đề CTR, phát hiện keyword cannibalization và action plan phân tầng ưu tiên.

Đây không phải wrapper quanh dashboard mà là kết nối API thực sự. Dữ liệu được lấy trực tiếp từ Search Analytics API, URL Inspection API và Sitemaps API mà không qua bất kỳ trung gian nào.

Bạn Cần Chuẩn Bị Gì Trước Khi Cài Đặt?

Skill này yêu cầu một vài bước chuẩn bị liên quan đến Google Cloud, nhưng mỗi bước chỉ mất 2-3 phút và bạn chỉ cần làm một lần.

Nếu bạn chưa từng làm việc với Google Cloud API, phần tạo credentials sẽ mất khoảng 10 phút. Mình sẽ hướng dẫn chi tiết ở bước sau.

Làm Thế Nào Để Cài Đặt Claude Code Search Console Trong 15 Phút?

Skill là mã nguồn mở (MIT). Xem toàn bộ source code trên GitHub: github.com/thenguyenvn90/claude-search-console.

Quá trình gồm 4 bước: tải skill, cài CLI, tạo GCP credentials và xác thực. Toàn bộ chỉ mất 15-20 phút lần đầu.

Bước 1: Tải skill về thư mục Claude Code

# Clone repo (KHÔNG clone thẳng vào ~/.claude/skills)
git clone https://github.com/thenguyenvn90/claude-search-console.git
cd claude-search-console

# Cài 11 skill vào ~/.claude/skills (install.sh tự copy đúng chỗ)
bash install.sh            # macOS / Linux
# .\install.ps1            # Windows PowerShell

Bước 2: Cài CLI tool

# Cài CLI `gsc` global (cần Python 3.11+)
pip install .              # hoặc: uv tool install .

# Kiểm tra (LƯU Ý: dùng --help, KHÔNG có cờ --version)
gsc --help
gsc sites list

💡 Mẹo property: Chạy gsc sites list để biết site verify dạng Domain (sc-domain:site.com) hay URL-prefix (https://site.com/), truy vấn sai dạng sẽ trả về 0 dòng. Gặp No auth profile found thì chạy lại gsc auth login --client-secrets <path>.

Bước 3: Tạo Google Cloud credentials

Mở console.cloud.google.com, tạo project mới (hoặc dùng project hiện có), sau đó:

1. Vào APIs & Services → Library, tìm “Google Search Console API”, bấm Enable
2. Vào APIs & Services → Credentials, bấm “Create Credentials” → “OAuth 2.0 Client IDs”
3. Chọn Application type: Desktop app, đặt tên bất kỳ
4. Download file JSON, lưu vào máy (ví dụ: ~/gsc-credentials.json)

Bước 4: Xác thực với GSC

# Xác thực lần đầu (mở browser tự động)
gsc auth login --client-secrets ~/gsc-credentials.json

# Kiểm tra trạng thái
gsc auth status

# Xem danh sách sites đã xác minh
gsc sites list

Sau lệnh auth login, trình duyệt sẽ mở trang Google để cấp quyền. Sau khi đồng ý, credentials được lưu tự động vào ~/.config/gsc/config.yaml. Những lần sau không cần xác thực lại.

Checkpoint: Lệnh gsc sites list trả về danh sách domain của bạn là setup thành công.

Làm Thế Nào Để Chạy Báo Cáo GSC Đầu Tiên?

Sau khi setup xong, lệnh đầu tiên cần chạy là /gsc-report trong Claude Code. Đây là lệnh tổng hợp chạy 11 truy vấn song song và tạo báo cáo HTML hoàn chỉnh.

# Báo cáo 28 ngày gần nhất (mặc định)
/gsc-report sc-domain:yourdomain.com

# Báo cáo 7 ngày
/gsc-report sc-domain:yourdomain.com 7

# Báo cáo 90 ngày
/gsc-report sc-domain:yourdomain.com 90

# Khoảng thời gian tùy chỉnh
/gsc-report sc-domain:yourdomain.com 2026-03-01 2026-04-08

# Nếu dùng URL property thay vì domain property
/gsc-report https://www.yourdomain.com/

Báo cáo HTML được lưu vào thư mục hiện tại với tên như gsc-report-yourdomain.com-2026-04-11.html. Mở file này trong trình duyệt để xem toàn bộ phân tích: tổng clicks/impressions/CTR/position, biểu đồ trend theo ngày, phân tích thiết bị, quốc gia, danh sách trang có vấn đề và action plan phân tầng.

11 Slash Command Và Khi Nào Dùng Mỗi Lệnh?

Ngoài /gsc-report tổng hợp, skill còn có 10 lệnh chuyên biệt để phân tích từng khía cạnh riêng lẻ. Dùng các lệnh này khi cần dig sâu vào một vấn đề cụ thể mà không cần chạy toàn bộ báo cáo.

Trong thực tế mình dùng /gsc-opportunities nhiều nhất sau /gsc-report. Lệnh này trả về danh sách trang theo thứ tự ưu tiên: trang có impressions cao nhưng CTR thấp, vị trí 4-10 có thể push lên top 3, nhanh hơn nhiều so với lọc thủ công trên dashboard.

Skill Này Khác Gì So Với Dùng MCP Server Cho GSC?

Câu hỏi về Claude Code Search Console skill vs MCP mình nhận được khá nhiều, nhất là với người đã quen với MCP. Ngắn gọn: hai cách tiếp cận khác nhau ở kiến trúc, không phải chức năng. Nếu bạn chưa rõ MCP là gì, đây là điểm khác biệt chính.

Nếu bạn muốn hỏi Claude “keyword nào đang drop trong 7 ngày qua?” theo dạng chat, MCP tiện hơn. Nếu bạn cần báo cáo có thể chia sẻ, in ra, hoặc lưu lại để so sánh sau này, skill phù hợp hơn. Nhiều người dùng cả hai: skill để báo cáo định kỳ, MCP để phân tích ad hoc.

gsc Skill Đóng Vai Trò Gì Trong claude-growth?

claude-search-console không phải skill solo, nó là lớp dữ liệu (data layer) trong claude-growth, bộ kit SEO + content mình dùng để audit và sản xuất nội dung. Mọi phân tích đều cần một thứ giống nhau: số liệu Google Search Console thật (clicks, impressions, position, CTR) thay vì phỏng đoán. Đó chính là việc của gsc skill.

gsc cấp dữ liệu nền cho 2 pipeline chính của claude-growth:

Workflow điển hình:

1. Chạy /gsc-report sc-domain:ongboit.com 7 → file HTML audit tuần trước, đọc mục Opportunities.
2. Chọn 1 keyword striking-distance (position 11-20, impressions cao) qua /gsc-opportunities.
3. Audit nội dung liên quan bằng /blog-audit-pipeline (decay + gap), hoặc audit kỹ thuật site bằng /seo-pipeline.
4. Refresh hoặc viết mới theo action plan, rồi /gsc-inspect [URL] xác nhận đã indexed.
5. Sau ~14 ngày, chạy /gsc-compare để đo position delta và verify cải thiện.

gsc skill là MIT, chạy local, không tính phí per-request. Vai trò của nó trong claude-growth: biến mọi audit từ “dựa trên phỏng đoán” thành “dựa trên số liệu Search Console thật”, nền tảng cho mọi quyết định refresh hay viết mới.

→ Xem cách claude-growth audit toàn site trong một lệnh

Tích Hợp Vào Workflow Claude Code Hàng Ngày Như Thế Nào?

Điểm mạnh nhất của Claude Code Search Console skill không phải ở lệnh đơn lẻ mà ở khả năng kết hợp với các công cụ Claude Code khác. Mình thường tích hợp nó theo hai pattern.

Pattern 1: Weekly SEO check tự động. Thêm vào CLAUDE.md của project:

# Trong CLAUDE.md
## Weekly SEO Review (mỗi thứ Hai)
1. Chạy /gsc-report sc-domain:yourdomain.com 7
2. Mở báo cáo HTML, xem phần Opportunities
3. Chạy /gsc-opportunities nếu cần drill down
4. Tạo task list từ action plan trong báo cáo

Pattern 2: Kết hợp với Claude Code SEO skill. Sau khi /gsc-report xác định trang cần tối ưu, dùng SEO skill để phân tích on-page và đề xuất cụ thể. Hai skill bổ sung cho nhau: GSC skill cho biết trang nào có vấn đề, SEO skill cho biết cần sửa gì.

Nếu bạn đang xây toolkit Claude Code, bài về Claude Code Google Workspace cũng đáng đọc để hiểu cách kết nối với Google Analytics và các Google API khác trong cùng một workflow.

Tất cả skills Claude Code, bao gồm skill GSC này, được tổng hợp trong lộ trình học Claude Code, xem để biết skill nào nên ưu tiên theo thứ tự.

Câu Hỏi Thường Gặp

Skill này có miễn phí không?

Skill Claude Code Search Console (claude-search-console) là open source, hoàn toàn miễn phí tại GitHub. Chi phí duy nhất là Google Cloud Project, nhưng Search Console API nằm trong free tier của Google Cloud với hạn mức rất cao, hầu như không có site thông thường nào chạm giới hạn đó.

Cần biết lập trình để dùng không?

Không cần viết code để dùng Claude Code Search Console. Bạn chỉ cần chạy lệnh terminal khi cài đặt (4 lệnh một lần) và dùng slash command trong Claude Code về sau. Phần phức tạp nhất là tạo OAuth credentials trên Google Cloud, mất khoảng 10 phút và chỉ làm một lần.

Dữ liệu GSC được lưu ở đâu sau khi chạy?

Dữ liệu không được lưu lại sau mỗi session, ngoại trừ file HTML báo cáo được lưu vào thư mục bạn chạy lệnh. Credentials OAuth được lưu cục bộ tại ~/.config/gsc/config.yaml trên máy của bạn, không gửi lên bất kỳ server nào.

Lệnh /gsc-report mất bao lâu để chạy xong?

Tùy vào số lượng URL trong site. Với site dưới 100 URL, thường mất 1-3 phút. Site có hàng nghìn URL có thể mất 5-10 phút vì URL Inspection API được gọi cho từng trang. Claude Code sẽ hiển thị progress trong khi chạy.

Có thể dùng với nhiều site khác nhau không?

Có. Lệnh gsc auth add-profile tensite --client-secrets path/to/secrets.json cho phép lưu nhiều profile. Khi chạy báo cáo, thêm --profile tensite để chỉ định, hoặc để trống nếu chỉ có một site.

Skill này khác gì so với đọc file CSV xuất từ GSC?

CSV từ GSC bị giới hạn ở 1,000 rows và chỉ xuất được một dimension mỗi lần. Skill này lấy tối đa 25,000 rows qua API, kết hợp nhiều dimension, chạy URL Inspection cho từng trang và tự tổng hợp thành action plan. CSV cần compile thủ công, báo cáo HTML từ skill đã sẵn sàng để đọc và chia sẻ.

Cần Claude Code plan nào để dùng?

Pro ($20/tháng) đủ dùng cho hầu hết trường hợp. Skill chạy CLI Python cục bộ, Claude Code chỉ đóng vai trò điều phối. Context window không phải vấn đề vì skill tự xử lý việc lấy và tổng hợp dữ liệu, chỉ trả về kết quả tóm tắt cho Claude. Tìm hiểu thêm về Claude Code là gì để hiểu rõ hơn về công cụ bạn đang dùng với Claude Code Search Console skill này.