Solann API — Keyword Data Provider

Data provider mặc định của SEO Kit — cung cấp premium Google Ads keyword data tối ưu cho AI agent.

📌 Đây là data provider ưu tiên #1 — được dùng trước DataForSEO, Ahrefs, Semrush. Nếu Solann API chưa cấu hình, hệ thống tự fall back sang nguồn khác.

Tổng Quan

Tại Sao Solann Là Mặc Định?

• Premium data: Dữ liệu trực tiếp từ Google Ads API (volume, CPC, trends chính xác)
• AI-optimized: Hỗ trợ ngôn ngữ tự nhiên cho location/language (ví dụ: "vietnam", "tiếng việt")
• Topic clusters: Tự phân loại keywords theo semantic groups
• Zero-dependency: Không cần pip install — chỉ dùng Python stdlib
• In-house: Không phát sinh chi phí bên thứ ba

Thứ Tự Ưu Tiên Provider

Solann API (#1) → Google Ads Keyword Planner → DataForSEO → HTML-only

Cài Đặt

Tạo file .agent/config/solann-api.json:

{
  "api_key": "sk-xxxx",
  "default_location": "VN",
  "default_language": "vi"
}

💡 API key được cung cấp khi mua license. Quản lý tại app.solann.io.

Nếu chưa cấu hình, SEO Kit sẽ thông báo và tự fall back sang HTML-only mode.

2 Scripts

1. keyword_volume.py — Keyword Research

Lấy volume + trends + topics + competitor keyword extraction.

# Theo danh sách từ khóa
python .agent/skills/seo-solann/scripts/keyword_volume.py --keywords "mua sach, dien thoai"

# Theo URL đối thủ (tự trích xuất keywords)
python .agent/skills/seo-solann/scripts/keyword_volume.py --url "https://competitor.com"

# Kết hợp cả hai + tuỳ chỉnh location/language
python .agent/skills/seo-solann/scripts/keyword_volume.py \
  --keywords "seo tool" \
  --url "https://competitor.com" \
  --location vietnam \
  --language vi

2. keyword_suggest.py — Long-tail Expansion

1 seed keyword → hàng chục biến thể với đầy đủ metrics.

# Mở rộng cơ bản
python .agent/skills/seo-solann/scripts/keyword_suggest.py --seed "may loc nuoc" --max 30

# Chỉ Google Autocomplete (không Alphabet Soup)
python .agent/skills/seo-solann/scripts/keyword_suggest.py --seed "seo" --max 50 --no-alphabet-soup

Phương pháp mở rộng:

• Google Autocomplete suggestions
• Alphabet Soup technique (thêm a→j vào seed)
• Tất cả suggestions tự động enriched với volume + trend + topics

Dữ Liệu Trả Về

Mỗi keyword bao gồm:

Tham Số Chung

V1 — Tính Năng Hiện Tại

Xử Lý Sự Cố

Workflow Liên Quan

Kỹ Năng Liên Quan