Bỏ qua tới nội dung
Ông T.vn

claude-seo: kiểm tra SEO website ngay trong Claude Code — hướng dẫn cài đặt và dùng

9 phút đọcCập nhật

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 →

claude-seo: kiểm tra SEO website ngay 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ở (giấy phép MIT) chạy bên trong Claude Code. Bạn đưa một địa chỉ website, nó kiểm tra SEO kỹ thuật, nội dung, schema, mức sẵn sàng cho AI search, rồi trả về kế hoạch sửa theo thứ tự ưu tiên. Cài đặt khá dễ: ba lệnh trong Claude Code, không cần API key để bắt đầu.

claude-seo là một plugin SEO miễn phí, chạy bên trong Claude Code. Bạn đưa cho nó địa chỉ một website, nó kiểm tra như một chuyên viên SEO rồi đưa ra kế hoạch sửa, xếp theo việc nào quan trọng trước. README nói một lần audit đầy đủ mất khoảng 10 đến 15 phút.

Repo này hợp với chủ website hoặc chủ shop muốn biết trang của mình đang yếu ở đâu mà chưa muốn trả tiền cho agency. Nhân viên marketing, người viết nội dung và lập trình viên mới cũng dùng được. Hiện repo có khoảng 28.766 sao và 3.676 fork, đây là một trong những repo SEO cho Claude Code được quan tâm nhiều.

Điểm đáng giá nhất là nó không chỉ liệt kê lỗi. 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 search (Google AI Overviews, ChatGPT, Perplexity, Gemini) trích dẫn, phần mà nhiều công cụ SEO truyền thống làm chưa kỹ. Bạn có thể xem video ngắn bên dưới để thấy nó chạy thật trước khi cài.

Plugin

AgriciDaniel/claude-seo

Plugin miễn phí cho Claude Code: nhập địa chỉ website, 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.

★ 29kPythonMIT
Xem repo trên GitHub
Video giới thiệu claude-seoXem trên YouTubeXem trên Facebook

I.claude-seo làm được gì

Tác giả ghép plugin từ 26 sub-skill và 19 agent chuyên biệt. Khi audit, tối đa 17 agent làm việc song song trên website của bạn. Các nhóm việc chính:

  • SEO kỹ thuật. Kiểm tra khả năng được bot thu thập, lập chỉ mục, sitemap, robots.txt, chuyển hướng, tốc độ trang và Core Web Vitals. Bạn biết ngay Google có "đọc" được trang của mình không.
  • 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à mức phủ chủ đề. Việc này giúp bạn biết bài nào nên viết lại trước.
  • Dữ liệu có cấu trúc (schema). Tìm, kiểm tra và viết mã Schema.org để trang có cơ hội hiện rich result. Người không rành code vẫn có sẵn đoạn markup để đưa cho người làm web.
  • AI search (GEO). Lệnh /seo geo chấm xem trang của bạn dễ được trích dẫn đến đâu và AI crawler có vào được không. Lệnh /seo agentic kiểm tra mức sẵn sàng cho AI agent, gồm llms.txt và WebMCP.
  • SEO địa phương và thương mại điện tử. Có lệnh riêng cho Google Business Profile, đánh giá, map pack, trang sản phẩm và website nhiều ngôn ngữ.
  • Theo dõi thay đổi. /seo drift lưu ảnh chụp (snapshot) vào SQLite để so sánh trước và sau khi bạn sửa web.
  • Báo cáo giữ được. Kết quả lưu thành Markdown. Lệnh /seo google report đổi chúng thành PDF.

Ngoài ra có 9 tiện ích mở rộng tùy chọn để lấy dữ liệu trực tiếp, ví dụ Bing Webmaster, SE Ranking, Profound, Unlighthouse và tạo ảnh bằng AI. 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. Đây là điều kiện bắt buộc, vì plugin chạy bên trong Claude Code. Bạn cần có gói Claude phù hợp để dùng Claude Code.
  • Python từ 3.11 đến 3.14. File pyproject.toml yêu cầu Python từ 3.11 trở lên.
  • Hệ điều hành. README có hướng dẫn cho macOS, Linux và Windows (PowerShell).
  • API key: không bắt buộc. README nói plugin chạy được ngay. Nếu muốn dữ liệu thật từ Google (PageSpeed Insights, Chrome UX Report, Search Console, GA4), bạn kết nối các API miễn phí bằng lệnh /seo google setup.
  • Trình duyệt headless: lệnh /seo setup sẽ cài giúp bạn, không cần tự cài.

Tư liệu không nói gì về yêu cầu GPU hay cấu hình máy tối thiểu.

III.Cài đặt từng bước

  1. Mở Claude CodeChạy lệnh claude trong terminal, đảm bảo bản 1.0.33 trở lên
  2. Thêm marketplaceDùng /plugin marketplace add để khai báo nguồn plugin
  3. Cài pluginDùng /plugin install để cài claude-seo
  4. Chạy setupDùng /seo setup để tạo môi trường Python và trình duyệt headless

A.Mở Claude Code

Ba lệnh cài đặt dưới đây không gõ ở terminal thường. Bạn gõ chúng bên trong Claude Code. Mở terminal (PowerShell trên Windows, Terminal trên macOS) rồi chạy:

Terminal
claude

Nếu máy báo không tìm thấy lệnh claude, bạn chưa cài Claude Code. README chỉ dẫn đến trang chính thức của Claude Code để cài.

B.Thêm marketplace và cài plugin

Trong màn hình Claude Code, 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 đó:

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

Chỗ người mới hay vấp là gõ nhầm lệnh /plugin ngoài terminal thường. Lệnh này chỉ có tác dụng trong Claude Code.

C.Chạy setup

Terminal
/seo setup

Lệnh này chuẩn bị mọi thứ plugin cần: môi trường Python riêng và một trình duyệt headless. README nhấn mạnh nó không đụng vào phần còn lại của hệ thống. Chờ nó chạy xong rồi hãy sang bước kiểm tra.

D.Cách cài thủ công (nếu không muốn dùng /plugin)

README có thêm cách cài bằng git clone. Trên macOS và Linux:

Terminal
git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git
bash claude-seo/install.sh

Trên Windows, mở PowerShell:

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

Tác giả cố ý dùng git clone thay vì kiểu tải-và-chạy-ngay, để bạn mở file install.ps1 hoặc install.sh ra đọc trước khi chạy. Bạn nên tập thói quen này với mọi script cài đặt.

Muốn gỡ cài đặt, nếu cài dạng plugin thì dùng lệnh sau trong Claude Code:

Terminal
/plugin uninstall claude-seo@agricidaniel-claude-seo

Nếu cài thủ công thì chạy:

Terminal
git clone --depth 1 https://github.com/AgriciDaniel/claude-seo.git
bash claude-seo/uninstall.sh

IV.Kiểm tra đã chạy được chưa

Có hai cách kiểm tra nhanh, đều lấy từ README:

  1. Gõ /seo doctor. Lệnh này kiểm tra môi trường chạy đã sẵn sàng chưa mà không thay đổi gì trên máy. Bạn có thể chạy nó bất cứ lúc nào.
  2. Gõ /seo để xem danh sách toàn bộ lệnh. Nếu danh sách hiện ra, plugin đã được nhận.

Sau đó thử audit thật trên một website của bạn:

Terminal
/seo audit https://example.com

Kết quả đúng là một báo cáo có điểm số và kế hoạch hành động theo mức ưu tiên. Báo cáo lưu dưới dạng file Markdown trên máy bạn.

Một lần /seo audit đầy đủ tốn hạn mức Claude nhiều hơn kiểm tra một trang. Theo README, 5 agent cần suy luận nhiều chạy bằng Opus, phần còn lại chạy bằng Sonnet. Nếu lo về chi phí, bạn có thể đổi model của từng agent trong file tương ứng ở thư mục agents/.

V.Dùng vào việc thật

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 truy cập từ Google không tăng. Bạn mở Claude Code và gõ:

Terminal
/seo ecommerce https://tenshopcuaban.vn

Lệnh này kiểm tra SEO thương mại điện tử cho trang sản phẩm. Bạn nhận một báo cáo chỉ ra trang nào thiếu dữ liệu có cấu trúc, trang nào nội dung mỏng. Bạn cũng có thể dùng /seo images để xem ảnh sản phẩm đã tối ưu chưa. Bạn đưa danh sách việc cần sửa cho người làm web, hoặc tự sửa từng mục theo thứ tự plugin xếp.

B.Chủ quán, chủ cơ sở dịch vụ 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ê, khách chủ yếu tìm qua Google Maps. Bạn chạy:

Terminal
/seo local https://tenquancuaban.vn

Plugin kiểm tra Google Business Profile, đánh giá, citation và map pack. Nếu muốn đi sâu hơn, có thêm /seo maps. Kết quả cho bạn biết hồ sơ doanh nghiệp còn thiếu thông tin gì và đối thủ gần bạn đang làm tốt hơn ở đâu.

C.Người viết nội dung cần lên dàn ý bài mới

Bạn phụ trách blog công ty và cần bài mới về một chủ đề. Thay vì đoán từ khóa, bạn gõ:

Terminal
/seo content-brief ten-chu-de-cua-ban
/seo cluster ten-tu-khoa-cua-ban

Lệnh đầu tạo content brief gồm từ khóa mục tiêu, dàn ý và gợi ý liên kết nội bộ. Lệnh sau gom các từ khóa liên quan thành nhóm dựa trên kết quả tìm kiếm thật. Bạn nhận một kế hoạch bài viết rõ ràng để giao cho cả nhóm.

Cái hay không phải là nó tìm ra bao nhiêu lỗi, mà là nó xếp cho bạn biết sửa cái nào trước.

Ông T

D.Lập trình viên hoặc freelancer kiểm tra trước khi gửi báo giá

Bạn nhận làm web cho khách và muốn có số liệu để mở đầu cuộc gọi. Bạn chạy lần lượt:

Terminal
/seo page https://example.com/pricing
/seo schema https://example.com
/seo geo https://example.com

Lệnh đầu phân tích sâu một trang. Lệnh thứ hai kiểm tra và tạo schema, bạn nhận được mã JSON-LD để dán vào web. Lệnh thứ ba cho biết mức sẵn sàng với AI search. Sau khi sửa xong, bạn có thể dùng /seo drift baseline <url> để lưu mốc, rồi /seo drift compare <url> để so sánh thay đổi. Cách này giúp bạn chứng minh việc mình làm có tác dụng.

VI.Lỗi hay gặp và cách xử lý

Gõ lệnh /seo mà không thấy phản hồi. Thường do plugin chưa cài xong hoặc bạn đang gõ ngoài Claude Code. Hãy chắc là bạn đang ở trong màn hình claude, chạy lại hai lệnh /plugin, rồi gõ /seo doctor để xem môi trường thiếu gì.

Phiên bản Claude Code hoặc Python không đúng. README yêu cầu Claude Code từ 1.0.33 và Python từ 3.11 đến 3.14. Nếu máy bạn dùng Python cũ hơn hoặc mới hơn khoảng này, cài đặt có thể lỗi. Hãy kiểm tra phiên bản trước, nâng cấp hoặc cài đúng bản rồi chạy lại /seo setup.

PowerShell trên Windows chặn chạy script. Lệnh trong README dùng -ExecutionPolicy Bypass cho riêng lần chạy install.ps1. Đừng tự hạ chính sách bảo mật của cả máy. Hãy mở file install.ps1 ra đọc trước, thấy ổn thì chạy đúng lệnh README ghi.

Điểm Core Web Vitals hoặc chỉ mục không sát thực tế. README nói rõ: khi chưa có Google API key, Core Web Vitals chỉ là ước tính trong phòng lab và tình trạng lập chỉ mục là suy ra từ trang. Muốn số thật, bạn chạy /seo google setup và kết nối các API Google miễn phí.

Kết quả nhiễu với trang chỉ hiện nội dung sau khi cuộn hoặc bấm. Đây là giới hạn tác giả đã nêu. Với loại trang này, hãy xem báo cáo như gợi ý, không phải kết luận cuối cùng, và kiểm tra lại bằng mắt.

Hết hạn mức Claude giữa chừng. Audit đầy đủ dùng nhiều agent, tốn hạn mức hơn kiểm tra một trang. Hãy bắt đầu bằng /seo page để thử, hoặc đổi model của agent trong thư mục agents/ nếu cần tiết kiệm.

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ố website theo lời tác giả. Cài nhanh, không cần API key để bắt đầu. Báo cáo giải thích lý do và cách kiểm tra từng đề xuất. Phần AI search được làm khá sâu. Dữ liệu báo cáo lưu trên máy bạn dưới dạng file. Repo vẫn được cập nhật trong 3 tháng gần đây.

Giới hạn. Plugin cần Claude Code, nên bạn phải có gói phù hợp và chịu chi phí hạn mức khi chạy audit lớn. README nói rõ các trang nặng JavaScript tương tác có thể cho kết quả nhiễu. Và các trang, dữ liệu bạn phân tích sẽ được gửi tới Claude, giống mọi thứ khác bạn làm trong Claude Code. Chi tiết về nguồn dữ liệu công khai nó đọc được ghi trong file PRIVACY.md của repo.

Khi nào nên chọn cách khác. Tác giả thừa nhận các công cụ như Screaming Frog crawl nhanh và sâu hơn. Các bộ SEO lớn có cơ sở dữ liệu backlink riêng. Nếu bạn cần thu thập hàng trăm nghìn trang hoặc dữ liệu backlink quy mô lớn, hãy dùng công cụ chuyên dụng. Với đa số website nhỏ và vừa, claude-seo là một cách rẻ để có bản kiểm tra ban đầu và kế hoạch rõ ràng. Nhiều người dùng cả hai loại công cụ cùng lúc.

4.7/5 · Ông T chấm

Chưa có độc giả chấm

Bài này có ích với bạn không?

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, theo README không tính phí theo website, không giới hạn lượt dùng và không theo dõi. Bạn chỉ cần Claude Code. Một vài tiện ích mở rộng tùy chọn kết nối với dịch vụ trả phí và bạn dùng tài khoản của riêng mình, nhưng plugin chạy đầy đủ mà không cần chúng.

Tôi có cần API key không?

Không bắt buộc. README nói plugin chạy được ngay. Nếu muốn dữ liệu thực địa, bạn có thể kết nối các API Google miễn phí (PageSpeed Insights, Chrome UX Report, Search Console, GA4) bằng lệnh /seo google setup. Theo tác giả, key của bạn được giữ trên máy bạn.

Có chạy được trên Windows không?

Có. README có hướng dẫn cài thủ công cho Windows bằng PowerShell, và cũng có cách cài qua lệnh /plugin ngay trong Claude Code. Yêu cầu chung là Claude Code từ 1.0.33 và Python từ 3.11 đến 3.14.

Cần GPU hoặc máy cấu hình mạnh không?

Tư liệu không nói gì về yêu cầu GPU hay cấu hình phần cứng. Phần xử lý AI chạy qua Claude Code. Lệnh /seo setup chỉ tạo môi trường Python riêng và một trình duyệt headless.

Dữ liệu của tôi có rời khỏi máy không?

Plugin chạy trong Claude Code, nên các trang và dữ liệu nó phân tích được gửi tới Claude, giống mọi việc khác bạn làm 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ự kết nối tiện ích hoặc API. Danh sách đầy đủ nằm trong file PRIVACY.md.

claude-seo khác Screaming Frog hay các công cụ SEO khác thế nào?

Theo tác giả, 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 tập trung giải thích điều nó tìm thấy, xếp theo mức tác động, phủ AI search sâu và cho bạn hỏi tiếp bằng ngôn ngữ thường. Nhiều người dùng cả hai.

Nó có audit được website viết bằng React, Next.js hay Vue không?

Có. README nói khi một trang cần JavaScript mới hiện nội dung, plugin tự mở trang trong trình duyệt headless để audit như khách truy cập thấy. Tuy vậy, trang chỉ tải nội dung sau khi cuộn hoặc bấm có thể cho kết quả nhiễu.

Chuyển nhanh tới mục

  1. I.claude-seo làm được gì
  2. II.Cần chuẩn bị gì
  3. III.Cài đặt từng bước
    1. A.Mở Claude Code
    2. B.Thêm marketplace và cài plugin
    3. C.Chạy setup
    4. D.Cách cài thủ công (nếu không muốn dùng /plugin)
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Chủ shop online muốn biết trang sản phẩm yếu ở đâu
    2. B.Chủ quán, chủ cơ sở dịch vụ muốn lên bản đồ
    3. C.Người viết nội dung cần lên dàn ý bài mới
    4. D.Lập trình viên hoặc freelancer kiểm tra trước khi gửi báo giá
  6. VI.Lỗi hay gặp và cách xử lý
  7. VII.Có nên dùng không

Repo & Skill · 13/11/2026 · 11 phút đọc

Garden Skills: bộ skill thiết kế web, tạo ảnh, làm video cho AI — hướng dẫn cài đặt và dùng

Garden Skills là bộ sưu tập Agent Skills (kỹ năng cho AI) của tác giả ConardLi, dùng được với Claude Code, Cursor, Codex và các AI coding agent khác. Mỗi skill dạy agent làm tốt một việc như thiết kế trang web, tạo ảnh, làm video bằng code, biến tài liệu thành bài viết đẹp. Cài không khó, nhưng README có nhiều cách cài nên bạn cần chọn một cách hợp với công cụ đang dùng.

Repo & Skill · 13/11/2026 · 15 phút đọc

thesysdev/openui: xây giao diện AI dạng streaming — hướng dẫn cài đặt và dùng

OpenUI là framework full-stack, độc lập framework, giúp mô hình AI sinh giao diện có cấu trúc và hiển thị dần khi dữ liệu streaming về. Bạn có thể dựng nhanh một ứng dụng chat bằng CLI hoặc cài từng gói cho React, Vue, Svelte, Angular và LangChain. Việc bắt đầu khá đơn giản nếu máy có đúng phiên bản Node; README chưa ghi đầy đủ lệnh chạy ứng dụng sau khi scaffold.

Repo & Skill · 13/11/2026 · 11 phút đọc

Ruflo: điều phối nhóm agent AI cho Claude Code và Codex — hướng dẫn cài đặt và dùng

Ruflo (trước đây là Claude Flow) là một agent harness: lớp công cụ bao quanh Claude Code và Codex, bổ sung nhiều agent chuyên biệt, bộ nhớ qua các phiên và khả năng chia việc cho nhóm agent. Cài bằng một lệnh `npx ruflo@latest init` trong thư mục dự án, cần Node 20 trở lên. Cài khá dễ, nhưng hệ thống rất rộng nên bạn nên bắt đầu từ một tác vụ nhỏ.