Hệ thống CHECKSEO OFFLINE
Kiểm Tra SEO Không Cần Deploy TRONG 5S
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 ⚡
Zero Lên Production
Chặn deploy nếu SEO score < 100. Không bao giờ lỗi trên production.
Localhost /checkseo
Route chỉ dành cho dev, hiển thị report trực quan ngay trên trình duyệt.
Offline 100%
Validate JSON-LD với schema.org context cached. Không cần internet.
Auto Sitemap
Scan thư mục dist/ tự động tạo sitemap.xml sau mỗi lần build.
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ế:
npm run checkseovite-ssg build (SSG prerender)generate-sitemap.js → Scan dist/ → Tạo sitemap.xmlcheckseo-offline.jsjsonld.expand() với custom loaderdev/schemaorg-context.jsonlddev/seo-report.json🎯 Đ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
/checkseochỉ tồn tại trong development mode - Component
src/pages/checkseo.vuefetch/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 import.meta.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?▼
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 1Route /checkseo có bảo mật không?▼
import.meta.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?▼
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?▼
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/page-creation-rules.mdtừ 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.
Sẵn Sàng Nâng Tầm SEO Workflow?
Fork source code, customize theo nhu cầu. Zero learning curve, chỉ cần biết Node.js cơ bản.
Bài viết liên quan
aki-info-detect: JavaScript Library Phát Hiện Thiết Bị Thông Minh
Ra mắt aki-info-detect - thư viện JavaScript nhẹ, mạnh mẽ phát hiện browser, OS, hardware, network. Client Hints API, Apple Silicon M1-MX, tree-shakeable. By Lạc Việt Anh.
QQMusic Lyrics Search: Bí Quyết Có Lời Bài Hát Đúng Timecode Cho Video Âm Nhạc
Công cụ tìm kiếm lyrics từ QQMusic với timecode chuẩn, hỗ trợ nhạc Trung và quốc tế - giải pháp tối ưu cho creator video âm nhạc.
AkiApp - Nền tảng Mini-OS cho người sáng tạo (app.akivn.net)
AkiApp là một nền tảng Mini-OS trên trình duyệt, cung cấp các ứng dụng và tiện ích cho producer, content creator và người dùng sáng tạo.
Oscar Studio Hà Nội - Phòng Thu Âm & Làm Nhạc Chuyên Nghiệp
Phòng thu âm chuyên nghiệp tại Hà Nội: thu âm, làm nhạc, hòa âm phối khí, mixing mastering, quay MV chất lượng cao.
LamNhac.net - Cộng đồng làm nhạc, preset và mentorship cho producer Việt Nam
LamNhac.net là hub chia sẻ preset, tutorial, feedback và mentorship dành cho cộng đồng producer Việt Nam.
Tách Nhạc AI tool.akivn.net - Tachnhac, Vocal Remover, Tải nhạc
Giới thiệu tool.akivn.net/tachnhac: tách nhạc AI, vocal remove, tải nhạc YouTube, download SoundCloud cho producer và content creator.
AkiNet - Hệ sinh thái công nghệ làm nhạc (AkiWorkflow, VSTShop, AkiApp)
AkiNet (akivn.net) kết nối AkiWorkflow, VSTShop, AkiApp, Tách Nhạc AI, LamNhac.net tạo nền tảng công nghệ âm nhạc Việt Nam.
AkiWorkflow - Hệ sinh thái tất cả trong một để bắt đầu làm nhạc
Nền tảng quản lý dự án âm nhạc: task, version, stem, release checklist dành cho producer, studio, artist indie.