[Open Source] #238 - GEO-SEO Claude Code Skill: Hạ tầng tối ưu hóa Website cho AI Search (GEO) với kiến trúc Orchestrator-Subagent, Python và cơ chế đánh giá Citability thông minh
Trong kỷ nguyên của các công cụ tìm kiếm sử dụng mô hình ngôn ngữ lớn (SGE, Perplexity, ChatGPT), kỹ thuật SEO truyền thống đang dần nhường chỗ cho Generative Engine Optimization (GEO). Thay vì chỉ tập trung vào từ khóa, mục tiêu mới là làm sao để website được AI trích dẫn và ưu tiên trong câu trả lời. GEO-SEO Claude Code Skill ra đời như một bộ công cụ điều phối (Orchestration Tool) tiên phong, tích hợp trực tiếp vào Claude Code để tự động hóa quy trình kiểm toán, đánh giá khả năng trích dẫn và tối ưu hóa thực thể (Entity) cho website.
Dưới góc độ kỹ thuật, dự án là một minh chứng xuất sắc về việc xây dựng Agentic Workflows, kỹ thuật Phân tích dữ liệu đa nền tảng và cơ chế lượng hóa chất lượng nội dung dựa trên các nghiên cứu khoa học về AI.
Github: https://github.com/v8u7/geo-seo-claude-code-skill
🛠️ 1. Nền tảng công nghệ: AI-Native Developer Tooling
Dự án tận dụng hệ sinh thái Claude Code để biến các câu lệnh ngôn ngữ tự nhiên thành quy trình kiểm định kỹ thuật khắt khe:
- Logic Engine (Python 3.12): Đảm nhiệm các tác vụ tính toán "hạng nặng" như trích xuất dữ liệu qua BeautifulSoup4, tính toán ma trận tương quan và render báo cáo PDF chuyên nghiệp bằng ReportLab.
- Skill Architecture (Markdown-based): Sử dụng chuẩn
SKILL.mdcủa Claude Code để định nghĩa các hướng dẫn thực thi (Instructions). Điều này cho phép AI hiểu rõ vai trò và khả năng của từng module công cụ mà không cần huấn luyện lại. - Infrastructure Bridge: Tích hợp Playwright để xử lý các trang web SPA (Single Page Application), đảm bảo AI có thể "nhìn thấy" nội dung động giống như một trình duyệt thực thụ.
- Structured Metadata: Tự động hóa việc tạo và kiểm tra JSON-LD Schema, giúp website "giao tiếp" hiệu quả hơn với các bọ tìm kiếm (Crawlers) của các mô hình ngôn ngữ lớn.
🏗️ 2. Trụ cột kiến trúc: Orchestrator-Subagent Model
Kiến trúc của dự án được thiết kế theo mô hình phân cấp, đảm bảo tính chuyên sâu và khả năng xử lý song song:
- Central Orchestrator: Lõi điều phối (
geo/SKILL.md) tiếp nhận mục tiêu từ người dùng và phân rã thành các nhiệm vụ con (Sub-tasks), sau đó điều phối các đại lý chuyên biệt để thực hiện. - Modular Sub-skills: Hệ thống chia nhỏ thành 11 module độc lập (trong thư mục
skills/), tập trung vào 5 trụ cột GEO:- AI Visibility Agent: Đánh giá khả năng hiển thị trên GPT/Perplexity.
- Platform Context Agent: Phân tích quyền uy thương hiệu trên Reddit, YouTube.
- Content Intelligence Agent: Kiểm tra độ sâu nội dung và tính hữu dụng.
- Technical Health Agent: Quét Robots.txt, Sitemap và cấu trúc URL.
- Schema Orchestrator: Tối ưu hóa thực thể doanh nghiệp qua dữ liệu cấu trúc.
🔄 3. Workflow: Vòng đời của một chu kỳ Kiểm toán GEO (Sequence Diagram)
Sơ đồ mô tả quy trình hệ thống điều phối các Agent để biến một URL thành kế hoạch hành động tối ưu:
⚡ 4. Các kỹ thuật "Pro-level" trong mã nguồn
- AI Citability Algorithm: Một kỹ thuật độc đáo dựa trên nghiên cứu từ Princeton. Hệ thống đánh giá các đoạn văn dựa trên các tham số: độ dài vàng (134-167 từ), mật độ dữ kiện thống kê và cấu trúc "Câu trả lời trực tiếp" (Direct Answer), giúp tăng tỷ lệ được AI trích dẫn lên gấp 3 lần.
- Brand Correlation Scanning: Khác với SEO cũ chỉ quét Backlink, dự án này quét sự hiện diện của thương hiệu trên các "Nền tảng tri thức" (Reddit, YouTube, Wikipedia) – nơi AI thường lấy dữ liệu huấn luyện, để đo lường Quyền uy thực thể (Entity Authority).
- Automatic E-E-A-T Ingestion: Tự động hóa quy trình phân tích trang "Giới thiệu" và thông tin tác giả để tìm kiếm các tín hiệu về chuyên môn và độ tin cậy, đồng thời gợi ý các điểm cần bổ sung để "lấy lòng" các thuật toán đánh giá chất lượng của Google và OpenAI.
- Template-driven Schema Injection: Cung cấp kho thư mục
schema/chứa các mẫu JSON-LD tối ưu nhất cho từng loại hình (SaaS, Local Biz). Hệ thống tự động điền dữ liệu cào được vào mẫu để tạo ra mã Schema "sạch" cho lập trình viên nhúng vào website.
⚖️ 5. So sánh chiến lược
| Tiêu chí | GEO-SEO Claude Skill | SEMRush / Ahrefs | Google Search Console |
|---|---|---|---|
| Mục tiêu chính | AI Search & LLMs | Google Search truyền thống | Technical Health |
| Cơ chế đánh giá | Semantic & Citability | Keywords & Backlinks | Indexing |
| Giao diện | Agentic (Hội thoại/Code) | Dashboard tĩnh | Bảng biểu kỹ thuật |
| Khả năng thực thi | Tự tạo mã Schema/Nội dung | Chỉ báo cáo | Chỉ báo cáo |
| Tính tương lai | GEO (Thế hệ mới) | SEO (Cổ điển) | Căn bản |
✅ Kết luận: Tại sao đây là dự án hình mẫu cho kỷ nguyên AI Agent?
GEO-SEO Claude Code Skill chứng minh rằng công cụ phát triển đã bước sang trang mới: từ việc hỗ trợ viết code sang việc hỗ trợ chiến lược nghiệp vụ. Bằng cách đóng gói các thuật toán phức tạp vào các Skill đơn giản, dự án đã cho phép lập trình viên nắm giữ sức mạnh của một chuyên gia SEO AI ngay trong môi trường Terminal.
Đối với các kỹ sư AI và Marketing Engineer, nghiên cứu dự án này mang lại giá trị về:
- Kỹ thuật xây dựng Skills cho AI Agents chuyên sâu.
- Cách lượng hóa Chất lượng nội dung dựa trên thuật toán AI.
- Tư duy thiết kế Hệ thống kiểm toán tự động quy mô lớn.
All rights reserved
