Công cụ SEO chạy ngay trong trợ lý lập trình của bạn là một phân loại mới hơn cả "công cụ SEO" lẫn "trợ lý lập trình". Claude SEO là một đại diện của loại này: một plugin miễn phí, giấy phép MIT cho Claude Code, biến trợ lý thành một công cụ kiểm toán SEO. Một plugin như vậy chỉ đáng giá bằng những phát hiện nó tạo ra, nên hướng dẫn này không phải một danh sách tính năng. Chúng tôi chạy hai công cụ của nó trên một website thật đang hoạt động, ghi lại những gì chúng báo cáo, rồi kiểm tra tay từng báo cáo so với chính các trang.
Trang web chúng tôi kiểm toán là trang này, The Smart AI Stack. Đó vừa là một tuyên bố minh bạch vừa là một ghi chú phương pháp: chúng tôi không thể chọn một mục tiêu dễ hơn, và mọi phát hiện dưới đây đều có thể kiểm tra lại bằng những tệp mà chúng tôi thuộc lòng.
Claude SEO là gì
Claude SEO là một plugin cho Claude Code, do Daniel Agrici xuất bản với giấy phép MIT, có song song hai phiên bản: một bản phát hành công khai mã nguồn mở và một bản mirror cộng đồng truy cập sớm. Phiên bản được cài trên máy của chúng tôi, và là nguồn của mọi con số trong hướng dẫn này đến từ plugin, là 2.2.4, mà README của nó mô tả 25 sub-skill và 18 agent chuyên trách. Trang công khai hiện quảng bá một bản phát hành mới hơn, v2.5.0, với các con số khác, nên hãy đọc nhãn phiên bản trước khi tin bất kỳ danh sách tính năng nào.
Mọi ảnh chụp trình duyệt dưới đây được chụp ngày 2026-11-03 trong một trình duyệt thật, với analytics tùy chọn bị từ chối thông qua chính điều khiển đồng thuận của trang khi nó xuất hiện. Hai hình là trình bày lại (formatted presentation) của kết quả đã chụp chứ không phải ảnh chụp màn hình: bảng so sánh bộ fetch (dựng từ hai kết quả fetch thô) và bảng chất lượng nội dung (dựng từ các tệp kết quả JSON gốc của bộ chấm điểm), mỗi hình được ghi nhãn như vậy.
Plugin bao phủ SEO kỹ thuật, E-E-A-T, schema markup, sitemap, Core Web Vitals, backlink, SEO địa phương, thương mại điện tử, và tối ưu hóa máy sinh (generative-engine optimization), tức là việc biến một trang thành loại nguồn mà trợ lý AI trích dẫn. Nó cài ở phạm vi user và thêm các lệnh slash. Một ghi chú phạm vi trung thực trước tiên: hướng dẫn này dùng hai công cụ cấp thấp của plugin, không phải các cuộc kiểm toán điều phối toàn phần. Việc các lệnh kiểm toán đầy đủ tìm ra gì trên một trang như trang này là câu hỏi mà hướng dẫn này chưa kiểm tra.
Chúng tôi thiết lập thế nào và đã chạy gì
Plugin đã được cài sẵn trên máy của chúng tôi ở phiên bản 2.2.4, nên hướng dẫn này không có phần cài đặt. Việc xác minh là trực tiếp: runtime manifest của plugin báo claude-seo, phiên bản 2.2.4, với trạng thái runtime cho thấy thành phần trình duyệt đã sẵn sàng. Không cần bước /seo setup cho những phần chúng tôi dùng.
Mục tiêu kiểm toán là năm trang đang chạy trên trang này, được lấy qua bộ fetch trang của plugin: trang chủ, một bài blog, một hướng dẫn, bài review Runway, và trang chủ tiếng Việt. Chúng tôi chạy bộ chấm điểm chất lượng nội dung của plugin trên mỗi trang đã lấy, và lấy robots.txt, sitemap.xml và llms.txt bằng cùng công cụ. Một lệnh, một kết quả, không có gì mô phỏng.
Hai điều về bộ fetch mà hóa ra đáng biết. Nó có cờ --render (never, auto, hoặc always) chuyển giao cho một renderer dựa trên Playwright dành cho các trang render bằng JavaScript. Trên trang tĩnh này, hai chế độ trả về cùng một trang, là kết quả mong đợi ở đây và chính xác là sự khác biệt mà cờ này tồn tại để tạo ra trên một trang render phía client. Và trên máy của chúng tôi, đường render cần cài thêm một gói Python còn thiếu trước khi chạy được; một lần cài plugin mới có thể gặp hoặc không.
Một giới hạn cần nêu trước mọi phát hiện: bộ chấm điểm chất lượng nội dung đọc văn bản của HTML bạn đưa cho nó. Trên một trang tĩnh như trang này, HTML chính là sản phẩm, nên không vấn đề gì. Một công cụ đo hỏng nghiêng về sự vắng mặt, và sự vắng mặt đồng ý với bất cứ điều gì bạn sắp kết luận; đưa cho bộ chấm điểm một cái vỏ JavaScript và nó sẽ chấm cái vỏ với cùng sự tự tin.
Kiểm toán tìm thấy gì, và việc kiểm tra cho thấy gì
Đọc của bộ chấm điểm trên năm trang nhất quán: điểm chất lượng nội dung từ 88 đến 91 trên cả năm, với không một đoạn phủ đầy (filler) nào bị gắn cờ và không một mẫu văn AI nào bị gắn cờ. Cờ duy nhất nó gắn, trên cả năm trang, là chiều lặp lại (repetition). Đó là các chiều chất lượng riêng của bộ chấm điểm, một đọc về văn phong của chúng tôi, không phải xếp hạng SEO hay điểm tổng thể của trang. Phần hữu ích của lần chạy đến từ việc chúng tôi làm tiếp theo, vì mỗi công cụ là một công cụ đo, và một công cụ đo cần một phép đối chứng.
Hai phát hiện sống sót qua kiểm tra như thật, một sụp đổ khi kiểm tra, và một là lần hụt suýt trúng kết thúc theo hướng có lợi cho trang.
Phát hiện một, thật: sitemap đã vượt khỏi tài liệu. Lần lấy sitemap của plugin đếm được 234 mục URL. Tài liệu riêng của trang web, viết trong giai đoạn đầu, nói 95 trang có thể lập chỉ mục. Chúng tôi đếm lại bằng một lần lấy độc lập, rồi bẻ con số theo ngôn ngữ: 78 tiếng Anh, 78 tiếng Việt, 78 tiếng Pháp. Trang web đã lớn lên; tài liệu thì chưa. Một công cụ làm cho sự lệch nhau hiện ra trong một lệnh đã làm đúng việc của nó, và tài liệu bây giờ cần cập nhật.
Phát hiện hai, thật, với ý nghĩa được các nguồn sơ cấp sửa lại: llms.txt được phân phối và liệt kê thư mục công cụ. Tệp nằm ở thư mục gốc, nêu lập trường của trang, và kết thúc đúng nơi thư mục công cụ kết thúc. Điều chúng tôi viết đầu tiên về tệp này đã quá mạnh: chúng tôi gọi nó là "chính xác tệp mà các trợ lý AI tìm đến". Trung thực hơn là nói những gì các nguồn hỗ trợ. llms.txt là một đề xuất mở về một sơ đồ trang máy đọc được cho các mô hình ngôn ngữ, công bố năm 2024, và việc trợ lý hay trình thu thập nào có đọc nó hay không là lựa chọn của bên tiêu thụ đó, không phải thuộc tính của tệp. Tài liệu riêng của Google về tính năng AI và Google Search nói điều ngược với "bắt buộc": "Bạn không cần tạo các tệp máy đọc được mới, tệp văn bản AI, hay markup để xuất hiện trong các tính năng này." Vậy phát hiện đứng ở mức sự thật phân phối (tệp tồn tại và nói điều nó nói) và là một phép kiểm tra plugin bao bọc, và suy luận dừng ở đó.
Phát hiện ba, cái bị sụp đổ: chúng tôi đầu tiên báo rằng hreflang nằm trong sitemap nhưng thiếu trong head của các trang. Điều đó sai, và công cụ đo hỏng là grep phân biệt chữ hoa chữ thường của chính chúng tôi. React tuần tự hóa thuộc tính thành hrefLang, và một phép tìm hreflang=" đã bỏ sót nó. Kiểm tra lại không phân biệt hoa thường, head của mọi trang lấy mẫu mang đủ bộ bốn tag: x-default, en, vi và fr, khớp với các bản thay thế xhtml:link của sitemap trên cả 234 URL. Trang làm hreflang đúng bằng cả hai cơ chế Google tài liệu hóa. Phát hiện kiểm toán đáng giữ là về chúng tôi, không phải về trang: một phép tìm phân biệt hoa thường báo một sự vắng mặt không có thật, và một kết quả âm trông sạch sẽ là kết quả giả thuyết phục nhất mà một công cụ đo có thể tạo ra.
Lần hụt: độ phủ alt của hình ảnh. Trên bài review Runway, một lần đếm tay trong trình duyệt tìm thấy hai hình mà thuộc tính alt rỗng. Bộ chấm điểm chất lượng nội dung, vốn đọc văn bản, không có gì để nói về chúng, vì độ phủ alt không nằm trong những gì công cụ đó đo. Những hình đó hóa ra là monogram thương hiệu mang tính trang trí nằm trong các anchor mang tên văn bản đầy đủ, đúng mô hình truy cập mà quy tắc hình ảnh của chính chúng tôi yêu cầu, nên lần hụt suýt trúng kết thúc theo hướng có lợi cho trang. Nhưng lần hụt suýt trúng mới là bài học: những gì một công cụ đo không phải là trang là gì.
Các công cụ làm đúng điều gì
Điều mạnh nhất hai công cụ làm cũng là điều kém lấp lánh nhất: chúng tạo ra những phát hiện mà chúng tôi kiểm tra được, và những cái kiểm tra được đều đứng vững. Số đếm sitemap đúng. Nội dung llms.txt đúng. Nửa hreflang của lần chạy mà bộ fetch làm hiện ra (các bản thay thế trong sitemap) đúng, và chính tuyên bố âm của chúng tôi về head mới thất bại trong kiểm tra.
Bộ chấm điểm chất lượng nội dung còn làm một điều tinh tế và đúng: nó chấm trang chủ tiếng Việt giống cách nó chấm tiếng Anh, 90 so với 91 của trang chủ, không coi bên nào là bất thường. Một công cụ gắn cờ trang không phải tiếng Anh là "chất lượng thấp" là một công cụ sẽ làm bạn phí cả buổi chiều trên một trang đa ngôn ngữ.
Những giới hạn của các công cụ đã test
Bốn giới hạn, mỗi cái đến từ lần chạy này chứ không từ danh sách tính năng. Không cái nào là phán xét về những phần của plugin mà chúng tôi chưa chạy.
Bộ chấm điểm kiểm toán những gì bạn đưa nó. Nó đọc đúng HTML chúng tôi lấy và chỉ đưa ra phán xét về thế đó. Nó đo các chiều chất lượng văn bản: filler, mẫu văn AI, mật độ thông tin, sự lặp lại. Nó không đánh giá metadata, hreflang, hay bất cứ thứ gì một lệnh kiểm toán đầy đủ có thể chạm tới, và nó hoàn toàn không nhìn thấy các thuộc tính alt.
Các công cụ đã test không ra phán đoán, và chính điều đó là lý do con người vẫn ở trong vòng lặp. Khi một phép kiểm tra làm hiện ra điều gì đó, việc quyết định nó nghĩa là gì cho trang của bạn, cái gì cần sửa, và một lần sửa đáng giá bao nhiêu là phần ở lại với chúng tôi. Tài liệu của plugin cam kết các khuyến nghị dựa trên nguồn sơ cấp; cam kết mà chúng tôi xác minh được trong lần chạy này hẹp hơn: các công cụ báo sự thật, và phần giải thích là của bạn.
Không có dữ liệu tìm kiếm first-party nào được phân tích trong lần kiểm toán này. Các skill Google API của plugin đọc Search Console, CrUX và GA4. Chúng tôi không chạy chúng, nên hướng dẫn này không nói gì về thứ hạng, số hiển thị, số nhấp, hay bất kỳ kết quả lưu lượng nào cho bất kỳ trang nào, kể cả trang của chúng tôi. Sự vắng mặt của phép đo đó là giới hạn của hướng dẫn, không phải một phát hiện về trang.
Chúng không phải người sửa. Chúng tìm và báo cáo. Plugin có ý kiến về cái gì cần sửa, nhưng việc sửa, và quyết định sửa nào đáng đổi một trang đang chạy, vẫn ở lại với chúng tôi.
Nó có giúp được AI search và GEO không?
Câu trả lời trung thực từ lần chạy này: nửa kiểm tra được của tối ưu hóa máy sinh là cơ học, và những công cụ này kiểm tra nó. Các tệp máy đọc được, vệ sinh sitemap, đoạn văn sẵn sàng cho trích dẫn, HTML ngữ nghĩa: những cái đó xác minh được, các công cụ đã test xác minh một phần, và tài liệu riêng của Google về tính năng AI mô tả các đầu vào là việc lập chỉ mục thông thường: đủ điều kiện kỹ thuật, nội dung thu thập được, nội dung văn bản, structured data khớp. "Không có yêu cầu bổ sung nào để xuất hiện trong AI Overviews hay AI Mode." Không công cụ nào hứa được một trích dẫn AI Overview, và chúng tôi không thấy tuyên bố nào trong plugin nói vậy.
Điều plugin thêm vào so với một danh sách kiểm là nó chạy các phép kiểm nơi nội dung sống. Trên trang này, lớp máy đọc được, sitemap, các sổ nguồn: đây là các artifact build mà một plugin có thể xác minh chính chống lại cùng repository tạo ra chúng, một vòng lặp tốt hơn thực sự so với việc xuất một trang rồi kiểm toán bản sao của người khác về nó.
Ai nên dùng nó
Nếu bạn đã chạy Claude Code và bạn duy trì một trang mà HTML của bạn có thể serve hoặc export được, Claude SEO là một sự bổ sung chi phí thấp: miễn phí, giấy phép MIT, và nó biến những câu hỏi như "sitemap có nhất quán với thực tế không" thành một lệnh. Nếu trang của bạn render hoàn toàn trong trình duyệt, hãy dùng các chế độ --render của bộ fetch thay vì phán plugin qua các lần chạy HTML thô: renderer tồn tại, và trên trang tĩnh này hai chế độ trả về cùng trang và cùng tập link, nhưng đầu ra tuần tự hóa của chúng không giống nhau từng byte.
Nếu bạn cần theo dõi thứ hạng, phân tích backlink ở quy mô lớn, hoặc bất cứ thứ gì các bậc API trả phí cung cấp, đây không phải sản phẩm đó, và tài liệu riêng của nó trỏ tới các extension tùy chọn cho dữ liệu trực tiếp thay vì giả vờ điều ngược lại.
Phán quyết chúng tôi sẽ nói với một đồng nghiệp: hữu ích, rẻ, trung thực về những gì nó đo, và tốt nhất nên coi như một tập hợp công cụ đo chứ không phải một thẩm quyền. Mọi phát hiện hai công cụ tạo ra ở đây đều là một manh mối mà một con người xác nhận, sửa lại, hoặc trong một trường hợp bác bỏ, đúng điều chúng tôi yêu cầu ở bất kỳ công cụ nào mà chúng tôi cho phép đến gần một trang mà người đọc hành động dựa trên đó.
Ghi chú về phương pháp
Mọi con số trong hướng dẫn này đều từ phiên viết nó, tháng 11 năm 2026. Phiên bản plugin được test là 2.2.4; trang công khai của plugin quảng bá v2.5.0 vào ngày chụp, và số tính năng của hai phiên bản khác nhau. Cuộc kiểm toán chạy trên trang sản phẩm đang chạy, và mọi ảnh chụp trình duyệt ở trên được chụp trong cùng phiên đó trong một trình duyệt thật, với analytics tùy chọn bị từ chối qua điều khiển đồng thuận của từng trang; bảng so sánh bộ fetch và bảng chất lượng nội dung là các trình bày lại của kết quả thô đã chụp, được ghi nhãn như vậy. Các phép kiểm tra nguồn trang, việc đếm lại sitemap, so sánh hreflang và kiểm toán alt-attribute được chạy tay, tách khỏi plugin, để các kết luận của hướng dẫn dựa trên hai công cụ đo thay vì một. Trang methodology của chúng tôi mô tả tại sao thói quen đó quan trọng hơn bất kỳ điểm số nào.