MCP Xiaozhi Web
Máy chủ web hỗ trợ chatbot Xiaozhi (ESP32-S3) với các tính năng:
- Tin Thanh Niên: Đọc tin tức từ các chuyên mục RSS của Thanh Niên
- Google Custom Search Engine (CSE): Tìm kiếm Google qua API
- WebSocket: Hỗ trợ voice search và đọc bài viết cho chatbot
- Nghe Radio: Phát trực tuyến các đài VOV phổ biến với hỗ trợ HLS (Hls.js)
Tính năng
API Endpoints
| Endpoint | Mô tả |
|---|---|
GET /api/health | Health check |
GET /api/news/categories | Danh sách chuyên mục tin Thanh Niên |
GET /api/news?category=thoisu&limit=20 | Lấy tin theo chuyên mục |
GET /api/search/google?q=query&topK=5 | Tìm kiếm Google (cần cấu hình API key) |
GET /api/article/extract?url=... | Trích xuất nội dung bài viết |
WebSocket Commands (path: /ws)
| Type | Payload | Response |
|---|---|---|
hello | { type: "hello", role: "esp32" } | { type: "hello_ack", role } |
search_google | { type: "search_google", q: "query", topK: 5 } | { type: "search_results", q, results } |
read_result | { type: "read_result", index: 0 } | { type: "article_text" } hoặc { type: "article_chunk" } |
read_url | { type: "read_url", url: "..." } | { type: "article_text" } hoặc { type: "article_chunk" } |
Cài đặt
npm installChạy local
Cách 1: Sử dụng biến môi trường
GOOGLE_CSE_API_KEY=your_api_key GOOGLE_CSE_CX=a3820d0d2ddab41a4 node server/server.jsCách 2: Sử dụng file .env (tùy chọn)
Tạo file .env (không commit vào repo):
GOOGLE_CSE_API_KEY=your_api_key
GOOGLE_CSE_CX=a3820d0d2ddab41a4Sau đó chạy với dotenv:
node --env-file=.env server/server.jsHoặc cài đặt dotenv package:
npm install dotenvTruy cập: http://localhost:3000
Triển khai trên Render
- Tạo Web Service mới từ repository này
- Vào Dashboard → Service → Environment
- Thêm các biến môi trường:
- GOOGLE_CSE_API_KEY: API key Google của bạn - GOOGLE_CSE_CX: a3820d0d2ddab41a4
- Deploy hoặc Redeploy để áp dụng
⚠️ Bảo mật: KHÔNG commit API key vào repository. Luôn sử dụng biến môi trường.
Radio trực tuyến
Danh sách đài được lưu tại public/radios.json. Mỗi phần tử gồm:
{
"id": "vov1", // duy nhất, dùng cho data-radio-id
"name": "VOV1 - Thời sự",
"description": "Mô tả ngắn",
"location": "Toàn quốc",
"streamUrl": "https://.../playlist.m3u8", // HLS hoặc MP3/AAC trực tiếp
"website": "https://..." // tùy chọn
}- Nếu stream sử dụng HLS (
.m3u8), trình duyệt sẽ tự động kích hoạt Hls.js (qua CDN) để phát trên Chrome/Edge/Firefox. - Bạn có thể thêm/bớt đài bằng cách cập nhật file JSON rồi redeploy. Không cần chỉnh code frontend/backend.
- Hãy đảm bảo đường dẫn stream hợp pháp và cho phép phát ở client (CORS).
Đài đang được cấu hình sẵn
VOH-M FM 92 - 92.5 MHz(https://strm.voh.com.vn/radio/channel6/playlist.m3u8)VOH FM 99.9 MHz(https://strm.voh.com.vn/radio/channel3/playlist.m3u8)
Các đài VOV trước đây đã được loại bỏ do không còn phát ổn định trong môi trường hiện tại. Khi có nguồn stream hoạt động, chỉ cần thêm lại vào radios.json.Kiểm thử với ESP32
ESP32 gửi qua WebSocket:
// Tìm kiếm
{"type":"search_google","q":"thời tiết Hà Nội hôm nay","topK":5}
// Đọc kết quả thứ 1
{"type":"read_result","index":0}
// Hoặc đọc URL trực tiếp
{"type":"read_url","url":"https://example.com/article"}Cấu trúc thư mục
├── public/
│ ├── index.html # Giao diện web (Tin TN + Google CSE)
│ ├── styles.css # CSS responsive 2 cột
│ └── app.js # Frontend logic + WebSocket
├── server/
│ ├── server.js # Express + WebSocket server
│ ├── config.js # Cấu hình RSS endpoints
│ ├── rss.js # RSS parser
│ ├── googleSearch.js # Google Custom Search API
│ └── extract.js # Article content extraction
├── package.json
└── README.mdHạn mức
- Google Custom Search API: 100 queries/ngày (free tier)
- Theo dõi quota tại: https://console.cloud.google.com/apis/api/customsearch.googleapis.com
License
MIT