claude-seo: kiểm tra SEO website ngay 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, dùng để kiểm tra SEO cho một website: kỹ thuật, nội dung, schema, SEO cho AI search, local và thương mại điện tử. Bạn gõ lệnh /seo audit kèm địa chỉ web, khoảng 10 đến 15 phút sau có kế hoạch hành động sắp theo mức quan trọng. Cài bằng ba lệnh trong Claude Code, không cần API key để bắt đầu.
claude-seo là một plugin miễn phí cho Claude Code, giúp bạn kiểm tra SEO cho bất kỳ website nào bằng vài câu lệnh bắt đầu bằng /seo. Bạn đưa địa chỉ web, nó chạy một lượt kiểm tra đầy đủ và trả về kế hoạch hành động, việc quan trọng xếp lên trước. Theo README, một lượt audit mất khoảng 10 đến 15 phút.
Repo này hợp với chủ website, người làm marketing, freelancer SEO và lập trình viên muốn có bản kiểm tra SEO mà không phải trả phí phần mềm theo tháng. Bạn không cần hiểu sâu về SEO. Mỗi đề xuất đều nói vì sao nó quan trọng và làm sao biết đã sửa đúng.
Điểm đáng giá nhất là phạm vi: ngoài SEO kỹ thuật và nội dung, repo còn xét mức độ sẵn sàng với AI search (Google AI Overviews, ChatGPT, Perplexity, Gemini). Repo hiện có khoảng 28.766 sao và 3.676 fork, giấy phép MIT, và vẫn được cập nhật trong vài tháng gần đây.
AgriciDaniel/claude-seo
Plugin miễn phí cho Claude Code: gõ /seo audit kèm địa chỉ web, nhận báo cáo SEO kỹ thuật, nội dung, schema và AI search kèm kế hoạch sửa theo mức ưu tiên.
I.claude-seo làm được gì
Bên trong, claude-seo gồm 26 sub-skill và 19 agent chuyên trách. README nói có tới 17 agent làm việc song song trên cùng một site, nên bạn không phải chờ từng mảng một. Các nhóm việc chính:
- SEO kỹ thuật. Kiểm tra khả năng được bot thu thập và lập chỉ mục, sitemap, robots.txt, chuyển hướng, tốc độ trang và Core Web Vitals. Bạn biết ngay vì sao Google chưa thấy hoặc chưa ưu ái trang của mình.
- Chất lượng nội dung và E-E-A-T. Đánh giá kinh nghiệm, chuyên môn, độ uy tín, tin cậy, trang nội dung mỏng và độ phủ chủ đề. Lệnh
/seo content-briefcòn lập dàn ý bài viết kèm từ khoá và link nội bộ. - Dữ liệu có cấu trúc (schema). Tìm, kiểm tra và viết mã Schema.org để trang đủ điều kiện hiện rich result. README có ví dụ báo cáo schema chấm điểm tổng thể và liệt kê lỗi nghiêm trọng, cảnh báo, mục đạt.
- SEO cho AI search (GEO).
/seo geochấm mức độ dễ được AI trích dẫn, kiểm tra bot AI có vào được trang không, và xem thương hiệu của bạn có mặt trên Wikipedia, Reddit, YouTube, LinkedIn hay không./seo agenticxét việc AI agent dùng site của bạn có thuận lợi không (llms.txt, Markdown, WebMCP). - Local, bản đồ và thương mại điện tử. Hồ sơ Google Business, review, map pack, trang sản phẩm, site nhiều ngôn ngữ (hreflang).
- Theo dõi thay đổi.
/seo driftlưu ảnh chụp SEO vào SQLite để so sánh trước và sau, phát hiện sự cố giữa hai lần audit. - Báo cáo bạn giữ được. Kết quả lưu dạng Markdown,
/seo google reportchuyển thành PDF.
Ngoài ra có 9 extension tuỳ chọn để lấy dữ liệu trực tiếp (ví dụ Bing Webmaster, SE Ranking, Profound, Unlighthouse, tạo ảnh bằng AI). README nhấn mạnh: không có chúng, plugin 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. Plugin chạy bên trong Claude Code, không chạy riêng.
- Python 3.11 đến 3.14. File pyproject.toml của repo yêu cầu Python từ 3.11 trở lên. Lệnh
/seo setupsẽ tạo môi trường Python riêng và cài sẵn trình duyệt không giao diện (headless Chromium), không đụng vào phần còn lại của máy. - Gói Claude Code của bạn. README ghi chi phí là «miễn phí, đi kèm gói Claude Code». Bạn chỉ trả cho Claude như bình thường.
- Hệ điều hành: README có hướng dẫn cài thủ công cho macOS, Linux và Windows (PowerShell).
- API key: không bắt buộc. Muốn dữ liệu thực tế hơn thì mới nối các API Google miễn phí (PageSpeed Insights, Chrome UX Report, Search Console, Google Analytics 4) bằng
/seo google setup.
Một lượt /seo audit đầy đủ tốn nhiều hạn mức Claude hơn kiểm tra một trang. README cho biết 5 agent cần suy luận nhiều chạy bằng Opus, phần còn lại chạy Sonnet. Nếu lo hạn mức, hãy thử /seo page trước, hoặc đổi model của từng agent trong thư mục agents/.
Về phần cứng, README không nêu yêu cầu GPU hay cấu hình tối thiểu nào.
III.Cài đặt từng bước
Cách nhanh nhất là cài như plugin ngay trong Claude Code. Ba lệnh dưới đây gõ bên trong Claude Code, không phải trong terminal thường.
- Mở Claude CodeChạy lệnh claude trong terminal, kiểm tra bản 1.0.33 trở lên
- Thêm marketplaceKhai báo nguồn plugin của repo
- Cài pluginCài claude-seo từ marketplace đó
- Chạy setupTạo môi trường Python riêng và trình duyệt headless
- Kiểm traChạy /seo doctor để xác nhận sẵn sàng
A.Mở Claude Code
Mở terminal (PowerShell trên Windows, Terminal trên macOS hoặc Linux) và gõ claude. Nếu chưa có Claude Code, bạn cần cài nó trước, README chỉ tới trang giới thiệu chính thức của Claude Code. Đây là chỗ người mới hay vấp: các lệnh bắt đầu bằng dấu / chỉ chạy được khi bạn đã vào trong giao diện Claude Code.
claudeB.Thêm marketplace và cài plugin
Gõ lần lượt hai lệnh sau. Lệnh đầu cho Claude Code biết nơi lấy plugin, lệnh sau cài plugin tên claude-seo.
/plugin marketplace add AgriciDaniel/claude-seo
/plugin install claude-seo@agricidaniel-claude-seoC.Chạy setup
Lệnh này chuẩn bị mọi thứ plugin cần: môi trường Python riêng và trình duyệt headless. Lần đầu có thể mất một lúc vì phải tải về.
/seo setupMuốn kiểm tra lại bất cứ lúc nào mà không thay đổi hệ thống, dùng /seo doctor.
D.Cài thủ công trên macOS và Linux (nếu không dùng plugin)
Bạn mở terminal thường, chạy hai lệnh sau. Lệnh đầu tải mã nguồn, lệnh sau chạy script cài.
git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git
bash claude-seo/install.shNếu muốn dùng cách một dòng bằng curl, README khuyê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.shE.Cài thủ công trên Windows (PowerShell)
Mở PowerShell, chạy hai lệnh sau. Tác giả cố ý 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.
git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git
powershell -ExecutionPolicy Bypass -File claude-seo\install.ps1Nhớ đứng ở thư mục chứa repo vừa clone, hoặc sửa đường dẫn cho khớp. Máy cần có Git để dùng lệnh git clone.
IV.Kiểm tra đã chạy được chưa
Cách đơn giản nhất: trong Claude Code, gõ lệnh sau để kiểm tra môi trường mà không thay đổi gì trên máy.
/seo doctorSau đó gõ /seo để xem danh sách toàn bộ lệnh. Nếu danh sách hiện ra, plugin đã nhận. README mô tả đây cũng là cách khám phá các lệnh có sẵn.
Bước thử thật là chạy audit nhanh một trang:
claude # start Claude Code
/seo page https://example.com/pricing # one page, in depthBạn sẽ nhận phân tích chi tiết cho đúng trang đó. README chưa mô tả chính xác màn hình thành công của /seo doctor, nên nếu có lỗi, hãy đọc thông báo nó in ra rồi chạy lại /seo setup.
V.Dùng vào việc thật
Các lệnh mẫu dưới đây đều lấy từ danh sách lệnh trong README. Hãy thay example.com bằng địa chỉ của bạn.
A.Chủ shop muốn biết website bán hàng đang yếu ở đâu
Chị Lan bán đồ gia dụng online, có một website riêng nhưng lượng khách từ Google thấp. Chị không rành kỹ thuật. Chị mở Claude Code và chạy audit toàn site:
/seo audit https://example.comClaude SEO nhận ra đây là site thương mại điện tử, điều chỉnh các bước kiểm tra, rồi cho nhiều agent chạy song song. Kết quả là bản kế hoạch có điểm số, việc quan trọng nhất ở đầu. Với trang sản phẩm, chị chạy thêm /seo ecommerce https://example.com để xem riêng phần thương mại điện tử.
Nó không đưa bạn một đống cảnh báo, mà đưa một danh sách việc cần làm, việc nào trước việc nào sau.
Ông T
B.Marketer kiểm tra schema trước khi đăng trang mới
Anh Minh làm marketing cho một công ty phần mềm. Trước khi duyệt trang giới thiệu mới, anh muốn chắc dữ liệu có cấu trúc đúng:
/seo schema https://example.com/aboutCông cụ phát hiện các khối JSON-LD, kiểm tra tính hợp lệ và chỉ ra chỗ lệch giữa nội dung trên trang với schema (ví dụ người sáng lập hiển thị trên trang nhưng thiếu trong schema, đúng như báo cáo mẫu của README). Nó cũng có thể viết sẵn mã schema để bạn đưa cho lập trình viên.
C.Người làm nội dung chuẩn bị bài viết mới
Chị Hà viết blog cho một công ty du lịch. Chị cần dàn ý bài có từ khoá và link nội bộ, và muốn biết các chủ đề liên quan nên nhóm thế nào:
/seo content-brief du lịch Đà Lạt
/seo cluster du lịch Đà LạtLệnh đầu cho bản brief gồm từ khoá mục tiêu, dàn ý và gợi ý link nội bộ. Lệnh sau gom nhóm từ khoá theo kết quả tìm kiếm thực tế (clustering ngữ nghĩa dựa trên SERP). Hai kết quả này giúp lên lịch nội dung có hệ thống thay vì viết lẻ tẻ.
D.Chủ doanh nghiệp nhỏ kiểm tra độ sẵn sàng với AI search
Anh Tuấn có phòng khám và muốn biết khách hỏi ChatGPT hay Google AI thì thương hiệu mình có được nhắc đến không:
/seo geo https://example.com
/seo local https://example.com/seo geo chấm khả năng được trích dẫn và kiểm tra bot AI có truy cập được trang không. /seo local xét hồ sơ Google Business, review và map pack. Bạn nhận về danh sách việc cần chỉnh để tăng cơ hội xuất hiện, dù README không hứa chắc kết quả xếp hạng.
VI.Lỗi hay gặp và cách xử lý
Gõ lệnh /plugin hoặc /seo trong terminal thường thì báo không tìm thấy lệnh. Đây là lệnh của Claude Code, không phải lệnh hệ điều hành. Gõ claude để vào Claude Code rồi mới chạy.
Claude Code quá cũ nên không có lệnh /plugin. 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.
Python không đạt phiên bản. README ghi Python 3.11 đến 3.14, còn pyproject.toml yêu cầu từ 3.11 trở lên. Nếu máy dùng bản cũ hơn, cài bản mới trước rồi chạy lại /seo setup. Chạy /seo doctor để xem môi trường thiếu gì.
Script cài trên Windows bị chặn. Lệnh PowerShell trong README đã kèm -ExecutionPolicy Bypass cho riêng lần chạy này. Hãy chắc là bạn đứng đúng thư mục chứa claude-seo, và đọc file install.ps1 trước khi chạy.
Kết quả Core Web Vitals hoặc chỉ mục chỉ là ước lượng. README nói rõ: khi chưa nối API Google, Core Web Vitals chỉ là số đo phòng lab và việc lập chỉ mục được suy ra từ trang. Muốn số liệu thật, chạy /seo google setup và nối các API Google miễn phí.
Kết quả nhiễu với trang chỉ tải nội dung sau khi cuộn hoặc bấm. README cảnh báo trường hợp này. Hãy xem kết quả như gợi ý và tự kiểm tra lại trang đó.
VII.Có nên dùng không
Điểm mạnh. Cài đơn giản bằng ba lệnh, miễn phí (giấy phép MIT, không giới hạn số site, không theo dõi theo README). Phạm vi rộng, từ kỹ thuật tới AI search. Báo cáo là file trên máy bạn, và bạn có thể hỏi tiếp bằng tiếng thường để Claude giải thích. README cũng cho biết trang bị audit nếu cần JavaScript (Next.js, React, Vue) sẽ được mở bằng trình duyệt headless.
Giới hạn. Công cụ phụ thuộc vào Claude Code, nên dữ liệu trang bạn phân tích sẽ được gửi tới Claude, giống mọi việc khác bạn làm trong Claude Code. Danh sách nguồn công khai nó có thể đọc (Wikipedia, Reddit, Common Crawl) nằm trong PRIVACY.md. Audit đầy đủ tốn hạn mức. README cũng tự nhận các công cụ crawl như Screaming Frog quét nhanh và sâu hơn, còn các bộ SEO lớn có cơ sở dữ liệu backlink riêng.
Khi nào chọn cách khác. Nếu bạn cần crawl hàng trăm nghìn URL, hoặc cần dữ liệu backlink quy mô lớn, hãy dùng công cụ chuyên dụng. README khuyên nhiều người dùng cả hai: Claude SEO để giải thích và xếp ưu tiên, công cụ crawl để quét sâu. Với site nhỏ và vừa, hoặc để có bản đánh giá nhanh trước khi làm việc với khách, claude-seo là lựa chọn đáng thử.
Câu hỏi thường gặp
claude-seo có miễn phí không?
Có. Repo dùng giấy phép MIT, README ghi không tính phí theo site, không giới hạn lượng dùng và không theo dõi. Bạn chỉ cần có Claude Code. Một vài extension tuỳ chọn nối với dịch vụ trả phí bên thứ ba, nhưng plugin chạy đầy đủ mà không cần chúng.
Có cần API key không?
Không bắt buộc. Plugin chạy được ngay sau khi cài. Nếu muốn số liệu thực tế hơn, 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. README nói key của bạn nằm trên máy bạn.
Cần GPU hoặc máy cấu hình mạnh không?
README không nêu yêu cầu GPU hay cấu hình phần cứng. Yêu cầu được ghi là Claude Code 1.0.33 trở lên và Python 3.11 đến 3.14. Lệnh /seo setup sẽ cài môi trường Python riêng và trình duyệt headless cho bạn.
Chạy được trên Windows không?
Có hướng dẫn cho Windows. Bạn có thể cài plugin ngay trong Claude Code, hoặc cài thủ công bằng PowerShell với git clone rồi chạy install.ps1. README cũng có hướng dẫn cho macOS và Linux.
Dữ liệu của tôi có rời khỏi máy không?
Các trang và dữ liệu được phân tích sẽ được gửi tới Claude (Anthropic), giống mọi thứ bạn làm trong Claude Code. Báo cáo được lưu thành file trên máy bạn. README cho biết không dịch vụ SEO hay bên thứ ba nào thấy dữ liệu của bạn trừ khi bạn tự nối extension hoặc API. Danh sách đầy đủ nằm trong PRIVACY.md của repo.
Khác gì Screaming Frog hay các công cụ SEO khác?
Theo README, công cụ crawl như Screaming Frog quét 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 thì giải thích kết quả, xếp theo mức ảnh hưởng, đi sâu vào AI search và cho bạn hỏi tiếp bằng ngôn ngữ thường. Nhiều người dùng cả hai.
Có kiểm tra được website làm bằng React, Next.js, Vue không?
Có. README nói khi trang cần JavaScript để hiện nội dung, plugin tự mở trang bằng trình duyệt headless để kiểm tra như người truy cập 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.


