---
name: gpt-researcher
description: Self-host GPT-Researcher — agent tự động phân nhỏ câu hỏi → tìm 20+ nguồn web song song → tổng hợp báo cáo có trích nguồn. Cho nghiên cứu thị trường / đối thủ / sản phẩm mới.
---

# Skill: GPT-Researcher — Trợ lý nghiên cứu nhanh

## Skill này làm gì

GPT-Researcher là agent open-source tự host trên máy bạn, mô phỏng cách 1 chuyên viên nghiên cứu thị trường làm việc. Bạn đưa 1 câu hỏi, nó tự phân nhỏ thành 5-10 sub-question, search web song song 20+ nguồn (Tavily/Google/Bing/DuckDuckGo), lọc nhiễu, tổng hợp thành báo cáo markdown có trích nguồn đầy đủ trong 2-5 phút.

## Khi nào dùng

- Nghiên cứu đối thủ trước launch sản phẩm mới
- Audit thị trường ngách mới (vd: "Quy mô thị trường cà phê specialty VN 2024-2026")
- Tổng hợp tin ngành hàng tuần cho newsletter / team meeting
- Due diligence trước đầu tư / hợp tác
- Brief sản phẩm mới trước viết landing page / sales script

## Cách cài (Python + Docker, 15 phút)

```bash
# Docker (khuyến nghị)
git clone https://github.com/assafelovic/gpt-researcher.git
cd gpt-researcher

cat > .env << 'EOF'
OPENAI_API_KEY=<paste_openai_key_here>
TAVILY_API_KEY=<paste_tavily_key_here>
EOF

docker-compose up --build
# Mở http://localhost:8000

# Hoặc Python local
pip install -r requirements.txt
python -m uvicorn main:app --reload
```

Lấy API key:
- OpenAI: https://platform.openai.com/api-keys
- Tavily (search engine cho AI): https://tavily.com/ (free 1000 requests/tháng)

## Câu lệnh chủ đạo (Vietnamese)

Sửa file `gpt_researcher/config/variables/default.py`, đổi `REPORT_FORMAT`:

```
Phân tích chi tiết về: {query}

Yêu cầu báo cáo:
- Viết hoàn toàn bằng tiếng Việt, văn phong chuyên nghiệp
- Độ dài 2000-3000 từ, chia rõ section
- Phần đầu: Tóm tắt 5 ý chính (bullet)
- Phần thân: Phân tích sâu mỗi sub-topic + số liệu cụ thể
- Phần cuối: Kết luận + 3 hành động đề xuất cho doanh nghiệp Việt Nam
- Trích nguồn đầy đủ dạng [1], [2]... với link gốc cuối báo cáo
- Ưu tiên nguồn Việt Nam (VnExpress, Cafef, Brands Vietnam) khi có
- Nếu nguồn tiếng Anh, dịch số liệu + insight sang Việt
```

Query mẫu:
```
Nghiên cứu thị trường khoá học AI tiếng Việt cho SME VN 2026: 
top 5 đối thủ, mô hình giá, kênh phân phối chính, gap thị trường còn trống.
```

## Quyền hạn cần thiết

- Máy có Docker hoặc Python 3.10+
- Internet ổn định
- OpenAI API key (~$0.3-0.8/báo cáo) hoặc Anthropic Claude (~$0.5-1.5)
- Tavily API key
- ~500MB ổ cứng cho Docker images
- Port 8000 + 8080 trống

## Lưu ý cho doanh nghiệp Việt Nam

- Crawl tốt các trang Việt (VnExpress, Cafef, Brands Vietnam) khi query Việt
- Cần API key (~$0.5-1.5/research) — nạp tối thiểu $10 dùng 1-2 tháng
- Output English-default → cần sửa `default.py` prompt sang Việt
- Trang chặn bot (FB, IG, LinkedIn) → bỏ qua, workaround copy manual link
- Báo cáo dài 3000+ từ → mở Obsidian / Notion / Google Docs đọc

## Mẹo dùng hiệu quả

1. **Query càng cụ thể càng tốt** — "thị trường cà phê specialty 200-500k/kg cho Gen Z thành thị VN 2024-2026" thay vì "thị trường cà phê VN"
2. **Chạy 2 lần với góc khác nhau** — tổng quan trước, deep dive 1 đối thủ sau
3. **Save báo cáo dạng markdown + import Obsidian vault** — build knowledge base nội bộ

---

**Tác giả:** Eroca Thanh · 2026-05-28
