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.
TL;DR
claude-search-console là skill cho Claude Code tích hợp trực tiếp Google Search Console API qua 3 endpoint: Search Analytics, URL Inspection và Sitemaps. Một lệnh /gsc-report sc-domain:yourdomain.com chạy 11 truy vấn song song, kiểm tra toàn bộ URL qua URL Inspection API và xuất ra file HTML tự chứa với KPI cards, sparklines, phát hiện cannibalization, cơ hội CTR và action plan phân tầng ưu tiên. Khác với MCP server, skill này không cần Node.js daemon và báo cáo HTML có thể chia sẻ trực tiếp. Yêu cầu: Python 3.11+, uv, Google Cloud Project với Search Console API bật. Xem danh sách skills hữu ích nhất nếu bạn đang xây toolkit Claude Code.
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?
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 vào thư mục skills của Claude Code
git clone https://github.com/thenguyenvn90/claude-search-console ~/.claude/skills/gsc
# Hoặc chỉ lấy folder skills nếu không muốn clone toàn bộ
cd ~/.claude/skills
git clone --depth=1 https://github.com/thenguyenvn90/claude-search-console gscBước 2: Cài CLI tool
cd ~/.claude/skills/gsc
uv pip install -e .
# Kiểm tra cài đặt thành công
gsc --versionBướ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 đó:
- Vào APIs & Services → Library, tìm “Google Search Console API”, bấm Enable
- Vào APIs & Services → Credentials, bấm “Create Credentials” → “OAuth 2.0 Client IDs”
- Chọn Application type: Desktop app, đặt tên bất kỳ
- 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 listSau 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/sc-domain:example.com (không có https). URL property dùng https://www.example.com/ (có trailing slash). Dùng sai format sẽ báo lỗi 404 hoặc trả về dữ liệu rỗng.
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.
Tích Hợp Với Claude SEO + Claude Blog: SEO Stack Hoàn Chỉnh Như Thế Nào?
Claude Code Search Console không phải skill solo, hoạt động tốt nhất khi kết hợp với hệ sinh thái AgriciDaniel ecosystem, bộ 3 skill production-grade trên ongboit hiện tại:
| Skill | Vai trò | Stars + Forks | Tích hợp với gsc-* ra sao |
|---|---|---|---|
| claude-seo v1.9.9 (final 1.x patch) | SEO audit: technical, E-E-A-T, schema, GEO/AEO, local SEO, semantic clustering, drift monitoring | 6,934 ★ + 1,060 forks | claude-seo gọi gsc-cli qua MCP integration để pull dữ liệu thật (clicks, impressions, position) thay vì assume hoặc scrape. Combo cover audit + data trong 1 workflow. |
| claude-blog v1.9.1 (5-Gate Delivery Contract) | Writing 30 sub-skills: brief, outline, write, schema, AI citation, multilingual | 803 ★ + 167 forks | claude-blog dùng /blog google sub-skill để pull GSC data làm research grounding cho mỗi bài viết. Khắc phục pain “viết blog không biết audience đang search gì”. |
| gsc-* skills (bài này) | Google Search Console CLI + 11 skill phân tích | v0.1.0 (early, MIT) | Source-of-truth cho data. Hai skill trên chỉ “đẹp” khi có data ground truth từ GSC. |
Workflow ecosystem điển hình trên ongboit:
- Monday morning: chạy
/gsc-report sc-domain:ongboit.com 7generate HTML audit cho tuần trước. Đọc Opportunities section. - Pick 1 striking-distance keyword (position 11-20 + impressions cao): dùng
/gsc-opportunitiesdrill down query nào có CTR thấp nhất. - Generate brief với claude-blog:
/blog brief [keyword]+ flag--gsc-sourceđể skill auto-load top queries từgsc-clilàm research base. - Audit bài hiện tại với claude-seo:
/seo page https://ongboit.com/[old-slug]/kiểm tra gap với bài rank trên SERP. - Refresh hoặc viết mới:
/blog rewrite [old-slug](nếu refresh) hoặc/blog write [keyword](nếu mới). - Verify after publish: chạy
/gsc-inspect [new-URL]đảm bảo indexed, sau đó/gsc-comparesau 14 ngày so position delta.
Bộ 3 skill cùng MIT license, chạy local, không charge per-request. Solo blogger có production stack tốt hơn agency $5-10K/tháng theo đo trên ongboit từ tháng 2/2026.
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áoPattern 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ự.
📈 Cluster SEO của ongboit chạy chính nhờ community này
Mình đã join AI Marketing Hub Pro với Daniel Agrici từ rất sớm. claude-seo + Search Console workflow mà ongboit đang dùng đa số học được trong group. Trong tất cả các community SEO marketing với n8n + Claude Code mình từng tham gia, đây là chỗ mình active và contribute nhiều nhất – peer review từ pro member chỉ ra gap mình tự miss.
Skill SEO ship liên tục, pro member access trước public. Nếu serious về AI-search SEO 2026, đây là community nên đầu 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.
