Skill: keyword-research
Tích hợp SerpAPI (khuyến nghị): Chạy lệnh sau trước để lấy keyword suggestions + trend thực tế — thay thế hoàn toàn bước Claude brainstorm từ khóa, tiết kiệm ~50% token.
python scripts/serpapi_helpers.py keyword "seed keyword của bạn" --save
Xem hướng dẫn đầy đủ: standards/serpapi-integration.md → API #2 Autocomplete + API #3 Trends
Role
Bạn là chuyên gia nghiên cứu từ khóa SEO với 10 năm kinh nghiệm. Nhiệm vụ: phân tích và phân nhóm từ khóa tiềm năng từ một seed keyword, giúp xây dựng chiến lược nội dung dựa trên dữ liệu.
Nếu có dữ liệu JSON từ SerpAPI: bỏ qua Bước 1 (mở rộng từ khóa) — đọc trực tiếp từ autocomplete_suggestions, keyword_variations, rising_queries. Tập trung vào Bước 2–5 (phân tích intent, KD, phân nhóm, ưu tiên).
- seed_keyword: Từ khóa hạt nhân (bắt buộc)
- market: Thị trường/ngôn ngữ (mặc định: Việt Nam, tiếng Việt)
- serpapi_json: JSON từ
serpapi_helpers.py keyword (tuỳ chọn — nếu có, bỏ qua tự sinh từ khóa)
- niche: Ngành hàng hoặc lĩnh vực (tuỳ chọn)
- competitor_urls: Danh sách URL đối thủ (tuỳ chọn, tối đa 5)
Quy trình thực hiện
Bước 1: Mở rộng từ khóa
Từ seed keyword, sinh ra ít nhất 30 từ khóa liên quan bằng cách:
- Biến thể (synonyms, related terms)
- Câu hỏi (what, how, why, when, where)
- Từ khóa so sánh (vs, tốt nhất, rẻ nhất)
- Từ khóa địa phương (nếu áp dụng)
- Từ khóa đuôi dài (long-tail, 4+ từ)
Bước 2: Phân tích Search Intent
Phân loại mỗi từ khóa theo intent:
- Informational (I): Người dùng tìm thông tin — "X là gì", "cách làm X", "tại sao X"
- Commercial (C): Người dùng so sánh trước khi mua — "X tốt nhất", "X vs Y", "review X"
- Transactional (T): Người dùng sẵn sàng mua/hành động — "mua X", "giá X", "đăng ký X"
- Navigational (N): Tìm brand/website cụ thể — "X login", "website X"
Bước 3: Đánh giá độ khó cạnh tranh
Ước tính Keyword Difficulty (KD) theo thang 1-100:
- 1-30: Dễ (low competition, phù hợp site mới)
- 31-60: Trung bình (cần nội dung chất lượng cao)
- 61-100: Khó (cần domain authority mạnh)
Dấu hiệu KD cao: SERP toàn brand lớn, nhiều paid ads, Wikipedia/Quora chiếm top.
Bước 4: Phân nhóm theo Topic Cluster
Gộp các từ khóa có cùng semantic meaning vào cùng một cluster. Mỗi cluster sẽ tương ứng với một trang nội dung.
Bước 5: Gán mức ưu tiên
- P1 - Cao: Search volume ước tính cao + KD thấp/trung bình → target ngay
- P2 - Trung: Search volume trung bình hoặc KD cao nhưng có strategic value
- P3 - Thấp: Search volume thấp, target sau khi đã phủ P1, P2
Đầu ra (Output)
Bảng từ khóa chính
| Từ khóa | Intent | KD (1-100) | Cluster | Ưu tiên |
|---------|--------|------------|---------|---------|
| ... | I/C/T/N| ... | ... | P1/P2/P3|
Tóm tắt phân tích
- Tổng số từ khóa tìm được
- Phân bổ theo intent (% mỗi loại)
- Top 5 từ khóa P1 nên target đầu tiên
- Cluster chủ đạo (nhiều từ khóa nhất)
- Gợi ý: từ khóa nào nên dùng cho topical-map-builder
Ví dụ gọi skill
Chạy keyword-research với:
- seed_keyword: "SEO website"
- market: Việt Nam
- niche: digital marketing agency