KẾT NỐI AGENT

Kết nối baomoi.news với Agent của bạn

3 cách (MCP, RSS, API) đều đọc cùng một nguồn dữ liệu: tin chọn lọc, tin nóng, bản tin ngày, tuần và tháng; chọn cách hợp với công cụ của bạn. Tất cả đều ẩn danh, chỉ đọc, không cần đăng ký hay API Key.

Dịch vụ bình thườngPhiên bản 4.0.0Ẩn danh, chỉ đọc · Không cần Key

MCPĐiền một địa chỉ, có thêm 7 công cụClaude Desktop, Cursor và các ứng dụng MCP từ xa RSSSao chép địa chỉ, đăng ký bằng trình đọc RSSReeder, Folo, Inoreader, n8n REST APIGET ẩn danh, tự viết chương trình lấy dữ liệuScript, bot, ứng dụng nhỏ, bảng theo dõi

REST API · 4.0.0

GET ẩn danh, dùng được ngay

Không cần token; gọi trực tiếp được từ trình duyệt (CORS), curl và HTTP client mặc định của mọi ngôn ngữ. Đường dẫn là /api/v1, trường dữ liệu và mã lỗi theo OpenAPI.

Yêu cầu đầu tiên

curl --compressed 'https://baomoi.news/api/v1/items?mode=selected&window=24h&limit=20'

Lọc theo chuyên mục

Thêm category vào yêu cầu lấy tin để chỉ lấy chuyên mục tương ứng; không truyền thì lấy mọi chuyên mục. Trường category của tin trả về cũng dùng các giá trị trong bảng dưới.

Chuyên mục	Tham số
Thời sự trong nước	`category=thoi-su`
Thế giới	`category=the-gioi`
Kinh doanh	`category=kinh-doanh`
Bất động sản	`category=bat-dong-san`
Pháp luật	`category=phap-luat`
Giáo dục	`category=giao-duc`
Sức khỏe	`category=suc-khoe`
Đời sống	`category=doi-song`
Công nghệ	`category=cong-nghe`
Xe	`category=xe`
Thể thao	`category=the-thao`
Giải trí	`category=giai-tri`
Du lịch	`category=du-lich`
Góc nhìn	`category=goc-nhin`

Tiết kiệm và nhanh hơn

01
Bật nén
Thêm --compressed cho curl, các client khác bật gzip hoặc br. JSON sau khi nén chỉ còn 1/4 đến 1/8.
02
Gửi kèm ETag
Lưu ETag trong phản hồi, lần sau gửi kèm If-None-Match; nội dung không đổi thì trả về 304, không kèm nội dung.
03
Lấy theo nhịp
Tin và tin nóng nhanh nhất mỗi phút một lần; bản tin ngày lấy một lần sau 07:00 hằng ngày, bản tin tuần và tháng lấy một lần sau khi ra số; khi lật trang lùi, gặp tin đã có thì dừng.

Nội dung thay đổi bao lâu một lần: tin mới vào liên tục cả ngày, tin chọn lọc thay đổi từ vài đến vài chục lần mỗi ngày; bản tin ngày ra 07:00 hằng ngày, bản tin tuần 08:00 thứ Hai hằng tuần, bản tin tháng 08:30 ngày 1 hằng tháng (giờ Việt Nam).

Danh sách endpoint

Đường dẫn	Dùng để làm gì	Bao lâu lấy một lần
Tin tức
`/api/v1/items`	Tin chọn lọc hoặc tất cả tin trong 7 ngày gần nhất, lọc được theo chuyên mục, khoảng thời gian, từ khóa	Nhanh nhất mỗi phút một lần
Tin nóng và sự kiện
`/api/v1/hot-topics`	Top 10 tin nóng hiện tại	Nhanh nhất mỗi phút một lần
`/api/v1/stories/{publicId}`	Dòng thời gian bài viết, bản tổng hợp AI và các sự kiện liên quan của một sự kiện	Khi cần
Bản tin ngày
`/api/v1/dailies/latest`	Số bản tin ngày mới nhất	Một lần sau 07:00 hằng ngày
`/api/v1/dailies/{date}`	Bản tin ngày theo ngày chỉ định; tin bị rút sẽ bị gỡ khỏi trích dẫn	Kiểm tra ETag trước khi dùng khi bộ nhớ đệm hết hạn
`/api/v1/dailies`	Danh mục ngày của bản tin ngày	Mỗi ngày một lần
Bản tin tuần và tháng
`/api/v1/weeklies/latest`	Số bản tin tuần mới nhất: tin chính, tổng quan và điểm nhấn trong tuần, xếp theo chuyên mục	Một lần sau 08:00 thứ Hai hằng tuần
`/api/v1/weeklies/{week}`	Tuần chỉ định, theo tuần ISO như 2026-W39; tin bị rút sẽ bị gỡ khỏi trích dẫn	Kiểm tra ETag trước khi dùng khi bộ nhớ đệm hết hạn
`/api/v1/weeklies`	Danh mục bản tin tuần	Mỗi tuần một lần
`/api/v1/monthlies/latest`	Số bản tin tháng mới nhất	Một lần sau 08:30 ngày 1 hằng tháng
`/api/v1/monthlies/{month}`	Tháng chỉ định, ví dụ 2026-09	Kiểm tra ETag trước khi dùng khi bộ nhớ đệm hết hạn
`/api/v1/monthlies`	Danh mục bản tin tháng	Mỗi tháng một lần
Cho trợ lý AI
`/api/v1/agent`	Hướng dẫn sử dụng cho Agent; các địa chỉ được liệt kê trả về Markdown tiếng Việt đã sắp xếp sẵn	Khi cần
Đồng bộ toàn bộ tin chọn lọc
`/api/v1/selected/snapshot`	Toàn bộ tin chọn lọc hiện tại, lấy hết qua phân trang	Chỉ lần đầu
`/api/v1/selected/changes`	Các tin thêm mới, sửa đổi và bỏ chọn sau đó	Vài phút một lần

Cách dùng thường gặp

bash

# Lần đầu: lưu ETag trong header phản hồi
curl --compressed -i 'https://baomoi.news/api/v1/items?mode=selected&window=24h&limit=20'
# Sau đó nhanh nhất mỗi phút một lần, gửi kèm ETag; trả về 304 nghĩa là không có gì mới
curl --compressed -i -H 'If-None-Match: <ETag lần trước>' 'https://baomoi.news/api/v1/items?mode=selected&window=24h&limit=20'

Khi cần lật trang lùi, truyền lại page.nextCursor làm cursor, gặp tin đã có thì dừng, đừng mỗi lần lật lại cả 7 ngày.

Khi gặp lỗi

400: Sai tham số: sửa theo OpenAPI và mã code trả về, đừng tự đổi sang truy vấn rộng hơn. Cursor không hợp lệ hoặc trượt khỏi khoảng thời gian sẽ trả về invalid_cursor, hãy bắt đầu lại từ trang đầu.
409: snapshot_required: không thể nối tiếp phần thay đổi một cách an toàn, hãy lấy lại snapshot đầy đủ.
429: Gọi quá dày: chờ theo Retry-After, đừng thử lại song song.
5xx: Lùi thời gian thử lại theo cấp số nhân, tạm dùng kết quả thành công lần trước; dịch vụ công khai không cam kết SLA.

Gọi ẩn danh được không có nghĩa là mọi mục đích sử dụng đều được phép; xem Quy định sử dụng.