Claude SEO: Chạy rà soát SEO toàn site ngay trong Claude Code

Một lần rà soát SEO đàng hoàng thường chỉ có hai cách: thuê agency vài tuần, hoặc mua một dashboard rồi vẫn ngồi hàng giờ đọc cảnh báo. Nếu bạn đang làm việc trong Claude Code thì đã có sẵn một agent khá mạnh ngay trong terminal, chỉ là nó chưa biết thẻ canonical, file llms.txt hay một trích dẫn AI Overview cần đúng những gì.

Claude SEO xử lý đúng chỗ đó. Đây là plugin mã nguồn mở theo giấy phép MIT của Agrici Daniel; cài vào Claude Code là có thêm 26 sub-skill, 19 agent chuyên môn và 30 lệnh. Bạn đưa một URL, nó chạy rà soát toàn site rồi trả về kế hoạch hành động ưu tiên, thay vì một đống cảnh báo đỏ.

1. Bản đồ lệnh

Plugin chia 30 lệnh thành sáu nhóm. Phần lớn công việc hằng ngày bắt đầu bằng một lệnh rà soát, rồi mới đi sâu vào từng nhóm:

Nhóm	Các lệnh	Kết quả nhận được
Rà soát và lập kế hoạch	`/seo setup`, `/seo doctor`, `/seo audit`, `/seo page`, `/seo plan`	Thiết lập môi trường, quét toàn site, phân tích sâu một trang, chiến lược theo loại hình kinh doanh
SEO kỹ thuật	`/seo technical`, `/seo sitemap`, `/seo images`, `/seo hreflang`, `/seo programmatic`, `/seo google`, `/seo drift`	Sửa lỗi crawl và index, sitemap, đa ngôn ngữ, Google API, theo dõi thay đổi
Nội dung và E-E-A-T	`/seo content`, `/seo content-brief`, `/seo cluster`, `/seo sxo`, `/seo flow`, `/seo competitor-pages`	Đánh giá chất lượng, đề cương, cụm từ khóa, chân dung người dùng theo kiểu tìm kiếm
Schema và AI search	`/seo schema`, `/seo geo`, `/seo agentic`	Sinh Schema.org, mức sẵn sàng cho AI Overview, quyền truy cập của agent và `llms.txt`
Local và thương mại	`/seo local`, `/seo maps`, `/seo backlinks`, `/seo ecommerce`	Google Business Profile, map pack, hồ sơ backlink, trang sản phẩm
Tiện ích mở rộng	`/seo image-gen`, `/seo seranking`, `/seo profound`, `/seo bing`, `/seo unlighthouse`	Nguồn dữ liệu bên ngoài hoặc dịch vụ trả phí, không bắt buộc

Gõ riêng /seo mà không kèm tham số là danh sách đầy đủ hiện ra ngay trong terminal.

Mỗi agent trong 19 agent phụ trách một mảng hẹp: trưởng nhóm kỹ thuật, biên tập nội dung, kỹ sư schema, kiến trúc sư sitemap, kỹ sư hiệu năng, người lo mảng AI search, local, backlink, thương mại điện tử, và vài vai trò nữa. Năm agent chạy Opus cho những phần cần phán đoán, số còn lại chạy Sonnet, nên rà soát một trang tốn ít hơn nhiều so với quét toàn site.

2. Một lần rà soát diễn ra thế nào

Cách nó chạy cũng dễ nắm: một lệnh, các agent tỏa ra chạy song song, rồi trả về một kế hoạch đã xếp hạng.

Luồng rà soát SEO từ URL đích đến kế hoạch hành động ưu tiên

Chạy /seo audit https://example.com thì các bước diễn ra như sau:

Nhận diện loại site. Plugin xác định đang rà soát một sản phẩm SaaS, doanh nghiệp local, cửa hàng thương mại điện tử, trang báo hay agency, rồi điều chỉnh bộ kiểm tra cho phù hợp.
Chia việc cho cả đội. Tối đa 17 agent chạy cùng lúc: kỹ thuật, nội dung, schema, hiệu năng, kiểm tra giao diện, AI search và các mảng khác. Mỗi agent chỉ xem phần của mình nên không giẫm chân nhau.
Chấm điểm trước khi báo cáo. Phát hiện được xếp theo mức tác động và mức phụ thuộc, không đổ ra theo thứ tự crawl. Mỗi khuyến nghị nói rõ nó dựa trên cái gì và kiểm tra lại bằng cách nào.
Ghi file để bạn giữ. Kết quả lưu thành Markdown, JSON, và PDF nếu cần, tất cả đều nằm trên máy bạn.

Chạy thật trên chính site này

Ảnh dưới đây là kết quả chạy /seo audit https://www.util-kits.io.vn/en trên util-kits.io.vn. Báo cáo cho 79/100 trên bảy nhóm có trọng số, và ghi rõ là môi trường plugin chưa được thiết lập nên các kiểm tra chạy trên HTML thô thay vì trình duyệt headless.

Báo cáo SEO Audit cho util-kits.io.vn với điểm sức khỏe 79/100, bảy nhóm có trọng số và ghi chú giới hạn môi trường chạy

3. Các tình huống sử dụng thực tế

Danh sách lệnh khá dài, nhưng hầu hết công việc chỉ cần đúng một chỗ bắt đầu.

Freelancer chuẩn bị buổi gọi đầu tiên

Chạy /seo audit https://client-site.com trước buổi tư vấn. Bạn có điểm số thật và danh sách lỗi cần sửa gấp trong 10 đến 15 phút, mở màn thuyết phục hơn hẳn một đề xuất theo mẫu. Cần đọc sâu một trang thì chạy tiếp /seo page https://client-site.com/pricing.

Agency rà soát định kỳ

Bắt đầu bằng /seo drift baseline https://client-site.com, sau đó chạy /seo drift compare theo lịch. Plugin lưu snapshot trong SQLite, nên bạn thấy được giữa hai lần rà soát có gì thay đổi, khỏi phải tháng nào cũng đọc lại một báo cáo cũ.

Xuất hiện trong câu trả lời AI

Dùng /seo geo https://example.com để chấm xem các trang của bạn dễ được trích dẫn đến đâu trên Google AI Overviews, ChatGPT, Perplexity và Gemini. Ghép với /seo agentic để kiểm tra AI crawler có vào được site không, đã có llms.txt và bản Markdown chưa, và agent duyệt site thuận đến mức nào.

Chuyển site hoặc mở rộng đa ngôn ngữ

Chạy /seo technical để quét kỹ thuật theo chín nhóm, /seo sitemap generate cho cấu trúc mới, và /seo hreflang trước khi đổi locale. Trình tự này bắt được chuỗi redirect và cặp hreflang hỏng trước khi chúng kéo tụt thứ hạng.

Lên kế hoạch nội dung

/seo content https://example.com/blog/post kiểm tra E-E-A-T và các phần nội dung mỏng. /seo cluster "từ khóa của bạn" gom SERP thành từng chủ đề, còn /seo content-brief "chủ đề" biến kết quả đó thành đề cương kèm từ khóa mục tiêu và liên kết nội bộ.

Doanh nghiệp local hoặc cửa hàng online

/seo local lo Google Business Profile, citation, đánh giá và map pack. /seo ecommerce thêm trang sản phẩm, cấu trúc marketplace và chuyện trùng lặp danh mục. Nếu bản đồ quan trọng với bạn, /seo maps chạy geo-grid và rà soát đánh giá.

Báo cáo cho stakeholder

/seo google report chuyển một lần chạy thành file PDF gọn gàng để gửi đi. Muốn có số liệu thật từ Search Console và CrUX thay vì ước lượng trong lab thì kết nối Google API miễn phí bằng /seo google setup trước.

4. Môi trường chạy, dữ liệu và chi phí

Plugin giữ riêng một môi trường Python và một Chromium headless; /seo setup cài cả hai vào chỗ tách biệt nên không đụng gì đến phần còn lại của máy. Chạy /seo doctor để kiểm tra hạ tầng còn khỏe không trước khi đốt token vào một lần chạy hỏng.

Không cần API key. Các Google API miễn phí như PageSpeed Insights, CrUX, Search Console hay GA4 đều là tùy chọn, key vẫn nằm trên máy bạn. Chỉ các lệnh tiện ích mở rộng mới gọi dịch vụ trả phí, và mỗi lệnh dùng tài khoản do bạn tự cấp.

Cần nói rõ một giới hạn: các trang bạn rà soát sẽ do Claude xử lý, giống như mọi thứ khác bạn mở trong Claude Code. Báo cáo vẫn là file trên máy bạn, nhưng nội dung trang thì có đi qua mô hình.

5. Cài đặt và lần chạy đầu

Cài qua plugin (khuyến nghị)

Trong Claude Code 1.0.33 trở lên:

/plugin marketplace add AgriciDaniel/claude-seo
/plugin install claude-seo@agricidaniel-claude-seo
/seo setup

Cài thủ công trên Windows

git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git
powershell -ExecutionPolicy Bypass -File claude-seo\install.ps1

[!IMPORTANT] README khuyên clone repo thay vì pipe script từ xa vào shell. Cơ chế bảo vệ của Claude Code coi irm ... | iex là rủi ro chuỗi cung ứng, nên mở install.ps1 xem qua trước khi chạy.

Những lệnh đầu tiên

/seo audit https://example.com      # toàn site, kế hoạch ưu tiên
/seo page https://example.com/pricing   # một trang, phân tích sâu
/seo geo https://example.com        # mức sẵn sàng cho AI search
/seo schema https://example.com     # kiểm tra và sinh structured data

Kết quả nhận về

Báo cáo Markdown, các phát hiện đã chấm điểm và nhóm theo mức độ.
File JSON để theo dõi thay đổi qua thời gian.
PDF qua /seo google report khi cần gửi cho ai đó.
Các bước sửa cụ thể, mỗi bước kèm cách kiểm tra lại xem đã hiệu quả chưa.

Claude SEO