Claude SEO

1. Claude SEO là gì?

Claude SEO là một plugin (phần mở rộng) cho Claude Code, giúp bạn "khám sức khỏe" SEO của một trang web bằng cách gõ lệnh. SEO là việc tối ưu để trang web dễ được tìm thấy trên Google và các công cụ tìm kiếm. Bạn đưa cho nó một địa chỉ web, nó kiểm tra phần kỹ thuật, chất lượng nội dung, dữ liệu có cấu trúc (schema), khả năng xuất hiện trong kết quả tìm kiếm của AI, rồi trả về một bản báo cáo kèm danh sách việc cần làm theo thứ tự ưu tiên.

Nó có thể thay phần việc "rà soát ban đầu" mà bạn thường phải thuê người làm hoặc mua công cụ trả phí theo tháng. Bản thân plugin miễn phí, mã nguồn mở, giấy phép MIT, không tính tiền theo tên miền. Khoản phải trả là tài khoản Claude Code để chạy nó.

Nói thẳng: Claude SEO không phải một ứng dụng có giao diện. Nó chạy bên trong Claude Code, tức là trong cửa sổ dòng lệnh. Bạn không cần biết lập trình để gõ lệnh và đọc báo cáo, nhưng cần chịu khó cài vài thứ ở mục 2.

Hợp với bạn nếu:

• Bạn có website (blog, trang bán hàng, trang công ty) và muốn biết nó đang yếu ở đâu.
• Bạn làm SEO tự do hoặc ở agency, cần một bản rà soát nhanh trước khi tư vấn cho khách.
• Bạn đã có hoặc sẵn sàng đăng ký Claude Code.

Chưa hợp nếu:

• Bạn muốn một trang web để dán link vào rồi bấm nút. Claude SEO không có bản web.
• Bạn chỉ dùng điện thoại. Cần máy tính.
• Bạn cần dữ liệu backlink hay lượng tìm kiếm từ khóa đầy đủ. Những thứ đó đòi tài khoản dịch vụ bên ngoài (Ahrefs, DataForSEO…) mà bạn phải tự có.
• Bạn dùng Codex thay cho Claude Code. Tác giả có một bản riêng tên Codex SEO tại https://github.com/AgriciDaniel/codex-seo

2. Cần chuẩn bị gì?

• Máy tính chạy Windows, macOS hoặc Linux, có mạng.
• Claude Code. Trợ lý AI của Anthropic chạy trong cửa sổ dòng lệnh. Cách cài plugin ở mục 3 cần Claude Code bản 1.0.33 trở lên. Xem cách cài và các gói trả phí tại https://code.claude.com
• Python 3.10 trở lên. Python là ngôn ngữ lập trình mà các đoạn phân tích của plugin dùng để chạy. Dự án khuyên cài bản 3.11 hoặc mới hơn vì 3.10 sắp hết hỗ trợ. Tải tại https://www.python.org. Trên Windows, khi cài nhớ tích ô "Add python.exe to PATH".
• Git (chỉ cần nếu cài thủ công theo cách 2). Công cụ tải mã nguồn từ GitHub. Tải tại https://git-scm.com

Không bắt buộc:

• Khóa API của Google nếu muốn số liệu thật từ PageSpeed, Search Console, Google Analytics. Trình hướng dẫn cài khóa là /seo google setup; hạn mức và giá hiện hành xem ở trang của Google. Không có khóa thì plugin vẫn chạy, chỉ là chỉ số tốc độ trang là số ước tính.
• Tài khoản dịch vụ trả phí (DataForSEO, Ahrefs, SE Ranking, Profound) nếu bạn muốn bật các phần mở rộng tương ứng.

Lưu ý: Từ bản 2.3.1, năm trong số các agent của plugin chạy trên mô hình Opus (mô hình đắt hơn của Claude). README ghi rõ một lần kiểm tra toàn trang vì thế tốn hạn mức hơn trước.

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

Bước 1: Mở Claude Code

Mở cửa sổ dòng lệnh, gõ lệnh sau rồi Enter:

claude

Đúng là khi bạn thấy màn hình chào của Claude Code và một ô để gõ. Nếu máy báo không nhận ra lệnh claude, bạn chưa cài Claude Code; quay lại mục 2.

Bước 2: Thêm nguồn plugin và cài

Gõ lần lượt hai dòng sau bên trong Claude Code (mỗi dòng xong thì Enter, chờ chạy xong mới gõ dòng kế):

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

Đúng là khi Claude Code báo đã thêm nguồn và đã cài plugin, không có dòng lỗi.

Bước 3: Chạy bước thiết lập một lần

/seo setup

Lệnh này tạo một môi trường Python riêng cho plugin và tải trình duyệt Chromium (dùng để đọc các trang web dựng bằng JavaScript và chụp màn hình). Nó không cài gì vào Python chung của máy bạn. Bước này có thể mất vài phút vì phải tải về.

Bước 4: Kiểm tra

/seo doctor

Lệnh này chỉ đọc và báo tình trạng, không thay đổi gì trên máy. Đúng là khi các mục đều ở trạng thái sẵn sàng. Nếu riêng phần Chromium lỗi, plugin vẫn phân tích được các trang thông thường.

Cách 2: Cài thủ công trên Windows (PowerShell)

Dùng khi cách plugin ở trên không được. Cần có Git.

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

Dòng đầu tải mã nguồn về thư mục claude-seo. Dòng hai chạy trình cài. Tác giả cố ý dùng cách này để bạn có thể mở file install.ps1 ra xem trước khi chạy.

Cách 2: Cài thủ công trên macOS / Linux

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

Sau khi cài thủ công, mở Claude Code và gõ /seo. Đúng là khi nó hiện phần trợ giúp hoặc hỏi bạn địa chỉ web.

4. Dùng lần đầu

Vẫn ở trong Claude Code, thử kiểm tra một trang đơn trước cho nhanh. Thay địa chỉ bằng trang của bạn:

/seo page https://example.com/gioi-thieu

Bạn sẽ thấy Claude Code đọc trang đó rồi trả về nhận xét về tiêu đề, mô tả, cấu trúc heading, nội dung, schema và ảnh.

Khi đã quen, chạy kiểm tra toàn trang:

/seo audit https://example.com

Lúc này plugin chia việc cho nhiều agent chạy song song. README ước lượng một lần kiểm tra mất khoảng 10 đến 15 phút; trang lớn sẽ lâu hơn vì nó đọc tối đa 500 trang. Kết quả là các file báo cáo dạng Markdown lưu ngay trên máy bạn (ví dụ FULL-AUDIT-REPORT.md), gồm điểm tổng trên thang 0 đến 100 và danh sách việc cần sửa xếp theo mức ưu tiên. Mỗi khuyến nghị có kèm cách kiểm tra xem nó có hiệu quả hay không.

Vài lệnh khác đáng thử:

Bạn muốn	Lệnh
Kiểm tra dữ liệu có cấu trúc (schema)	/seo schema https://example.com
Xem trang có dễ được AI trích dẫn không	/seo geo https://example.com
Kiểm tra phần kỹ thuật	/seo technical https://example.com
Đánh giá chất lượng nội dung	/seo content https://example.com
SEO địa phương (Google Business Profile, đánh giá)	/seo local https://example.com
Kết nối dữ liệu Google	/seo google setup

Danh sách đầy đủ các lệnh nằm ở https://github.com/AgriciDaniel/claude-seo/blob/main/docs/COMMANDS.md

5. Lỗi thường gặp và cách sửa

Gõ /seo nhưng Claude Code không nhận ra lệnh

• Nguyên nhân: plugin chưa được cài hoặc chưa được nạp.
• Cách sửa: gõ /plugin list xem có claude-seo không. Nếu không có, chạy lại hai lệnh ở Bước 2. Sau đó thoát Claude Code và mở lại.

Báo ModuleNotFoundError: No module named 'requests' (hoặc thiếu module khác)

• Nguyên nhân: môi trường Python riêng của plugin chưa được tạo xong.
• Cách sửa: chạy /seo doctor để xem thiếu gì, rồi /seo setup để tạo lại. Tài liệu dặn không tự cài lẻ từng gói bằng pip.

Windows báo python is not recognized

• Nguyên nhân: chưa cài Python, hoặc lúc cài chưa tích ô thêm vào PATH.
• Cách sửa: cài lại Python từ https://www.python.org và tích "Add to PATH", mở lại cửa sổ dòng lệnh, chạy lại trình cài rồi /seo doctor.

Báo Executable doesn't exist khi chụp màn hình hoặc đọc trang JavaScript

• Nguyên nhân: trình duyệt Chromium chưa được tải về.
• Cách sửa: chạy lại /seo setup, sau đó /seo doctor.

Báo Agent 'seo-technical' not found

• Nguyên nhân: các agent con chưa được nạp.
• Cách sửa: với bản plugin, kiểm tra /plugin list rồi cài lại claude-seo@agricidaniel-claude-seo.

Báo Request timed out after 30 seconds

• Nguyên nhân: trang đích chậm, mạng yếu, hoặc trang đó chặn truy cập tự động.
• Cách sửa: thử lại sau; kiểm tra mạng. Một số trang chặn công cụ tự động thì không có cách vòng.

Kiểm tra toàn trang chạy quá lâu

• Nguyên nhân: trang có nhiều trang con hoặc phản hồi chậm.
• Cách sửa: dùng /seo page cho từng địa chỉ cụ thể thay vì /seo audit.

Trên macOS / Linux báo Permission denied khi chạy script

• Cách sửa (bản cài thủ công):

chmod +x ~/.claude/skills/seo/scripts/*.py

Các lỗi khác được ghi tại https://github.com/AgriciDaniel/claude-seo/blob/main/docs/TROUBLESHOOTING.md

6. Gỡ cài đặt / cập nhật

Gỡ bản plugin

Gõ trong Claude Code:

/plugin uninstall claude-seo@agricidaniel-claude-seo
/plugin marketplace remove AgriciDaniel/claude-seo

Gỡ bản cài thủ công

macOS / Linux:

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

Trên Windows, kho mã có sẵn file uninstall.ps1 cho bản cài thủ công; chạy nó theo cùng cách bạn đã chạy install.ps1. Trình gỡ xóa skill chính, các skill con và các agent của plugin trong thư mục .claude của bạn.

Nếu bạn đã lưu khóa Google API, chúng nằm trong thư mục ~/.config/claude-seo/; xóa thư mục này nếu không dùng nữa.

Cập nhật

README không có phần hướng dẫn cập nhật riêng. Cách đơn giản với bản plugin: chạy hai lệnh gỡ ở trên, làm lại Bước 2, rồi chạy /seo setup để làm mới môi trường. Phiên bản mới nhất tại ngày viết là v2.4.1 (29/9/2026); xem các bản phát hành tại https://github.com/AgriciDaniel/claude-seo/releases

7. Câu hỏi hay gặp

Có mất tiền không? Plugin miễn phí, không giới hạn số lần dùng do plugin đặt ra. Bạn trả tiền cho Claude Code. Các phần mở rộng nối với DataForSEO, Ahrefs, Profound, SE Ranking cần tài khoản riêng của những dịch vụ đó và hoàn toàn tùy chọn.

Có cần mạng không? Có. Plugin phải tải trang web bạn muốn kiểm tra, và Claude Code cũng cần mạng.

Dữ liệu của tôi có bị gửi đi đâu không? Theo file PRIVACY của dự án: phần lõi không gọi dịch vụ bên thứ ba nào, không có theo dõi hay thống kê sử dụng, báo cáo lưu trên máy bạn. Nó chỉ truy cập chính trang web bạn yêu cầu kiểm tra. Khi bạn bật phần mở rộng nào thì địa chỉ web bạn phân tích sẽ được gửi tới dịch vụ đó. Ngoài ra, nội dung bạn làm việc trong Claude Code vẫn đi qua Anthropic theo chính sách của Claude Code.

Có cần khóa API Google không? Không bắt buộc. Không có khóa thì chỉ số Core Web Vitals là số đo thử trong phòng thí nghiệm, và tình trạng lập chỉ mục chỉ được suy đoán từ tín hiệu trên trang.

Nó có thay được Screaming Frog hay Ahrefs không? Tác giả nói rõ là không nhằm thay thế. Screaming Frog quét liên kết sâu và nhanh hơn, Ahrefs có kho dữ liệu backlink riêng. Claude SEO mạnh ở phần tổng hợp, giải thích và gợi ý việc cần làm.