# 🤖 Research Assistant — Notion × AI

> Tự động thu thập, tóm tắt và phân loại tài liệu công nghệ AI trực tiếp lên Notion.

## 📋 Tổng quan

Dự án này tự động hóa quy trình nghiên cứu:
1. **Thu thập** — Đọc nội dung từ các URL bài viết
2. **Tóm tắt** — Dùng OpenAI GPT tóm tắt bằng tiếng Việt
3. **Phân loại** — AI tự động gắn tag (RAG, LangGraph, MCP, ...)
4. **Lưu trữ** — Đẩy tất cả lên Notion Database qua API

```
┌──────────┐     ┌──────────┐     ┌──────────┐     ┌──────────┐
│  Web URL │ ──▶ │  Reader  │ ──▶ │ AI (GPT) │ ──▶ │  Notion  │
│ (Bài viết│     │(Trích    │     │(Tóm tắt +│     │(Database │
│  gốc)    │     │ xuất text)│    │ phân loại)│     │ lưu trữ) │
└──────────┘     └──────────┘     └──────────┘     └──────────┘
```

## 🚀 Bắt đầu sử dụng

### 1. Cài đặt dependencies

```bash
cd MCP_Notion
pip install -r requirements.txt
```

### 2. Cấu hình môi trường

```bash
cp .env.example .env
# Mở file .env, điền token Notion và OpenAI API key
```

### 3. Chạy

```bash
# Thu thập bài viết theo chủ đề mặc định (RAG, LangGraph, MCP)
python main.py

# Thu thập chủ đề cụ thể
python main.py --topics RAG LangGraph

# Thu thập từ URL cụ thể
python main.py --urls "https://vnexpress.net" 

# Xem danh sách bài viết đã lưu
python main.py --list

# Lọc theo tag
python main.py --list --tag "RAG"
```

## 📁 Cấu trúc dự án

```
MCP_Notion/
├── main.py            # 🚀 Entry point - CLI chính
├── researcher.py      # 🔍 Thu thập & tóm tắt bài viết
├── notion_store.py    # 📦 Giao tiếp với Notion API
├── requirements.txt   # 📋 Dependencies
├── .env               # 🔑 Biến môi trường (API keys)
├── .env.example       # 📄 Template biến môi trường
└── README.md          # 📖 Bạn đang đọc file này
```

## 🏷️ Tags hỗ trợ

| Tag | Mô tả |
|-----|-------|
| `RAG` | Retrieval-Augmented Generation |
| `LangGraph` | Multi-agent orchestration framework |
| `MCP` | Model Context Protocol |
| `AI Agent` | Autonomous AI agents |
| `LLM` | Large Language Models |
| `Vector DB` | Vector databases (Chroma, Pinecone, ...) |
| `Prompt Engineering` | Kỹ thuật viết prompt |
| `Fine-tuning` | Tinh chỉnh mô hình |
| `Multi-Agent` | Hệ thống đa agent |
| `Evaluation` | Đánh giá & metrics |

## 🔗 Kết nối MCP

Dự án này cũng có thể được điều khiển trực tiếp từ AI IDE (Gemini/Claude)
thông qua MCP Notion server. Xem file `~/.gemini/antigravity/mcp_config.json`.