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

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

10 phút đọcCập nhật
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ở (giấy phép MIT) chạy trong Claude Code. Bạn đưa một địa chỉ website, nó kiểm tra SEO kỹ thuật, nội dung, schema, AI search, SEO địa phương và thương mại điện tử, rồi đưa ra kế hoạch hành động theo thứ tự ưu tiên. Cài bằng ba lệnh trong Claude Code, không bắt buộc API key.

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ó tự kiểm tra như một chuyên viên SEO rồi trả về bản kế hoạch sửa lỗi, xếp theo việc nào quan trọng nhất. Theo tác giả, một lần kiểm tra toàn site mất khoảng 10 đến 15 phút.

Vấn đề nó giải quyết rất quen thuộc. Website của bạn có thể chậm, thiếu dữ liệu có cấu trúc, nội dung mỏng, hoặc chưa được các công cụ AI như ChatGPT, Perplexity, Gemini trích dẫn. Thuê agency thì tốn kém, dùng phần mềm audit thì mất phí hàng tháng và đưa ra một đống cảnh báo khó hiểu. claude-seo giải thích từng lỗi, nói vì sao nó quan trọng và làm sao biết đã sửa xong.

Repo phù hợp với chủ website, người làm marketing, freelancer SEO và lập trình viên đang dùng Claude Code. Điểm đáng giá nhất: ngoài SEO truyền thống, nó kiểm tra cả mức sẵn sàng cho tìm kiếm bằng AI (GEO). Hiện repo có khoảng 28.583 sao và 3.670 fork, giấy phép MIT, và vẫn được cập nhật trong vài tháng gần đây. Bạn có thể xem video ngắn bên dưới để thấy cách nó chạy.

Plugin

AgriciDaniel/claude-seo

Plugin miễn phí cho Claude Code: nhập địa chỉ website, nhận bản kiểm tra SEO và kế hoạch sửa lỗi xếp theo mức ưu tiên, gồm cả SEO cho AI search.

★ 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ả mô tả repo gồm 26 sub-skill và 19 sub-agent. Hiểu đơn giản: mỗi agent là một chuyên viên lo một mảng, và khi kiểm tra toàn site có thể có tới 17 agent làm việc song song. Các mảng 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ệnh là /seo technical.
  • 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ủ đề. Lệnh là /seo content.
  • 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. Lệnh là /seo schema.
  • Tìm kiếm bằng AI (GEO). Chấm xem trang của bạn dễ được trích dẫn đến đâu, kiểm tra AI crawler có vào được không, và nhìn sự hiện diện thương hiệu trên Wikipedia, Reddit, YouTube, LinkedIn. Lệnh là /seo geo. Thêm /seo agentic để xem các AI agent dùng site của bạn có thuận lợi không (llms.txt, Markdown, WebMCP).
  • SEO địa phương và thương mại điện tử. Google Business Profile, đánh giá, map pack, trang sản phẩm, site đa ngôn ngữ. Các lệnh /seo local, /seo maps, /seo ecommerce, /seo hreflang.
  • Lập kế hoạch nội dung. /seo content-brief tạo dàn ý bài viết, /seo cluster gom từ khoá theo cụm, /seo plan lập chiến lược theo loại hình (saas, local, ecommerce, publisher, agency).
  • Theo dõi thay đổi. /seo drift chụp bản ghi trạng thái SEO rồi so sánh lần sau, giúp bạn phát hiện trang bị hỏng giữa hai lần kiểm tra.
  • Dữ liệu Google. /seo google kết nối PageSpeed, Chrome UX Report, Search Console, Indexing, GA4 và có thể xuất báo cáo PDF.

Báo cáo được lưu thành file Markdown, PDF và JSON trên máy bạn. Chín tiện ích mở rộng tuỳ chọn (như SE Ranking, Profound, Bing Webmaster, Unlighthouse, tạo ảnh AI) bổ sung dữ liệu trực tiếp, nhưng tác giả nói công cụ chạy đầy đủ mà không cần chúng.

II.Cần chuẩn bị gì

Theo tư liệu của repo, bạn cần:

  • Claude Code phiên bản 1.0.33 trở lên. Đây là điều kiện chính. Dùng Claude Code cần gói Claude của bạn, và README cho biết claude-seo miễn phí «cùng gói Claude Code của bạn».
  • Python từ 3.11 đến 3.14. File pyproject.toml ghi yêu cầu Python 3.11 trở lên. Lệnh /seo setup sẽ tạo môi trường Python riêng và cài trình duyệt headless Chromium, không đụng vào phần còn lại của máy.
  • Git, nếu bạn chọn cách cài thủ công.
  • API key: không bắt buộc. README nói công cụ chạy ngay được. Muốn dữ liệu thực từ Google (PageSpeed Insights, Chrome UX Report, Search Console, GA4) thì chạy /seo google setup.
  • Hệ điều hành: repo có install.sh cho macOS/Linux và install.ps1 cho Windows PowerShell. README không nêu yêu cầu phần cứng hay GPU.

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

  1. Mở Claude CodeChạy lệnh claude trong terminal, kiểm tra phiên bản từ 1.0.33 trở lên
  2. Thêm marketplaceDán lệnh /plugin marketplace add vào Claude Code
  3. Cài pluginDán lệnh /plugin install để cài claude-seo
  4. Chạy setupGõ /seo setup để tạo môi trường Python và trình duyệt headless
  5. Kiểm traGõ /seo doctor để xác nhận mọi thứ sẵn sàng

A.Mở Claude Code

Cách cài chính là chạy ba lệnh ngay bên trong Claude Code, không phải trong cửa sổ terminal thường. Bạn mở terminal (Terminal trên macOS, PowerShell trên Windows), đi tới thư mục dự án nếu muốn, rồi gõ:

Terminal
claude

Đây là lệnh khởi động Claude Code. Chỗ người mới hay vấp: các lệnh bắt đầu bằng dấu / chỉ có tác dụng sau khi bạn đã vào Claude Code. Nếu gõ chúng ở terminal thường, máy sẽ báo không hiểu lệnh.

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

Trong Claude Code, chạy lần lượt hai lệnh sau (README ghi cả ba lệnh trong một khối, mình tách ra cho dễ theo dõi):

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

Lệnh đầu đăng ký nguồn plugin từ GitHub. Lệnh thứ hai cài plugin từ nguồn đó. Hãy chép nguyên văn, kể cả phần @agricidaniel-claude-seo.

C.Chạy setup

Terminal
/seo setup

Lệnh này chuẩn bị mọi thứ claude-seo 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 trình duyệt, bạn cứ để nó chạy xong.

D.Cách cài thủ công trên macOS và Linux

Nếu không muốn dùng plugin marketplace, bạn có thể tải repo về rồi chạy script cài. Hai lệnh này chạy ở terminal thường:

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

Lệnh đầu tải mã nguồn về thư mục claude-seo (cờ --depth 1 chỉ lấy bản mới nhất cho nhẹ). Lệnh sau chạy script cài đặt. Nếu muốn đọc script trước khi chạy, README còn có cách tải riêng install.sh bằng curl, xem lại nội dung bằng cat install.sh rồi mới chạy bash install.sh.

E.Cách cài thủ công trên Windows

Mở PowerShell, rồi chạy:

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

Tác giả khuyên dùng git clone thay vì kiểu irm | iex, vì cách đó tải và chạy mã từ xa mà không kiểm tra. Với git clone, bạn mở file claude-seo\install.ps1 ra đọc trước khi chạy.

Cài thủ công nghĩa là bạn chạy một script trên máy mình. Hãy mở và đọc install.sh hoặc install.ps1 trước khi chạy, chỉ tải từ đúng kho GitHub của tác giả.

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

Theo README, có hai cách để biết cài thành công:

Terminal
/seo doctor

Lệnh này kiểm tra môi trường đã sẵn sàng chưa mà không thay đổi hệ thống. Nếu có thành phần nào thiếu, quay lại chạy /seo setup.

Cách thứ hai: gõ /seo trong Claude Code. README cho biết lệnh này hiển thị toàn bộ các lệnh có sẵn. Thấy danh sách lệnh như audit, page, technical, geo, schema… là plugin đã nhận.

Rồi bạn thử một trang bất kỳ của mình:

Terminal
/seo page https://example.com

Thay https://example.com bằng địa chỉ trang thật của bạn. Kết quả mong đợi là một báo cáo phân tích trang kèm các gợi ý sửa.

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

Báo cáo của repo không chỉ liệt kê lỗi. Mỗi gợi ý nói nó dựa trên gì, phụ thuộc vào gì và bạn sẽ biết đã sửa thành công bằng cách nào.

Một bản kế hoạch xếp theo ưu tiên có giá trị hơn một trăm cảnh báo không ai biết sửa cái nào trước.

Ông T

A.Chủ shop kiểm tra website bán hàng

Bạn có một shop online và thấy đơn hàng từ Google đang giảm. Mở Claude Code và chạy:

Terminal
claude

/seo audit https://example.com

Claude SEO nhận diện loại hình kinh doanh, rồi các agent kiểm tra song song kỹ thuật, nội dung, schema, tốc độ và AI search. Kết quả là kế hoạch hành động xếp theo mức quan trọng. Bạn đưa danh sách này cho người làm web, hoặc hỏi tiếp Claude bằng tiếng thường để nó giải thích từng mục. Nếu shop bán sản phẩm, thử thêm /seo ecommerce https://example.com.

B.Nhân viên marketing viết bài mới

Bạn cần ra bài blog cho một chủ đề mới nhưng chưa biết nên viết gì quanh nó. Dùng:

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

Lệnh đầu tạo bản brief gồm từ khoá mục tiêu, dàn ý và gợi ý liên kết nội bộ. Lệnh sau gom từ khoá thành các cụm theo kết quả tìm kiếm thực tế, để bạn biết nên viết những bài nào đi cùng nhau. Bạn thay phần tên chủ đề và từ khoá bằng nội dung của mình.

C.Chủ cửa hàng địa phương muốn lên bản đồ

Bạn có quán cà phê hoặc phòng khám, cần khách tìm thấy trên Google Maps. Chạy:

Terminal
/seo local https://example.com

Lệnh này xem hồ sơ Google Business Profile, trích dẫn (citation), đánh giá và vị trí trong map pack. Bạn nhận được danh sách việc cần sửa, ví dụ thông tin chưa khớp giữa các nơi hoặc thiếu dữ liệu có cấu trúc.

D.Dev sửa schema và kiểm tra khả năng được AI trích dẫn

Bạn là lập trình viên vừa làm xong site và muốn chắc chắn markup đúng:

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

Lệnh đầu phát hiện và kiểm tra Schema.org hiện có, đồng thời sinh mã mới cho phần còn thiếu. Báo cáo mẫu trong README cho thấy cách nó chấm: đếm số khối JSON-LD, số lỗi nghiêm trọng, cảnh báo, kiểm tra đạt, rồi cho điểm tổng. Lệnh thứ hai chấm mức dễ trích dẫn của trang trong các câu trả lời AI. Nếu site dùng Next.js, React hay Vue, README nói claude-seo tự mở bằng trình duyệt headless nên vẫn kiểm tra đúng nội dung khách nhìn thấy.

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

Gõ lệnh /plugin hoặc /seo ở terminal thường. Các lệnh này chỉ chạy trong Claude Code. Hãy gõ claude trước, đợi giao diện mở ra rồi mới dán lệnh.

Claude Code quá cũ, không có lệnh /plugin. Repo yêu cầu bản 1.0.33 trở lên. Hãy cập nhật Claude Code lên bản mới hơn rồi thử lại.

/seo báo chưa sẵn sàng hoặc lỗi môi trường. Chạy /seo doctor để xem thiếu gì, sau đó chạy /seo setup để tạo lại môi trường Python và Chromium. Kiểm tra máy có Python trong khoảng 3.11 đến 3.14 theo README.

PowerShell không cho chạy script trên Windows. Lệnh trong README đã có -ExecutionPolicy Bypass cho riêng lần chạy này. Hãy chép nguyên lệnh và chạy từ thư mục chứa thư mục claude-seo vừa clone, để đường dẫn claude-seo\install.ps1 đúng.

Kết quả Core Web Vitals hoặc chỉ mục có vẻ ước lượng. Đúng vậy: README nói không có Google API key thì Core Web Vitals chỉ là ước tính phòng thí nghiệm và việc lập chỉ mục được suy ra từ trang. Muốn số liệu thực thì chạy /seo google setup. Ngoài ra, trang chỉ hiện nội dung chính sau khi cuộn hoặc bấm có thể cho kết quả nhiễu.

Gói Claude hết lượt nhanh khi audit toàn site. README cho biết năm agent cần suy luận nhiều chạy bằng Opus, phần còn lại bằng Sonnet, nên /seo audit tốn hơn kiểm tra một trang. Hãy bắt đầu bằng /seo page cho trang quan trọng. Bạn cũng có thể đổi model của từng agent trong file ở thư mục agents/.

VII.Có nên dùng không

Điểm mạnh. Miễn phí, mã nguồn mở, không giới hạn số site và không có theo dõi theo lời tác giả. Nó giải thích vấn đề bằng ngôn ngữ dễ hiểu, sắp xếp theo tác động, và bạn hỏi tiếp bằng câu thường. Phần AI search (GEO, agent readiness) khá hiếm trong các công cụ SEO. Báo cáo lưu trên máy bạn dưới dạng Markdown, PDF, JSON.

Giới hạn. Nó không thay thế công cụ crawl chuyên dụng. Chính README nói các công cụ như Screaming Frog crawl nhanh và sâu hơn, và các bộ SEO lớn có cơ sở dữ liệu backlink riêng. Nếu thiếu Google API, số liệu chỉ ở mức ước tính. Công cụ phải chạy trong Claude Code nên bạn cần có Claude Code, và dữ liệu trang được phân tích sẽ gửi tới Claude như mọi thứ khác bạn làm trong đó. Ngoài ra, hầu hết tài liệu và lệnh bằng tiếng Anh.

Khi nào nên chọn cách khác. Nếu site rất lớn và cần crawl hàng trăm nghìn trang, hoặc cần dữ liệu backlink và từ khoá chuyên sâu, hãy dùng thêm công cụ chuyên dụng. README nói nhiều người dùng cả hai. Nếu bạn chưa dùng Claude Code và không định dùng, repo này không dành cho bạn.

Với chủ website nhỏ, người làm marketing và dev đã dùng Claude Code, mình thấy đây là cách nhanh để có bản kiểm tra SEO có thứ tự ưu tiên trong vài phút, kèm khả năng kiểm tra AI search mà nhiều công cụ cũ còn thiếu.

4.3/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, không tính phí theo site, không giới hạn lượt dùng và không theo dõi theo lời tác giả. Bạn chỉ cần có Claude Code. Một vài tiện ích mở rộng tuỳ chọn kết nối tới dịch vụ trả phí mà bạn tự mang tài khoản, nhưng không bắt buộc.

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

Không bắt buộc, công cụ chạy ngay sau khi cài. Nếu muốn dữ liệu thực từ Google (PageSpeed Insights, Chrome UX Report, Search Console, GA4) thì chạy /seo google setup. README nói key của bạn được giữ trên máy bạn.

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

Có. Repo có install.ps1 cho Windows PowerShell, và cách cài bằng plugin trong Claude Code không phụ thuộc hệ điều hành. Yêu cầu là Claude Code 1.0.33 trở lên và Python từ 3.11 đến 3.14.

Có cần GPU hay máy mạnh không?

README không nêu yêu cầu GPU hay phần cứng riêng. Lệnh /seo setup chỉ cài môi trường Python riêng và trình duyệt headless. Phần suy luận chạy ở phía Claude.

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 (mô hình của Anthropic), 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. README nói 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; chi tiết nằm trong PRIVACY.md.

claude-seo khác Screaming Frog hay các phần mềm SEO khác thế nào?

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

Một lần audit toàn site có tốn nhiều lượt dùng Claude không?

Có thể tốn hơn kiểm tra thông thường. README cho biết năm agent cần suy luận nhiều chạy bằng Opus và phần còn lại bằng Sonnet, nên /seo audit dùng nhiều hơn /seo page. Bạn có thể đổi model của từng agent trong thư mục agents/.

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 trên macOS và Linux
    5. E.Cách cài thủ công trên Windows
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Chủ shop kiểm tra website bán hàng
    2. B.Nhân viên marketing viết bài mới
    3. C.Chủ cửa hàng địa phương muốn lên bản đồ
    4. D.Dev sửa schema và kiểm tra khả năng được AI trích dẫn
  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ỏ.