SEO 知識洞察 API
SEO Knowledge Insight API

具備 RAG 對話、語意搜尋、SEO 週報生成與 ETL Pipeline 管理功能的 SEO 知識庫 API。

SEO knowledge base API with RAG chat, semantic search, weekly reports, and ETL pipeline management.

功能特色
Features

• QA 知識庫 — 1,469+ 筆 SEO 問答，來自會議與文章（8 個來源）
  QA Knowledge Base — 1,469+ SEO Q&A pairs from meetings and articles (8 sources)
• 語意搜尋 — 混合搜尋（pgvector embedding + 關鍵字），支援同義詞擴展
  Semantic Search — Hybrid search (pgvector embedding + keyword) with synonym expansion
• RAG 對話 — 單輪 RAG 與多輪 Agent 模式，支援行內引用
  RAG Chat — Single-turn RAG and multi-turn agent mode with inline citations
• 週報生成 — 從指標快照自動生成 SEO 週報（7 個維度）
  Weekly Reports — Automated SEO report generation from metrics snapshots (7 dimensions)
• Pipeline 管理 — 支援 Notion、Medium、iThome、Google 案例、Ahrefs、SEJ、Growth Memo 的 ETL Pipeline
  Pipeline Management — ETL pipeline for Notion, Medium, iThome, Google Case Studies, Ahrefs, SEJ, and Growth Memo
• 對話管理 — 持久化多輪對話 Session，支援成熟度感知回應
  Session Management — Persistent multi-turn chat sessions with maturity-aware responses
• 會議準備 — 為 SEO 顧問會議生成深度研究報告
  Meeting Prep — Deep research reports for SEO consulting sessions

Base URL

快速開始
Quick Start

# 健康檢查（不需要認證）/ Health check (no auth required)
curl http://localhost:8002/health

# 搜尋知識庫 / Search the knowledge base
curl -X POST http://localhost:8002/api/v1/search \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-key" \
  -d '{"query": "Core Web Vitals", "top_k": 5}'

API 文件
API Documentation

互動式 API 參考文件位於首頁，由 Scalar 驅動，支援完整的線上測試功能。

The interactive API reference is available at the root page with full Try It functionality powered by Scalar.