description: "Pre-flight niche viability and brand DNA discovery — Crawl SERPs, evaluate competition barriers, compute viability index, and generate brand positioning proposal" version: "1.0"
/seo-viability [--competitors comp1,comp2] [--market vn|global]
Purpose
Đánh giá độ khả thi của ngách thị trường (niche keyword) và xác định USP/DNA thương hiệu đề xuất trước khi tiến hành onboarding dự án chính thức. Giúp người dùng đưa ra quyết định Go/No-Go nhanh chóng mà không làm ảnh hưởng đến cấu hình dự án gốc.
Hoạt động độc lập (Sandbox Mode)
- Lệnh này không yêu cầu tài khoản Google Search Console hay GA4.
- Lệnh này không cập nhật trạng thái dự án chính (
project.json.phase) để đảm bảo tính độc lập.
Skills Activated (3)
| # | Skill | Vai trò | Điều kiện |
|---|---|---|---|
| 0 | seo-viability | Định giá trị khả thi và lưu trữ DNA | Luôn luôn |
| 1 | seo-information-gain | Phân tích kẽ hở nội dung đối thủ | Luôn luôn |
| 2 | seo-plan | So khớp mô hình ngành hàng | Luôn luôn |
Sub-Agent Coordination
- Primary Executor: @[seo-cmo] (Điều hành đánh giá chiến lược và marketing)
- Sub-Agents: @[topical-authority-planner] (Phân tích khoảng trống ngữ nghĩa), @[algo-forecaster] (Đánh giá mức thâm nhập của AI Search)
Các bước thực hiện
Step 1: Quét độ bão hòa SERP & Cào đối thủ
Chạy tập lệnh viability ở chế độ phân tích thô để lấy dữ liệu kẽ hở đối thủ trên SERP:
python .agents/scripts/run_plugin_script.py seo-viability viability_analyzer.py analyze <domain> <keyword> [--competitors <competitors>] --json
Tập lệnh sẽ chạy ngầm information_gain_analyzer.py của skill seo-information-gain để trích xuất các bằng chứng kỹ thuật (Case study, số liệu, chuyên gia) mà 5 đối thủ hàng đầu đang sở hữu hoặc thiếu hụt.
Step 2: Đánh giá ngữ nghĩa bằng AI (Semantic Analysis)
Agent (sử dụng LLM) nạp file Prompt được thiết kế tại viability_prompt.md, truyền dữ liệu đầu ra từ Step 1, từ khóa hạt giống và mô hình đối thủ:
- Phân tích rào cản Authority (DR trung bình của đối thủ).
- Tìm điểm mù (Content Gaps) của đối thủ trên SERP (Ví dụ: đối thủ viết rất chung chung, không có số liệu kiểm chứng).
- Xây dựng Đề xuất USP độc bản cho website của người dùng để đánh thẳng vào điểm yếu đó.
- Phân chia các Micro-topics và loại bằng chứng mà người dùng cần tự thu thập (Information Gain Plan).
Step 3: Lưu trữ & Tạo Báo cáo Khả thi
Agent chuyển đổi kết quả phân tích ngữ nghĩa ở Step 2 thành định dạng TOON và gọi lệnh lưu:
python .agents/scripts/run_plugin_script.py seo-viability viability_analyzer.py save <domain> <keyword> --toon-data '<TOON_DATA>'
Tập lệnh sẽ:
- Lưu trữ tệp cấu hình tạm thời tại
.seo/data/proposed_dna.json. - Xuất báo cáo khả thi Markdown tại
.seo/plans/viability-{domain-slug}.md.
Step 4: Cổng Xác nhận Go/No-Go (Socratic Gate)
Agent hiển thị điểm khả thi Viability Score, đánh giá chung, đề xuất USP trực tiếp trên chat cho người dùng và hiển thị:
- 🟢 Khả thi cao (Score >= 70): Khuyên người dùng khởi chạy
/seo-onboardngay. - 🟡 Khả thi trung bình (Score 40-69): Cảnh báo rào cản và đề xuất ngách phụ (Sub-niche) cụ thể. Hỏi người dùng muốn đi tiếp hay đổi từ khóa hạt giống khác.
- 🔴 Khả thi thấp (Score < 40): Ngách quá bão hòa. Khuyên người dùng cân nhắc pivot sang ngách/từ khóa khác để tránh tốn tài nguyên vô ích.
Quy ước Đầu ra
Báo cáo khả thi được lưu tại .seo/plans/viability-{domain-slug}.md tuân thủ chuẩn định dạng rules/seo-output.md và có cấu trúc:
- Viability Score: Điểm số (0-100) kèm Rationale chi tiết.
- Proposed Brand USP: Định vị thương hiệu độc bản được khuyên dùng.
- Suggested Competitors: Danh sách đối thủ thực tế cần theo dõi.
- Information Gain Action Plan: Danh sách các chủ đề và loại bằng chứng bắt buộc người dùng cần chuẩn bị.