claude-seo: audit SEO và AI search trong Claude Code — hướng dẫn cài đặt và dùng
Bài này là một góc nhìn khác về AgriciDaniel/claude-seo — repo từng đổi tên nên mình viết lại với cách tiếp cận khác. Bài hướng dẫn chính: claude-seo: kiểm tra SEO website trong Claude Code — hướng dẫn cài đặt và dùng →

Tóm tắt nhanh
Claude SEO là plugin mã nguồn mở (MIT) chạy trong Claude Code. Bạn đưa một địa chỉ website, nó chạy audit SEO đầy đủ rồi trả về kế hoạch hành động xếp theo mức quan trọng. Cài bằng ba lệnh trong Claude Code, không bắt buộc API key.
Claude SEO là một plugin miễn phí, mã nguồn mở dành cho Claude Code. Bạn đưa cho nó địa chỉ một website, nó chạy audit SEO đầy đủ rồi trả về một kế hoạch sửa lỗi xếp theo mức độ quan trọng. Theo README, một lần audit mất khoảng 10 đến 15 phút.
Repo này hợp với ba nhóm người. Nhóm thứ nhất là chủ website, chủ shop online hay người làm marketing, muốn biết site mình yếu chỗ nào mà không muốn đọc một đống báo cáo khó hiểu. Nhóm thứ hai là người làm SEO tự do hoặc agency, cần một bộ kiểm tra lặp lại được cho nhiều khách. Nhóm thứ ba là lập trình viên muốn kiểm tra schema, sitemap và tốc độ trang ngay trong lúc làm việc.
Điểm đáng giá nhất là nó không chỉ liệt kê cảnh báo. Mỗi khuyến nghị đều nói vì sao quan trọng và làm sao biết là đã sửa xong. Nó cũng kiểm tra cả khả năng được AI trích dẫn (Google AI Overviews, ChatGPT, Perplexity, Gemini). Repo hiện có khoảng 28766 sao và 3676 fork, giấy phép MIT. Bạn có thể xem video ngắn bên dưới để thấy nó chạy thực tế.
AgriciDaniel/claude-seo
Plugin miễn phí cho Claude Code: gõ /seo audit để kiểm tra kỹ thuật, nội dung, schema và AI search của website, rồi nhận kế hoạch sửa theo thứ tự ưu tiên.
I.Claude SEO làm được gì
Claude SEO gồm 26 kỹ năng con (sub-skill) và 19 agent chuyên trách. Theo README, tối đa 17 agent làm việc song song trên một site. Các nhóm việc chính:
- SEO kỹ thuật. Kiểm tra khả năng thu thập dữ liệu, lập chỉ mục, sitemap, robots.txt, chuyển hướng, tốc độ trang và Core Web Vitals. Lợi ích: bạn biết Google có đọc được site của bạn hay không.
- Chất lượng nội dung và E-E-A-T. E-E-A-T là kinh nghiệm, chuyên môn, uy tín và độ tin cậy. Nó cũng tìm trang nội dung mỏng và các chủ đề còn thiếu.
- Dữ liệu có cấu trúc (schema). Tìm, kiểm tra và viết giúp bạn đoạn Schema.org để trang có cơ hội hiện kết quả nổi bật trên Google.
- AI search (GEO). Chấm điểm mức độ dễ được trích dẫn, kiểm tra crawler của AI có vào được trang không. Lệnh
/seo agenticcòn kiểm tra mức sẵn sàng cho AI agent: llms.txt, Markdown, WebMCP. - SEO địa phương và thương mại điện tử. Hồ sơ Google Business Profile, đánh giá, map pack, trang sản phẩm và site đa ngôn ngữ (hreflang).
- Theo dõi thay đổi.
/seo driftlưu ảnh chụp (snapshot) bằng SQLite để so sánh trước và sau khi bạn sửa site. - Báo cáo. Kết quả lưu thành file Markdown. Lệnh
/seo google reportbiến chúng thành PDF.
Ngoài ra có 5 tiện ích mở rộng tùy chọn: tạo ảnh AI cho SEO, theo dõi share-of-voice trên các AI (SE Ranking), theo dõi trích dẫn của AI (Profound), Bing Webmaster kèm IndexNow, và Unlighthouse để chạy Lighthouse cho nhiều trang. Repo nói rõ: không có các phần này thì Claude SEO vẫn chạy đầy đủ.
II.Cần chuẩn bị gì
Theo README, bạn cần:
- Claude Code phiên bản 1.0.33 trở lên. Đây là điều kiện bắt buộc, vì plugin chạy bên trong Claude Code.
- Python từ 3.11 đến 3.14. File pyproject.toml của repo yêu cầu Python từ 3.11 trở lên. Phần còn lại, gồm môi trường Python riêng và trình duyệt headless (Chromium), sẽ do
/seo setupcài giúp. - Gói Claude Code của bạn. README ghi chi phí là «miễn phí, đi kèm gói Claude Code của bạn». Bản thân plugin không thu phí, nhưng mỗi lần audit tiêu hao hạn mức của gói Claude.
- API key: không bắt buộc. Nếu muốn dữ liệu thật, bạn có thể nối các API Google miễn phí (PageSpeed Insights, Chrome UX Report, Search Console, Google Analytics 4) bằng
/seo google setup.
Về hệ điều hành, repo có cả hướng dẫn cho macOS, Linux và Windows (PowerShell). README không nêu yêu cầu phần cứng như GPU.
Một lần audit đầy đủ dùng nhiều hạn mức Claude hơn một lần kiểm tra một trang, vì có 5 agent chạy bằng Opus. Nếu gói của bạn có giới hạn, hãy thử lệnh một trang trước. README cho biết bạn có thể đổi model của từng agent trong thư mục agents/.
III.Cài đặt từng bước
- Mở Claude CodeCần bản 1.0.33 trở lên; các lệnh bên dưới gõ bên trong Claude Code
- Thêm marketplaceKhai báo nguồn plugin AgriciDaniel/claude-seo
- Cài pluginCài claude-seo từ marketplace vừa thêm
- Chạy /seo setupTạo môi trường Python riêng và trình duyệt headless
- Chạy /seo doctorKiểm tra mọi thứ đã sẵn sàng chưa
A.Mở Claude Code và gõ ba lệnh cài plugin
Chỗ người mới hay vấp nhất: ba lệnh dưới đây gõ bên trong Claude Code, không phải trong cửa sổ terminal thông thường. Hãy mở terminal, gõ claude để vào Claude Code, rồi mới dán từng dòng.
/plugin marketplace add AgriciDaniel/claude-seo
/plugin install claude-seo@agricidaniel-claude-seo
/seo setupLệnh đầu thêm nguồn plugin. Lệnh thứ hai cài plugin. Lệnh thứ ba, /seo setup, chuẩn bị mọi thứ Claude SEO cần (môi trường Python riêng và trình duyệt headless) mà không đụng đến phần còn lại của máy bạn.
B.Kiểm tra bằng /seo doctor
/seo doctorLệnh này kiểm tra môi trường đã sẵn sàng chưa mà không thay đổi gì trong hệ thống. README nói bạn có thể chạy nó bất cứ lúc nào.
C.Cách khác: cài thủ công trên macOS hoặc Linux
Nếu không muốn dùng plugin marketplace, bạn tải repo về rồi chạy script cài:
git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git
bash claude-seo/install.shREADME cũng có bản một dòng bằng curl. Nên tải về, đọc nội dung rồi mới chạy:
curl -fsSL https://raw.githubusercontent.com/AgriciDaniel/claude-seo/main/install.sh > install.sh
cat install.sh # review before running
bash install.sh
rm install.shD.Cách khác: cài thủ công trên Windows (PowerShell)
Mở PowerShell, rồi chạy:
git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git
powershell -ExecutionPolicy Bypass -File claude-seo\install.ps1Tác giả chủ ý dùng git clone thay vì kiểu irm | iex, để bạn mở file claude-seo\install.ps1 ra đọc trước khi chạy. Đây là thói quen tốt với mọi script cài đặt.
E.Gỡ cài đặt
Nếu cài bằng plugin:
/plugin uninstall claude-seo@agricidaniel-claude-seoNếu cài thủ công:
git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git
bash claude-seo/uninstall.shIV.Kiểm tra đã chạy được chưa
Có ba cách, từ dễ đến chắc chắn:
- Gõ
/seo doctor. Lệnh này một trang tin tức trường chạy (Python, trình duyệt headless) đã sẵn sàng hay còn thiếu gì. - Gõ
/seotrong Claude Code. Theo README, bạn sẽ thấy danh sách toàn bộ lệnh. Nếu thấy danh sách, plugin đã được nhận. - Chạy thử một audit trên site của bạn:
claude # start Claude Code
/seo audit https://example.com # full site audit with a prioritized planThay https://example.com bằng địa chỉ thật. Kết quả mong đợi là một báo cáo có điểm số và kế hoạch hành động theo thứ tự ưu tiên, lưu thành file Markdown trên máy bạn. README cho biết mất khoảng 10 đến 15 phút, nên đừng tắt giữa chừng.
V.Dùng vào việc thật
Các tình huống dưới đây đều dùng lệnh có trong README. Bạn thay địa chỉ web bằng site của mình.
A.Chủ shop online muốn biết trang sản phẩm yếu ở đâu
Bạn bán hàng qua website riêng và thấy lượng khách từ Google không tăng. Mở Claude Code, rồi gõ:
/seo ecommerce https://tenshopcuaban.vn
/seo schema https://tenshopcuaban.vnLệnh đầu phân tích SEO thương mại điện tử và trang sản phẩm. Lệnh sau kiểm tra dữ liệu có cấu trúc, tức đoạn mã giúp Google hiểu giá, tồn kho, đánh giá. Kết quả là danh sách lỗi kèm mức độ quan trọng. Bạn sửa mục đầu tiên trước, đừng cố sửa hết một lúc.
B.Quán, cửa hàng có địa điểm thật muốn lên bản đồ
Bạn có một phòng khám, tiệm cắt tóc hoặc quán cà phê và muốn khách tìm thấy trên Google Maps. Gõ:
/seo local https://tenquancuaban.vnLệnh này xem xét hồ sơ Google Business Profile, các trang trích dẫn (citation), đánh giá và vị trí trong map pack. Bạn nhận về những việc cần làm cho hồ sơ doanh nghiệp của mình, chẳng hạn chỗ thông tin chưa đồng nhất.
Kế hoạch tốt không phải là danh sách đầy đủ nhất, mà là danh sách cho bạn biết nên sửa cái gì trước.
Ông T
C.Người làm SEO tự do muốn chốt khách ngay buổi gọi đầu
Một khách hỏi «site em có ổn không?». Bạn chạy audit ngay trên máy, rồi xuất báo cáo:
/seo audit https://sitecuakhach.com
/seo google reportLệnh audit cho điểm số và các lỗi lớn nhất. /seo google report biến báo cáo Markdown thành PDF để gửi khách. README gọi đây là cách chạy audit ở cuộc gọi đầu và đưa ra điểm cùng các sửa chữa hàng đầu trước khi viết đề xuất. Nhớ đọc lại kết quả trước khi gửi, vì đó là công cụ hỗ trợ chứ không thay phán đoán của bạn.
D.Lập trình viên muốn theo dõi site sau mỗi lần cập nhật
Bạn vừa sửa nhiều trang và sợ làm hỏng SEO mà không biết. Hãy lưu mốc trước, sửa, rồi so sánh:
/seo drift baseline https://sitecuaban.com
/seo drift compare https://sitecuaban.comLệnh baseline lưu ảnh chụp ban đầu vào SQLite. Sau khi triển khai, compare cho biết cái gì đã thay đổi. Nếu cần xem lịch sử, README có thêm lệnh history. Với site dùng Next.js, React hay Vue, README nói nó tự mở trang bằng trình duyệt headless để kiểm tra đúng như khách nhìn thấy.
VI.Lỗi hay gặp và cách xử lý
A.Gõ lệnh /plugin trong terminal thường và báo không tìm thấy lệnh
Các lệnh bắt đầu bằng / là lệnh của Claude Code, không phải lệnh hệ điều hành. Hãy gõ claude để vào Claude Code trước, rồi mới dán lệnh.
B.Lệnh /plugin hoặc /seo không được nhận
Phần lớn do Claude Code quá cũ. README yêu cầu bản 1.0.33 trở lên. Hãy cập nhật Claude Code rồi thử lại.
C./seo setup hoặc /seo doctor báo thiếu môi trường Python
Kiểm tra phiên bản Python trên máy. README ghi Python từ 3.11 đến 3.14. Sau khi cài đúng bản, chạy lại /seo setup, rồi /seo doctor để xác nhận. Nếu vẫn lỗi, bạn xem thư mục docs/ và file README trong repo.
D.Windows chặn không cho chạy install.ps1
Đó là chính sách thực thi script của PowerShell. Lệnh trong README đã có -ExecutionPolicy Bypass cho riêng lần chạy này. Hãy đảm bảo bạn gõ đúng nguyên lệnh và đã mở file install.ps1 ra đọc trước, vì bạn đang cho phép một script chạy trên máy mình.
E.Kết quả Core Web Vitals hoặc chỉ mục có vẻ «ước chừng»
Đúng như README nói: khi chưa nối khóa Google API, Core Web Vitals chỉ là ước lượng từ phòng thí nghiệm, còn việc lập chỉ mục được suy ra từ trang. Muốn số liệu thật, chạy /seo google setup để nối PageSpeed, Chrome UX Report, Search Console và GA4. README cũng cảnh báo các trang chỉ tải nội dung chính sau khi cuộn hoặc bấm có thể cho kết quả nhiễu.
VII.Có nên dùng không
Điểm mạnh. Miễn phí, giấy phép MIT, không giới hạn số site và không theo dõi người dùng, theo README. Cài đơn giản bằng ba lệnh. Điểm hay nhất là báo cáo giải thích lý do và cách kiểm chứng, lại có phần AI search mà nhiều công cụ truyền thống làm chưa sâu. Báo cáo lưu thành file trên máy bạn (Markdown, PDF, JSON).
Giới hạn. Bạn cần Claude Code và một gói Claude, nên không phải hoàn toàn «không tốn gì». Audit đầy đủ tiêu hao nhiều hạn mức. README thừa nhận các trình thu thập như Screaming Frog crawl nhanh và sâu hơn, còn các bộ công cụ SEO lớn có cơ sở dữ liệu backlink riêng. Claude SEO mạnh ở chỗ giải thích, xếp ưu tiên và cho bạn hỏi tiếp bằng tiếng thường, không phải ở chỗ thay thế các công cụ kia. Nhiều người dùng cả hai.
Về dữ liệu. Trang và dữ liệu được phân tích sẽ được gửi tới Claude (Anthropic), giống mọi thứ khác bạn làm trong Claude Code. Báo cáo lưu trên máy bạn. Nếu site có thông tin nội bộ nhạy cảm, hãy đọc PRIVACY.md trong repo trước.
Khi nào chọn cách khác. Nếu bạn cần crawl hàng trăm nghìn trang, hoặc cần cơ sở dữ liệu backlink khổng lồ, hãy dùng công cụ chuyên dụng. Nếu bạn chưa dùng Claude Code bao giờ, hãy làm quen với nó trước. Còn nếu bạn muốn một người «tư vấn SEO» chạy được trong 15 phút cho site của mình, repo này đáng để thử.
Câu hỏi thường gặp
Claude SEO có miễn phí không?
Có. Plugin theo giấy phép MIT, theo README là không tính phí theo site, không giới hạn lượt dùng và không theo dõi. Bạn chỉ cần Claude Code và gói Claude của mình. Một vài tiện ích mở rộng tùy chọn nối với dịch vụ trả phí và bạn tự dùng tài khoản riêng, nhưng không bắt buộc.
Tôi có cần API key không?
Không bắt buộc. README nói Claude SEO chạy được ngay. Nếu muốn dữ liệu thật, bạn có thể nối các API Google miễn phí (PageSpeed Insights, Chrome UX Report, Search Console, GA4) bằng lệnh /seo google setup. Khóa của bạn ở lại trên máy.
Có chạy được trên Windows không, có cần GPU không?
Có. Repo có script install.ps1 cho Windows (PowerShell) bên cạnh install.sh cho macOS và Linux. Bạn cũng có thể cài bằng plugin ngay trong Claude Code. README không nhắc đến yêu cầu GPU.
Dữ liệu của tôi có rời khỏi máy không?
Claude SEO chạy trong Claude Code, nên trang và dữ liệu được phân tích sẽ được gửi tới Claude (Anthropic), như mọi việc khác trong Claude Code. Báo cáo được lưu thành file trên máy bạn. Theo README, không có dịch vụ SEO hay bên thứ ba nào thấy dữ liệu trừ khi bạn tự nối tiện ích hoặc API. Chi tiết nằm trong PRIVACY.md.
Nó khác gì Screaming Frog hay các công cụ SEO khác?
Theo README, các trình thu thập như Screaming Frog crawl nhanh và sâu hơn, còn bộ công cụ SEO lớn có cơ sở dữ liệu backlink riêng. Claude SEO giải thích kết quả, xếp theo mức tác động, phủ sâu phần AI search và cho bạn hỏi thêm bằng tiếng thường. Nhiều người dùng cả hai.
Nó có audit được site viết bằng Next.js, React hay Vue không?
Có. README nói khi trang cần JavaScript để hiện nội dung, Claude SEO tự mở trang bằng trình duyệt headless, nên các ứng dụng một trang được kiểm tra đúng như khách nhìn thấy. Trang chỉ tải nội dung sau khi cuộn hoặc bấm có thể cho kết quả nhiễu.
Một lần audit tốn bao nhiêu hạn mức Claude?
README không đưa con số cụ thể. Nó cho biết 5 agent cần phán đoán nhiều hơn chạy bằng Opus, phần còn lại chạy bằng Sonnet, nên audit đầy đủ tốn nhiều hạn mức hơn kiểm tra một trang. Bạn có thể đổi model của từng agent trong thư mục agents/.


