Codex SEO là gì
Codex SEO là một kỹ năng kiểm toán SEO mã nguồn mở, miễn phí, chạy trong OpenAI Codex CLI. Bạn chỉ cần cung cấp địa chỉ website, công cụ sẽ kiểm tra website và tạo kế hoạch hành động được sắp xếp theo mức độ ưu tiên, thay vì chỉ liệt kê một nhóm cảnh báo rời rạc.
Dự án được chuyển thể từ claude-seo của Agrici Daniel, điều chỉnh các phương pháp kiểm toán, kỹ năng và tập lệnh của dự án gốc cho Codex CLI. Dự án sử dụng giấy phép MIT, không tính phí theo website và không yêu cầu cài đặt dịch vụ SEO bên thứ ba.
Bản thân Codex SEO là mã nguồn mở và không tính phí theo website, nhưng quá trình kiểm toán vẫn sử dụng mô hình được cấu hình cho phiên Codex hiện tại. Một cuộc kiểm toán đầy đủ cần chạy nhiều vai trò, vì vậy thường tiêu tốn nhiều token hơn phân tích một trang.
Năng lực cốt lõi
Codex SEO gồm 26 kỹ năng phụ và 19 kịch bản vai trò chuyên gia. Một cuộc kiểm toán đầy đủ có thể lần lượt cho tối đa 17 vai trò phân tích website, đồng thời ghi lại phát hiện của từng vai trò vào tệp để làm bằng chứng.
- SEO kỹ thuật: Kiểm tra khả năng thu thập dữ liệu, tín hiệu lập chỉ mục, XML sitemap, robots.txt, chuyển hướng, tốc độ trang và Core Web Vitals.
- Nội dung và E-E-A-T: Phân tích kinh nghiệm, chuyên môn, tính thẩm quyền, độ tin cậy, nội dung mỏng và mức độ bao phủ chủ đề.
- Dữ liệu có cấu trúc: Phát hiện và xác thực đánh dấu Schema.org hiện có, đồng thời có thể tạo đánh dấu đề xuất.
- Tìm kiếm AI và GEO: Đánh giá khả năng trang được Google AI Overviews, AI Mode, ChatGPT, Perplexity và Gemini trích dẫn.
- Mức độ sẵn sàng cho Agent: Kiểm tra khả năng truy cập của AI Agent, llms.txt, Markdown, WebMCP và các khả năng liên quan.
- SEO địa phương và thương mại điện tử: Bao quát Google Business Profile, đánh giá, local pack, trang sản phẩm và website đa ngôn ngữ.
- Chiến lược và giám sát liên tục: Cung cấp lập kế hoạch theo ngành, trang đối thủ, bản tóm tắt nội dung, phân cụm ngữ nghĩa và giám sát biến động SEO dựa trên snapshot SQLite.
Chuẩn bị trước khi cài đặt
Trước khi bắt đầu, bạn cần chuẩn bị môi trường sau:
- OpenAI Codex CLI hỗ trợ skills.
- Python 3.11 đến 3.14.
- Git để sao chép repository.
Theo mặc định, bạn không cần khóa API của dịch vụ SEO. Trình cài đặt sẽ sao chép các kỹ năng vào ~/.agents/skills/, vị trí Codex dùng để phát hiện kỹ năng người dùng; đồng thời tạo một môi trường chạy Python biệt lập có trình duyệt không giao diện, không thay đổi môi trường Python toàn cục của hệ thống.
Cài đặt Codex SEO
macOS và Linux
Sao chép repository và chạy tập lệnh cài đặt:
git clone --depth 1 https://github.com/zhtyyx/codex-seo.git
bash codex-seo/install.shWindows PowerShell
Thực thi trong PowerShell:
git clone --depth 1 https://github.com/zhtyyx/codex-seo.git
powershell -ExecutionPolicy Bypass -File codex-seo\install.ps1Khởi tạo và kiểm tra môi trường
Nếu cần tạo hoặc làm mới môi trường chạy biệt lập và Chromium, bạn có thể chạy trong Codex CLI:
$seo setupNếu chỉ muốn kiểm tra môi trường mà không sửa đổi hệ thống, hãy chạy:
$seo doctor$seo doctor là lệnh kiểm tra chỉ đọc, phù hợp để xác nhận trạng thái các phần phụ thuộc sau khi cài đặt hoặc khi gặp sự cố.
Thực hiện kiểm toán SEO lần đầu
- Chạy
codextrong terminal để khởi động Codex CLI. - Dùng
$seođể gọi kỹ năng. - Cung cấp địa chỉ website hoặc trang cần phân tích.
- Chờ các vai trò chuyên gia hoàn tất phân tích và xem kế hoạch hành động được tạo.
codex
$seo audit https://example.com$seo audit thực hiện kiểm toán toàn website, phù hợp để nắm tổng quan các vấn đề của website lần đầu. Hệ thống sẽ tự động nhận diện loại hình kinh doanh như SaaS, dịch vụ địa phương, thương mại điện tử, website nội dung hoặc agency, sau đó điều chỉnh các hạng mục kiểm tra.
Bạn cũng có thể sử dụng ngôn ngữ tự nhiên, chẳng hạn:
Hãy thực hiện kiểm toán SEO cho tôi, website là https://example.comBốn lệnh khởi đầu thường dùng
Kiểm toán toàn website
$seo audit https://example.comChạy quy trình chuyên gia đầy đủ và xuất kế hoạch sửa lỗi, tối ưu được sắp xếp theo mức độ ưu tiên. Mỗi đề xuất sẽ nêu mức độ quan trọng, căn cứ đánh giá, các phần phụ thuộc và cách xác minh hiệu quả.
Phân tích chuyên sâu một trang
$seo page https://example.com/pricingKhi chỉ quan tâm đến trang giá, trang sản phẩm, landing page hoặc trang bài viết, bạn có thể dùng phân tích một trang để tránh thực hiện ngay cuộc kiểm toán đầy đủ với chi phí cao hơn.
Phân tích mức độ sẵn sàng cho tìm kiếm AI
$seo geo https://example.comLệnh này hướng đến tối ưu hóa cho các công cụ tạo sinh, đánh giá khả năng trang được tìm kiếm AI trích dẫn, trình thu thập dữ liệu AI có thể truy cập hay không, cũng như mức độ hiện diện của thương hiệu trên các nền tảng công khai như Wikipedia, Reddit, YouTube và LinkedIn.
Kiểm tra dữ liệu có cấu trúc
$seo schema https://example.comLệnh này có thể phát hiện và xác thực đánh dấu Schema.org trên trang, đồng thời đưa ra đề xuất tạo dữ liệu có cấu trúc.
Chọn lệnh kiểm toán theo mục tiêu
SEO kỹ thuật
$seo technical https://example.com: Thực hiện kiểm toán kỹ thuật gồm chín nhóm.$seo sitemap https://example.com: Phân tích XML sitemap của website.$seo sitemap generate: Tạo XML sitemap.$seo images https://example.com: Phân tích các vấn đề tối ưu hóa hình ảnh.$seo hreflang https://example.com: Kiểm toán hoặc tạo cấu hình hreflang đa ngôn ngữ.$seo programmatic https://example.com: Phân tích và lập kế hoạch SEO theo chương trình.$seo unlighthouse https://example.com: Phân tích Lighthouse nhiều trang cục bộ.
Nội dung và trải nghiệm tìm kiếm
$seo content https://example.com: Phân tích E-E-A-T và chất lượng nội dung.$seo content-brief Chủ đề mục tiêu: Tạo bản tóm tắt nội dung gồm từ khóa mục tiêu, dàn ý và đề xuất liên kết nội bộ.$seo cluster Từ khóa mục tiêu: Thực hiện phân cụm ngữ nghĩa dựa trên SERP.$seo sxo https://example.com: Phân tích các yếu tố trải nghiệm tìm kiếm như loại trang, câu chuyện người dùng và chân dung người dùng.$seo competitor-pages https://example.com: Tạo đề xuất cho các trang so sánh đối thủ.
Địa phương, liên kết ngoài và thương mại điện tử
$seo local https://example.com: Kiểm tra hiệu quả GBP, trích dẫn, đánh giá và local pack.$seo maps [command]: Sử dụng các khả năng tình báo bản đồ như geo-grid, kiểm toán GBP và bán kính đối thủ.$seo backlinks https://example.com: Phân tích hồ sơ liên kết ngoài thông qua các nguồn như Moz, Bing và Common Crawl.$seo ecommerce https://example.com: Thực hiện phân tích SEO thương mại điện tử và tình báo thị trường.
Quy trình kiểm toán đầy đủ hoạt động như thế nào
- Nhận diện loại website: Trước tiên xác định website thuộc SaaS, dịch vụ địa phương, thương mại điện tử, website nội dung hay agency, rồi điều chỉnh phạm vi kiểm tra tiếp theo.
- Chuyên gia phân tích lần lượt: Các vai trò về kỹ thuật, nội dung, dữ liệu có cấu trúc, tốc độ và tìm kiếm AI lần lượt thực hiện nhiệm vụ.
- Lưu phát hiện: Sau khi hoàn tất, mỗi vai trò sẽ lưu tệp phát hiện riêng để giữ lại căn cứ cho kết luận.
- Chấm điểm vấn đề: Hệ thống chấm điểm các phát hiện thay vì chỉ hiển thị theo thứ tự xuất hiện.
- Tạo kế hoạch hành động: Báo cáo cuối cùng sắp xếp đề xuất theo mức độ ưu tiên và nêu lý do, mối quan hệ phụ thuộc cùng phương thức xác minh.
Báo cáo mặc định được lưu dưới dạng Markdown. Nếu cần PDF, bạn có thể yêu cầu Codex “tạo báo cáo PDF” và xuất qua $seo google report.
Mẹo sử dụng nâng cao
Phân tích phạm vi nhỏ trước rồi mới kiểm toán toàn website
$seo audit đầy đủ sẽ chạy tối đa 17 vai trò trong phiên chính và tiêu tốn nhiều token hơn kiểm tra một trang. Với website lớn, bạn có thể dùng $seo page, $seo technical, $seo content hoặc $seo schema để xác minh các trang quan trọng trước, rồi quyết định có chạy kiểm toán toàn website hay không.
Tạo kế hoạch chiến lược theo ngành
$seo plan hỗ trợ các loại hình như SaaS, dịch vụ địa phương, thương mại điện tử, nhà xuất bản nội dung và agency:
$seo plan saas
$seo plan local
$seo plan ecommerce
$seo plan publisher
$seo plan agencySử dụng loại hình phù hợp với hoạt động kinh doanh sẽ giúp kế hoạch tập trung vào đúng bối cảnh tìm kiếm.
Kết nối dữ liệu Google
Codex SEO có thể sử dụng mà không cần khóa API. Nếu cần dữ liệu trường thực tế, bạn có thể chạy lệnh sau để cấu hình Google API miễn phí:
$seo google setupDữ liệu có thể kết nối gồm PageSpeed Insights, Chrome UX Report, Google Search Console và GA4. Khóa chỉ được lưu trên máy cục bộ.
Khi chưa cấu hình khóa Google API, Core Web Vitals chỉ là ước tính thử nghiệm và trạng thái lập chỉ mục chủ yếu được suy luận từ thông tin trên trang. Khi đưa ra quyết định quan trọng, nên đối chiếu với dữ liệu trường thực tế và dữ liệu từ các nền tảng tìm kiếm.
Giám sát biến động SEO
Codex SEO có thể sử dụng snapshot SQLite để thiết lập đường cơ sở, so sánh thay đổi và xem lịch sử:
$seo drift baseline https://example.com
$seo drift compare https://example.com
$seo drift history https://example.comNhóm lệnh này phù hợp để kiểm tra trạng thái SEO có bị thay đổi sau khi cải tổ website, di chuyển hệ thống, cập nhật mẫu hoặc liên tục xuất bản nội dung hay không.
Kiểm tra liệu AI Agent có thể sử dụng website
$seo agentic https://example.comLệnh này kiểm tra các hạng mục như Lighthouse Agentic Browsing X/N, quyền truy cập của AI Agent, llms.txt, Markdown và WebMCP. Trọng tâm của lệnh này khác với $seo geo: lệnh này tập trung vào khả năng Agent sử dụng website, còn lệnh kia chú trọng hơn đến khả năng được phát hiện và trích dẫn của trang trong tìm kiếm tạo sinh.
Kiểm tra website JavaScript
Codex SEO hỗ trợ Next.js, React, Vue và các website khác phụ thuộc vào việc kết xuất JavaScript. Khi trang phải thực thi JavaScript mới hiển thị nội dung, công cụ sẽ tự động sử dụng trình duyệt không giao diện và kiểm tra trang theo cách khách truy cập nhìn thấy.
Nếu nội dung quan trọng chỉ được tải sau khi cuộn hoặc nhấp, kết quả vẫn có thể chứa nhiễu. Bạn nên kiểm tra thủ công các khu vực tương tác này và đối chiếu kết luận kiểm tra tự động với biểu hiện thực tế trên trình duyệt.
Tích hợp tùy chọn
Kiểm tra cơ bản không phụ thuộc vào các tiện ích trả phí, nhưng dự án cung cấp một số tích hợp tùy chọn. Khi sử dụng các dịch vụ này, bạn cần tự chuẩn bị tài khoản hoặc cấu hình tương ứng.
$seo image-gen [use-case]: tạo hình ảnh AI cho tài liệu SEO.$seo seranking [command]: phân tích thị phần tiếng nói của AI trên ChatGPT, Gemini, Perplexity, AI Overviews và AI Mode.$seo profound [command]: theo dõi các trích dẫn của LLM và chuỗi thời gian tương ứng.$seo bing [command] https://example.com: sử dụng Công cụ quản trị website Bing và khả năng gửi qua IndexNow.
Quyền riêng tư, giới hạn và gỡ cài đặt
Cách xử lý dữ liệu
Codex SEO chạy trong Codex CLI. Các trang được phân tích và dữ liệu liên quan sẽ được gửi đến mô hình OpenAI đứng sau phiên Codex hiện tại, với cách xử lý giống các tác vụ Codex khác. Báo cáo được tạo sẽ được lưu dưới dạng tệp trên máy cục bộ.
Ngoài trường hợp chủ động kết nối tiện ích hoặc API, không có dịch vụ SEO bổ sung nào nhận dữ liệu. Một số bước kiểm tra có thể đọc các nguồn công khai như Wikipedia, Reddit và Common Crawl.
Giới hạn cần lưu ý
- Khi chưa kết nối Google API, Core Web Vitals là kết quả ước tính thử nghiệm.
- Khi chưa kết nối dữ liệu nền tảng thực tế, trạng thái lập chỉ mục chủ yếu được suy luận từ trang.
- Các trang phụ thuộc vào thao tác cuộn, nhấp hoặc tương tác phức tạp để tải nội dung quan trọng có thể tạo ra nhiễu.
- Kiểm tra đầy đủ sẽ sử dụng nhiều token hơn; hãy chọn lệnh dựa trên quy mô website.
Gỡ cài đặt
Nếu không còn sử dụng, bạn có thể chạy tập lệnh gỡ cài đặt do kho lưu trữ cung cấp:
bash uninstall.shLệnh này dùng để xóa các kỹ năng đã cài đặt.
Kết luận
Codex SEO tích hợp kiểm tra kỹ thuật, chất lượng nội dung, Schema, GEO, SEO địa phương, SEO thương mại điện tử và giám sát liên tục vào Codex CLI. Bạn nên bắt đầu bằng $seo doctor để xác nhận môi trường, sau đó làm quen với quy trình qua $seo page hoặc các lệnh chuyên biệt, cuối cùng dùng $seo audit để tạo kế hoạch hành động đầy đủ theo mức độ ưu tiên.
Để tra cứu toàn bộ tham số và cấu hình tiện ích mở rộng, hãy xem kho GitHub của dự án cùng các tài liệu về cài đặt, lệnh, kiến trúc, khắc phục sự cố, bảo mật và quyền riêng tư trong đó.