Claude SEO: biến Claude Code thành đội audit SEO 19 agent, có cả tìm kiếm AI

Một bản audit SEO bài bản thường tốn nửa ngày đến vài tuần: chạy crawler, mở PageSpeed, soi schema, đọc lại nội dung theo E-E-A-T, rồi gom tất cả thành một danh sách việc có thứ tự ưu tiên. Giờ lại thêm một mảng mới: trang của bạn có được Google AI Overviews, ChatGPT hay Perplexity trích dẫn không. Claude SEO (repo AgriciDaniel/claude-seo) đóng gói toàn bộ quy trình đó thành một plugin cho Claude Code. Bạn đưa một URL, khoảng 10–15 phút sau nhận về bản kế hoạch hành động đã sắp xếp theo mức độ ảnh hưởng.

GitHub: https://github.com/AgriciDaniel/claude-seo · khoảng 28 nghìn sao, 3,6 nghìn fork · Python · MIT · bản mới nhất v2.6.0 (10/11/2026)

Claude SEO là gì?

Đây là một plugin Claude Code mã nguồn mở, miễn phí, do Agrici Daniel phát triển. Plugin gồm 26 sub-skill và 19 subagent chuyên trách, mỗi agent phụ trách một mảng: kỹ thuật, nội dung, schema, tốc độ, tìm kiếm AI, local, e-commerce… Một skill điều phối tên seo nhận lệnh, nhận diện loại website rồi chia việc cho các agent chạy song song. Theo README, có thể tới 17 agent cùng audit một website một lúc.

Điểm khác so với công cụ SEO truyền thống: kết quả không phải một bảng cảnh báo dài, mà là kế hoạch có lý do. Mỗi khuyến nghị nói rõ nó dựa trên gì, phụ thuộc vào điều gì, và làm sao biết đã sửa thành công.

Một lượt audit diễn ra thế nào

1. Hiểu website: skill điều phối đoán loại hình kinh doanh (SaaS, local, e-commerce, publisher, agency) và điều chỉnh bộ kiểm tra cho phù hợp.
2. Chia việc song song: 7 agent nền luôn chạy (technical, content, schema, sitemap, performance, visual, geo). Các agent khác chỉ được gọi khi đủ điều kiện, ví dụ seo-local khi phát hiện doanh nghiệp địa phương, seo-google khi có sẵn thông tin đăng nhập Google API, seo-drift khi URL đã có ảnh chụp trạng thái (baseline) từ lần trước.
3. Tổng hợp: gom kết quả, tính điểm sức khoẻ SEO (health score) và xuất kế hoạch hành động theo thứ tự ưu tiên.

Báo cáo lưu dạng Markdown trên máy bạn, và /seo google report chuyển nó thành PDF. Website dựng bằng JavaScript (Next.js, React, Vue) được mở trong trình duyệt headless, nên được audit đúng như người dùng nhìn thấy.

Đội 19 agent và các nhóm lệnh

Về model, README cho biết 5 agent cần phán đoán nhiều (content, geo, cluster, sxo, drift) chạy Opus, còn lại chạy Sonnet. Bạn đổi được model của từng agent trong thư mục agents/.

Cài đặt và lượt audit đầu tiên

Cần Claude Code từ 1.0.33 trở lên và Python 3.11–3.14. Gõ trong Claude Code:

/plugin marketplace add AgriciDaniel/claude-seo
/plugin install claude-seo@agricidaniel-claude-seo
/seo setup      # tạo môi trường Python riêng + Chromium headless
/seo doctor     # kiểm tra lại, không thay đổi hệ thống

Rồi chạy thử:

/seo audit https://example.com          # audit toàn site
/seo page https://example.com/pricing   # soi kỹ một trang
/seo geo https://example.com            # mức sẵn sàng cho tìm kiếm AI
/seo schema https://example.com         # kiểm tra/sinh structured data

Không cần API key. Nếu muốn dữ liệu thực tế thay vì ước tính, chạy /seo google setup để kết nối các API miễn phí của Google: PageSpeed Insights, Chrome UX Report, Search Console, GA4. Repo cũng có script install.sh/install.ps1 để cài tay. Tác giả khuyên git clone rồi đọc script trước khi chạy, thay vì kiểu curl | bash.

Kết quả tác giả công bố

README dẫn chính website của dự án (claude-seo.md), được audit bằng công cụ này từ ngày đầu: khoảng 10,8 nghìn lượt click Search Console trong 12 tuần đầu và điểm PageSpeed mobile 99. Đây là số liệu tự công bố trên một website có lợi thế lớn (repo hàng chục nghìn sao kéo traffic về), nên chỉ nên xem như minh hoạ, không phải bằng chứng hiệu quả cho website của bạn.

So với Screaming Frog và các SEO suite

Chính tác giả thừa nhận crawler như Screaming Frog crawl nhanh và sâu hơn, còn các bộ SEO lớn có cơ sở dữ liệu backlink riêng. Claude SEO mạnh ở chỗ khác: giải thích phát hiện, xếp theo tác động, đi sâu vào tìm kiếm AI, và cho bạn hỏi tiếp bằng ngôn ngữ tự nhiên. Cách dùng hợp lý là kết hợp: crawler để quét số lượng lớn, Claude SEO để diễn giải và lập kế hoạch.

Rủi ro và lưu ý

• Dữ liệu đi qua Anthropic: nội dung trang được audit được gửi cho Claude như mọi thứ khác trong Claude Code. Báo cáo nằm trên máy bạn; bên thứ ba chỉ thấy dữ liệu khi bạn bật extension/API. Một số kiểm tra đọc nguồn công khai (Wikipedia, Reddit, Common Crawl). Xem PRIVACY.md.
• Tốn hạn mức: một lượt /seo audit đầy đủ chạy nhiều agent, trong đó có Opus, nên tiêu hạn mức gói Claude nhiều hơn hẳn một lần soi trang lẻ. Hãy thử /seo page trước.
• Giới hạn khi không có API Google: Core Web Vitals chỉ là số đo lab, trạng thái index chỉ là suy luận. Trang chỉ tải nội dung sau khi cuộn hoặc click có thể cho kết quả nhiễu.
• Bảng so sánh chi phí trong README mang tính minh hoạ: con số kiểu “agency tốn hơn 100 nghìn USD/năm” là ví dụ của tác giả, không phải khảo sát.
• Có bản Pro riêng: bản public MIT miễn phí; thành viên cộng đồng trả phí trên Skool nhận bản private có tính năng sớm hơn. Repo cũng là kênh quảng bá cho cộng đồng này.
• AI vẫn có thể sai: khuyến nghị schema, canonical, redirect cần người có chuyên môn duyệt trước khi áp lên production.

Áp dụng thế nào?

• Dev: Chạy /seo technical và /seo schema trước mỗi lần release lớn. Kết hợp /seo drift baseline sau khi website ổn định, rồi /seo drift compare sau mỗi lần deploy để bắt lỗi kiểu lỡ tay thêm noindex hay làm hỏng canonical.
• Tech Lead: Đưa báo cáo Markdown vào repo hoặc ticket; dùng phần “làm sao biết đã sửa xong” làm tiêu chí chấp nhận. Cân nhắc chuyển các agent ít quan trọng sang Sonnet để kiểm soát chi phí.
• PM / Marketing: Dùng /seo plan và /seo content-brief để lập roadmap nội dung; /seo geo để biết website đã sẵn sàng cho tìm kiếm AI chưa. Freelancer có thể audit ngay trong buổi gặp đầu tiên để đưa điểm số và các lỗi cần sửa trước tiên.