Dự Án Đầu Tiên
Hướng dẫn setup và chạy phân tích SEO cho domain đầu tiên.
Trước Khi Bắt Đầu
- ✅ Đã cài đặt Antigravity (hướng dẫn)
- ✅ Đã cài đặt SEO Kit với license key
- ✅ Có domain muốn phân tích
Bước 1: Chạy Lệnh Master
Trong khung chat của Antigravity, gõ:
/seo-run yourdomain.com
SEO Kit sẽ phát hiện đây là dự án mới (🆕) và đề xuất chạy /seo-onboard.
Bước 2: Onboarding
Chấp nhận đề xuất. SEO Kit sẽ:
- Pre-scan domain tự động (kiểm tra ngôn ngữ, CMS, loại doanh nghiệp)
- Hỏi 5-7 câu hỏi để xác nhận thông tin:
- Loại doanh nghiệp (SaaS / E-commerce / Local / Publisher / Agency)
- Core topic (Semantic Anchor)
- Mục tiêu SEO (traffic / leads / sales / AI visibility)
- CMS / Platform
- Thị trường mục tiêu
- Đối thủ (URLs)
- Timeline (ngắn / trung / dài hạn)
💡 AI sẽ gợi ý câu trả lời dựa trên pre-scan. Bạn chỉ cần xác nhận hoặc sửa lại.
- Sau khi bạn trả lời, SEO Kit tự động:
- Tạo thư mục quản trị
.seo/tại góc thư mục gốc của Antigravity Project - Phân tích Source Context (brand identity, E-E-A-T)
- Xây dựng audience personas
- Kiểm tra Google API credentials
- Tạo báo cáo onboarding
- Tạo thư mục quản trị
Bước 3: Tiếp Tục Vòng Đời
Sau onboarding, chạy lại:
/seo-run yourdomain.com
SEO Kit sẽ hiển thị dashboard trạng thái và đề xuất bước tiếp theo (thường là /seo-research hoặc /seo-audit).
Cấu Trúc Thư Mục Dự Án (.seo/)
Dữ liệu dự án của domain được lưu trữ tập trung tại thư mục ẩn .seo/:
.seo/
├── project.json ← Trạng thái, cấu hình, state machine, KPIs
├── exclusions.json ← Từ khóa loại trừ động
├── competitors.json ← Cache đối thủ
├── knowledge/ ← Client Knowledge Vault (Tri thức khách hàng)
├── data/ ← Data Lake dữ liệu máy đọc (.json & .toon)
├── reports/ ← Báo cáo Markdown dành cho con người
├── fixes/ ← File sửa lỗi & Schema sẵn sàng deploy
└── screenshots/ ← Ảnh chụp màn hình visual audit
💡 Mẹo: 1 Antigravity Project = 1 Domain SEO
Khuyến nghị: Mỗi Project Antigravity (thư mục dự án mở trong Google Antigravity) nên dành riêng cho 1 Domain duy nhất.
Lý do:
- Mỗi dự án SEO Kit sẽ tự động khởi tạo thư mục
.seo/quản trị duy nhất trong Antigravity Project đó - Giúp AI Agent tập trung 100% ngữ cảnh vào domain mục tiêu
- Tránh rò rỉ dữ liệu hoặc nhầm lẫn ngữ cảnh giữa các tên miền khác nhau
- Dễ dàng tích hợp với Git và các công cụ lập trình cục bộ
Cách làm: Trong Antigravity, nhấn "New Conversation" (hoặc phím tắt Ctrl+Shift+L) trước khi bắt đầu phân tích domain mới.