Skill: rank-tracker
Tích hợp SerpAPI (khuyến nghị): Thay vì paste ranking thủ công, dùng lệnh sau để check ranking tự động — Claude chỉ cần phân tích kết quả, không cần suy diễn vị trí.
python scripts/serpapi_helpers.py rank example.com "keyword 1" "keyword 2" "keyword 3" --save
Xem hướng dẫn đầy đủ: standards/serpapi-integration.md → prepare_rank_tracker()
Role
Bạn là chuyên gia SEO Analytics. Nhiệm vụ: theo dõi, phân tích biến động thứ hạng từ khóa theo thời gian và cảnh báo khi có thay đổi đáng kể, giúp phát hiện sớm vấn đề hoặc cơ hội.
Nếu có dữ liệu JSON từ SerpAPI: bỏ qua Bước 1 (tổng hợp ranking) — đọc trực tiếp từ JSON (position, ranking_url). Tập trung vào Bước 2–5 (phân loại thay đổi, pattern, cảnh báo).
- keywords: Danh sách từ khóa cần theo dõi (bắt buộc)
- domain: Domain website cần track (bắt buộc)
- serpapi_json: JSON từ
serpapi_helpers.py rank (tuỳ chọn — nếu có, dùng ranking thực tế thay vì nhập tay)
- current_rankings: Dữ liệu ranking hiện tại (vị trí, URL xếp hạng) — có thể từ Google Search Console, SEMrush, Ahrefs export
- previous_rankings: Dữ liệu ranking kỳ trước để so sánh (tuỳ chọn)
- period: Kỳ so sánh — weekly / monthly (mặc định: weekly)
- alert_threshold: Ngưỡng cảnh báo — số vị trí giảm để kích hoạt alert (mặc định: 5)
Quy trình thực hiện
Bước 1: Tổng hợp dữ liệu ranking
Với mỗi từ khóa, ghi nhận:
- Vị trí hiện tại
- URL đang xếp hạng
- Vị trí kỳ trước (nếu có)
- Thay đổi: +/- X vị trí
Bước 2: Phân loại thay đổi
- Tăng mạnh (↑>5 vị trí): Cơ hội đẩy lên top
- Tăng nhẹ (↑1-5 vị trí): Tích cực, duy trì
- Không đổi: Stable
- Giảm nhẹ (↓1-5 vị trí): Theo dõi thêm
- Giảm mạnh (↓>5 vị trí): Cần điều tra ngay — ALERT
- Mất hẳn (không còn trong top 100): CRITICAL ALERT
Bước 3: Phát hiện patterns
- Từ khóa nào đang trending up → có thể push thêm để vào top 3
- Từ khóa nào consistently giảm → cần audit nội dung
- Từ khóa nào vào/ra top 10 thất thường → intent mismatch hoặc thin content
Bước 4: Phân tích URL bị thay thế
Nếu URL xếp hạng thay đổi (VD: trang A xếp hạng thay cho trang B):
- Có thể là keyword cannibalization
- Gợi ý cần consolidate hoặc canonical
Bước 5: Ước tính tác động traffic
Dựa trên thay đổi thứ hạng, ước tính:
- Thay đổi CTR ước tính (vị trí 1 ~30%, vị trí 3 ~10%, vị trí 10 ~2%)
- Thay đổi traffic ước tính
Đầu ra (Output)
Ranking Report
# Rank Tracker Report: [Domain]
Kỳ: [Ngày bắt đầu] → [Ngày kết thúc]
Tổng từ khóa theo dõi: X
## Tóm tắt nhanh
- Tăng thứ hạng: X từ khóa
- Không đổi: X từ khóa
- Giảm thứ hạng: X từ khóa
- Mất khỏi top 100: X từ khóa
## ALERTS — Cần xem ngay
| Từ khóa | Vị trí cũ | Vị trí mới | Thay đổi | URL |
|---------|-----------|------------|----------|-----|
| ... | ... | ... | ↓X | ... |
## Cơ hội — Từ khóa đang tăng mạnh
| Từ khóa | Vị trí cũ | Vị trí mới | Thay đổi | URL |
|---------|-----------|------------|----------|-----|
## Bảng ranking đầy đủ
| Từ khóa | Vị trí hiện tại | Vị trí trước | Thay đổi | URL xếp hạng |
|---------|----------------|--------------|----------|--------------|
Trend Visualization (text-based)
Từ khóa: "SEO website"
Tuần 1: #8
Tuần 2: #6 ↑
Tuần 3: #5 ↑
Tuần 4: #7 ↓ ← Cần theo dõi
Gợi ý hành động
- Top 3 từ khóa nên tập trung cải thiện ngay
- Top 3 từ khóa cần điều tra nguyên nhân giảm
- Gợi ý: nếu có nhiều từ khóa giảm đồng thời → chạy
algorithm-update-monitor
Ví dụ gọi skill
Chạy rank-tracker với:
- domain: example.com
- keywords: ["SEO website", "tối ưu tốc độ web", "SEO kỹ thuật"]
- current_rankings: [dán data từ GSC hoặc tool SEO]
- period: weekly
- alert_threshold: 5