CẨM NANG HƯỚNG DẪN SỬ DỤNG HỆ THỐNG SEO AGENTS

Phát triển cho: CEO AI OS / Green Leaf Vietnam
Kiến trúc: 4 Agent độc lập + Google Search Console Data

1. TỔNG QUAN VỀ KIẾN TRÚC 4 AGENT

Hệ sinh thái SEO của chúng ta đã được chuẩn hóa thành 4 Agent chuyên biệt, ngôn ngữ dễ nhớ và tránh trùng lặp nhiệm vụ.

seo-manager (Giám đốc Chiến lược): Người bạn gọi đầu tiên. Dùng để lên kế hoạch, phân cụm từ khóa (cluster) và thiết kế dàn ý (outline).
seo-auditor (Kỹ sư Kiểm định): Chuyên gia kỹ thuật. Dùng để lấy số liệu thực từ Google Search Console (Click, Impression), quét lỗi HTML, sitemap và robots.txt.
seo-writer (Chuyên gia Nội dung): Người thực thi. Dùng để viết bài theo chuẩn GEO (Generative Engine Optimization) và AEO (AI Engine Optimization).
seo-reviewer (Chuyên gia QA): Cỗ máy chấm điểm. Dùng bộ 80 tiêu chí CORE-EEAT để chấm bài và yêu cầu sửa lỗi.

Dưới đây là cách CEO Vo giao việc cho hệ thống trong từng tình huống cụ thể:

Lệnh của CEO: "/model complex hãy dùng seo-manager lên kế hoạch viết bài về 'Quy trình thuê xe công tác' cho GLV."
Luồng xử lý ngầm:
1. seo-manager đọc Knowledge Base của GLV.
2. seo-manager gọi tool WebSearch xem đối thủ đang viết gì.
3. Tạo ra bản Outline gồm các thẻ H2, H3 cụ thể.
4. Tự động giao việc (delegate_task) cho seo-writer để viết bài.

Lệnh của CEO: "/model complex hãy gọi seo-auditor kiểm tra xem trang chủ greenleafvietnam.com có bị lỗi SEO nào không và lấy từ khóa top 10 từ Search Console."
Luồng xử lý ngầm:
1. seo-auditor kích hoạt kết nối GSC (đã cấu hình sẵn, không cần xin quyền).
2. Kéo dữ liệu Click, Impression thực tế 30 ngày qua.
3. Quét mã HTML tìm thẻ H1, meta description, schema.
4. Lập báo cáo đánh giá kỹ thuật và cơ hội tăng hạng.

Lệnh của CEO: "/model complex tôi vừa viết xong file bai_viet_thue_xe.md. Hãy cho seo-reviewer chấm điểm bài này."
Luồng xử lý ngầm:
1. seo-reviewer tự động mở bộ tham chiếu references/core_eeat_criteria.md (80 tiêu chí).
2. Chấm điểm từng khía cạnh: Độ chuyên sâu, Bảng biểu, Định dạng câu (<25 từ).
3. Trả về báo cáo: Pass / Fail kèm danh sách cần sửa.

Về DataForSEO: Đã tắt hoàn toàn yêu cầu dùng DataForSEO (để tiết kiệm chi phí). Thay vào đó, dùng web_search của Hermes và dữ liệu thực tế từ Google Search Console.
Về Google Search Console (GSC): Đã kết nối thành công và lưu trữ cấu hình tại /root/.config/claude-seo/oauth-token.json. Không cần chạy lại quy trình xác thực OAuth trừ khi Google yêu cầu cấp lại quyền. GA4 hiện chưa được kết nối do tài khoản tracyng411 không quản lý mã thuộc tính đang truy vấn.
Tiêu chuẩn văn bản (Quy tắc CEO Vo):
- Viết bằng Tiếng Việt chuẩn.
- Tuyệt đối KHÔNG DÙNG ký tự gạch ngang/gạch nối (-) trong nội dung (ngoại trừ URL/đường dẫn).
- Sử dụng bảng biểu và danh sách số thứ tự/bullet point tròn.