Website Scan
Quét website để AI hiểu cấu trúc, đề xuất chủ đề và tạo handoff cho blog.
Website Scan
Website Scan quét site của bạn (qua Firecrawl) để thu thập cấu trúc, chất lượng và đề xuất chủ đề. Kết quả dùng cho SEO Plans và Chat/Blogs.
Quét
/dashboard/website-scan — scan, polling, confirm
Lịch sử
Xem các lần scan trước, quality report
Handoff
Chuyển context sang tạo bài
Bạn tìm thấy gì ở đâu
| Trang | Đường dẫn | Mô tả |
|---|---|---|
| Website Scan | /dashboard/website-scan | Giao diện quét chính (client-only), không prefetch server |
Quy trình quét
Kiểm tra:
checkEnabled xem tenant có bật Firecrawl không.Bắt đầu:
scanWebsite({ url }) hoặc analyzeWebsite — hệ thống crawl site.Theo dõi:
getActiveScan / getCrawlStatus polling đến khi completed.Xem kết quả:
getQualityReport, getScanPages, getHistory.Xác nhận:
confirmScan hoặc savePendingScan/confirm để lưu vào seo.sites + seo.pages.Handoff:
prepareBlogHandoff / createBlogHandoffToken để mang context sang Chat/Blogs sinh bài.Các chức năng liên quan
| Chức năng | Mô tả |
|---|---|
getRescanSchedule / configureRescan | Đặt lịch quét lại (chỉ admin) |
getPendingScan / getPendingScans | Xem scans đang chờ confirm |
getDocumentReadiness | Kiểm tra tài liệu đã sẵn sàng cho RAG chưa |
listIntelligenceSnapshots | Xem snapshots AI thu thập |
approveIntelligenceSnapshot / rejectIntelligenceSnapshot | Duyệt snapshot (admin) |
resolveBlogHandoff | Giải handoff token phía Chat/Blogs |
deleteHistory | Xóa lịch sử scan |
cancelScan | Hủy scan đang chạy |
Scan là async — bấm Start Scan sẽ trả scanId, bạn polling getActiveScan mỗi 2s đến khi xong. Không tắt tab giữa chừng nếu không muốn mất kết quả pending.
Sau khi quét xong
- Confirm để lưu kết quả — lúc này SEO Plans mới có evidence để generate plan
- Handoff để tạo bài ngay: hệ thống truyền context (sitemap, top pages, quality issues) sang Chat
- Rescan schedule: đặt lịch quét lại định kỳ để evidence luôn fresh —
getReadinesstrong Monthly Plans sẽ báoready/limited/blockeddựa trên độ tươi của scan
Quyền
| Hành động | Ai làm được |
|---|---|
| Scan, xem history, handoff, confirm | Mọi member |
| Configure rescan, approve/reject snapshot | org:admin |
Lưu ý
- Quét site lớn mất vài phút — kiên nhẫn đợi polling
- Nếu
checkEnabledtrảfalse, liên hệ admin để bật Firecrawl cho tenant - Pending scans chưa confirm sẽ không tính vào SEO evidence