CheckSEO Offline: Kiểm tra toàn bộ SEO ngay trên localhost, zero lỗi lên production.

Hệ thống CHECKSEO OFFLINE
Kiểm Tra SEO Không Cần Deploy TRONG 5S

Q: Làm sao để integrate vào CI/CD pipeline?

Thêm step npm run checkseo vào pipeline. Nếu score < 100, script sẽ exit với code 1 → Pipeline fail → Chặn deploy.

Q: Route /checkseo có bảo mật không?

Hoàn toàn bảo mật. Route chỉ register khi globalThis._importMeta_.env.DEV. Production build sẽ tree-shake hết code này.

Q: Offline JSON-LD validation hoạt động thế nào?

Thư viện jsonld có customDocumentLoader. Khi expand JSON-LD, nó fetch schema.org context. Mình intercept request này và trả về cached context từ dev/schemaorg-context.jsonld.

Lạc Việt Anh 30/11/2025

Khác biệt hoàn toàn: kiểm tra SEO trên localhost, không cần deploy production. Tự động validate 100% meta tags, JSON-LD, images alt text với scoring system 0-100. Chặn deploy nếu phát hiện lỗi.

⚡ Khác Biệt Hoàn Toàn ⚡

TÌM HIỂU CÁCH HOẠT ĐỘNG→

Từ Nhạc Công đến Kiến Trúc Sư Hệ Thống

Lạc Việt Anh không chỉ là một lập trình viên. Anh là Founder AkiNet và Chief Product Architect đứng sau thành công của hệ sinh thái lamnhac.net, akivn.net, vstshop.com.

Khởi nguồn đam mê

Xuất thân là nhạc công keyboard (2009) và dấn thân vào con đường hòa âm phối khí chuyên nghiệp từ 2014, Việt Anh thấu hiểu sâu sắc nỗi đau của người làm nghệ thuật: Ý tưởng bay bổng nhưng công cụ lại giới hạn.

Bước ngoặt công nghệ

Nhận thấy thị trường thiếu hụt nghiêm trọng các workflow chuẩn, năm 2018, anh tự học lập trình để xây dựng AkiWorkflow và cộng đồng AkiNet, với sứ mệnh dùng công nghệ để giải phóng sáng tạo.

🔄 Lý Do Có Hệ Thống Này

Trong quá trình chế tạo các website, nhu cầu đồng bộ ngày càng lớn vì có cái thì tinh túy chỗ này có cái thì tinh túy chỗ kia, rồi các version update mới cũ các kiểu... Để giải quyết vấn đề này, Việt Anh làm việc kết hợp với các AI để cào toàn bộ những cái hay, cái tinh túy của từng dự án ra, mang về gom vào một template chuẩn, từ đó xả ra mọi dự án → đảm bảo đồng bộ stack với nhau, tất cả dự án đều có tất cả những cái hay của nhau.

Nhân tiện, cái SEO-system nhỏ nhỏ này cũng là một trong những "cái hay" đó...

"Tôi không chỉ vận hành website. Tôi xây dựng các công cụ, app, script để lấp đầy những khoảng trống mà thị trường bỏ quên, giúp mọi người làm việc nhanh hơn, hiệu quả hơn trên máy tính." — Lạc Việt Anh

Vấn Đề Thực Tế Của SEO Checker Truyền Thống

❌ Các Công Cụ Online (SEMrush, Ahrefs)

›Phải deploy production → mất thời gian build + deploy
›Tốn chi phí → Subscription hàng tháng $99-$399
›Phụ thuộc internet → Không work offline
›Phát hiện lỗi sau khi live → User đã thấy lỗi

✅ CheckSEO Offline (Oscar Family)

›Check trên localhost → Chỉ mất 5-10s sau build
›Miễn phí 100% → Open source, không giới hạn
›Offline hoàn toàn → Cached schema.org context
›Chặn deploy nếu lỗi → Zero lỗi lên production

Công Nghệ Thực Tế Bên Trong

Workflow Thực Tế:

1. npm run generate

↓ Chạy nuxt generate (SSG prerender via Nitro)

↓ @nuxtjs/seo → Tự động tạo sitemap.xml và robots.txt

↓ Scripts: checkseo-offline.js

→ Đọc sitemap.xml

→ Loop từng URL → Đọc HTML từ dist/

→ Extract: title, meta description, h1, og:image, canonical

→ Extract: Tất cả <img> tags → Check alt attributes

→ Extract: JSON-LD scripts → Parse JSON

→ Validate: jsonld.expand() với custom loader

→ Load offline: dev/schemaorg-context.jsonld

→ Expand JSON-LD to RDF triples

→ Detect unknown @type (không có trong schema.org)

→ Calculate score: 100 - (errors × 10) - (warnings × 5)

↓ Lưu: dev/seo-report.json

↓ Console: Hiển thị summary (Average score, Perfect pages, Issues)

↓ Exit code 1 nếu có lỗi → Chặn deploy pipeline

🎯 Điểm Mạnh Kỹ Thuật

Custom Document Loader: Thay vì fetch schema.org online → Load cached context từ dev/schemaorg-context.jsonld
Regex-based Extraction: Parse HTML với regex pattern cực nhanh, không cần DOM parser nặng
Scoring System: 100 điểm base, -10 per error, -5 per warning. Rõ ràng và khách quan
Route /checkseo: Chỉ exist trong dev mode, không build vào production bundle

📊 Dữ Liệu Kiểm Tra

Meta Tags: title, description, keywords, og:* (title, description, image, url, type), twitter:card
Semantic: h1 (phải unique), canonical URL, hreflang (nếu có)
Images: Tất cả <img> phải có alt text, nếu thiếu → warning
JSON-LD: Parse JSON syntax + Expand với schema.org + Validate @type + Detect unknown types

Tính Năng Độc Quyền: Route /checkseo (Dev Only)

Cách Hoạt Động:

Route /checkseo chỉ tồn tại trong development mode
Component app/pages/checkseo.vue fetch /dev/seo-report.json
Vite dev server serve cả thư mục dev/ (không build vào production)
Hiển thị UI trực quan: Summary cards, Per-page results, Issues list
Score color-coded: Green (90-100), Yellow (70-89), Red (<70)

Lợi Ích:

✓Visual Report: Không cần đọc JSON raw, UI responsive đẹp
✓Real-time Check: npm run checkseo → F5 browser → Thấy ngay
✓Detail Drilling: Click từng page → Xem metadata, images, JSON-LD, issues
✓Security: Route này KHÔNG build vào production → Không lo lộ report

Lưu ý: Nếu access https://oscarfamily.vn/checkseo trên production → 404. Route chỉ exist khi globalThis._importMeta_.env.DEV === true.

So Sánh Với Các Công Cụ Khác

Tiêu chí	CheckSEO Offline	Lighthouse	SEMrush	Screaming Frog
Kiểm tra Offline	✓ Hoàn toàn	✓ Có	✗ Cần internet	~ Giới hạn
Validate JSON-LD	✓ Expand RDF	✗ Không	~ Basic	✗ Không
Check Images Alt	✓ Tất cả	✓ Có	✓ Có	✓ Có
Exit code chặn deploy	✓ Code 1	✗ Không	✗ Không	✗ Không
Visual Report	✓ /checkseo UI	✓ Chrome UI	✓ Dashboard	✓ Desktop app
Chi phí	FREE	FREE	$99-399/mo	$149/yr

Câu Hỏi Thường Gặp

Làm sao để integrate vào CI/CD pipeline?▼

Thêm step npm run checkseo vào pipeline. Nếu score < 100, script sẽ exit với code 1 → Pipeline fail → Chặn deploy. Ví dụ GitHub Actions: run: npm run checkseo || exit 1

Route /checkseo có bảo mật không?▼

Hoàn toàn bảo mật. Route chỉ register khi globalThis._importMeta_.env.DEV. Production build sẽ tree-shake hết code này. File dev/seo-report.json cũng không copy vào dist/.

Offline JSON-LD validation hoạt động thế nào?▼

Thư viện jsonld có customDocumentLoader. Khi expand JSON-LD, nó fetch schema.org context. Mình intercept request này và trả về cached context từ dev/schemaorg-context.jsonld. Zero network request.

Có thể adapt cho WordPress hoặc Next.js không?▼

Concept tương tự: Build HTML files → Run script scan → Validate. Với Next.js SSG, scan out/ thư mục. WordPress cần export static HTML hoặc crawl website local. Core logic (checkseo-offline.js) có thể reuse 100%.

📖 WEB NÀY OPEN SOURCE

Ai dev mang về sài cũng được luôn. Có sẵn một số docs và file "system_prompt" để ném cho AI khi cần viết bài mới. Các tiêu chuẩn và ràng buộc cần thiết đã được thiết lập sẵn và tối ưu qua nhiều đợt nghiên cứu.

🤖 Cách Sử Dụng System Prompt

Tải file docs/ref/page-creation-rules.md từ repo
Add/mention file đó vào kèm vài lời ngắn gọn
Ví dụ: "Viết cho tôi trang về... (dựa theo chuẩn trong file này)"
AI sẽ output trang với SEO, UX, và tiêu chuẩn đã tối ưu sẵn!

✍️ Muốn Viết Bài?

Liên hệ mình hoặc Lạc Quốc Huy để viết bằng trang này. Trang này chỉ để viết bài tĩnh nên SEO cực tốt, nhất là cấu trúc JSON-LD giúp AI/bot quét tổng hợp thông tin.

⏱️ Hiệu quả thường thấy sau khoảng vài ngày đến 1 tuần.