TRUY CẬP CHO AGENT

Kết nối AiTopNews với agent của bạn

3 cách truy cập (MCP · RSS · API) đọc cùng một dữ liệu: tuyển chọn, bảng độ nóng, bản tin ngày, tuần và tháng. Chọn cách mà công cụ của bạn hỗ trợ. Tất cả đều ẩn danh và chỉ đọc: không cần đăng ký, không cần API key.

Dịch vụ hoạt độngPhiên bản 4.0.0Ẩn danh, chỉ đọc · không cần key

MCPThêm 7 công cụ từ một địa chỉClaude Desktop, Cursor và các MCP client từ xa khác RSSSao chép địa chỉ và đăng kýReeder、Folo、Inoreader、n8n REST APIGET ẩn danh cho chương trình của bạnScript, bot, mini app, bảng điều khiển

REST API · 4.0.0

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

Không cần token; trình duyệt gọi khác origin, curl hay HTTP client mặc định của mọi ngôn ngữ đều gọi được. Đường dẫn bắt đầu bằng /api/v1; các trường và mã lỗi nằm trong OpenAPI .

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

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

Lọc theo chuyên mục

Thêm category vào một yêu cầu items để chỉ lấy một chuyên mục; bỏ trống để lấy tất cả. Các mục mang cùng những giá trị chuyên mục như vậy.

Chuyên mục	Tham số yêu cầu
Mô hình AI	`category=ai-models`
Sản phẩm AI	`category=ai-products`
Tin ngành	`category=industry`
Nghiên cứu	`category=paper`
Hướng dẫn	`category=tip`
Quan điểm	`category=opinion`

Rẻ hơn và nhanh hơn

01
Bật nén
Thêm --compressed vào curl, hoặc bật gzip hay br ở client khác. JSON nén chỉ còn một phần tư đến một phần tám dung lượng.
02
Gửi ETag
Giữ ETag từ phản hồi và gửi If-None-Match ở lần sau; nội dung không đổi sẽ trả 304 mà không có body.
03
Tải đúng nhịp
Items và bảng độ nóng nhiều nhất một lần một phút; bản tin ngày một lần sau mỗi ngày lúc 08:00, bản tin tuần và tháng một lần sau mỗi số; khi lật về trang cũ, dừng ở mục bạn đã có.

Nội dung đổi thế nào: items đến suốt ngày, tuyển chọn đổi vài chục lần mỗi ngày, còn bản tin ngày, tuần và tháng mỗi thứ ra một lần (giờ Bắc Kinh).

Danh sách endpoint

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

Công thức thường dùng

bash

# Lần đầu: giữ ETag từ header của phản hồi\n# Sau đó tối đa một phút một lần, gửi kèm ETag; 304 nghĩa là không đổi\n
curl --compressed -i 'https://aitopnews.wiki/api/v1/items?mode=selected&window=24h&limit=20'
curl --compressed -i -H 'If-None-Match: <last ETag>' 'https://aitopnews.wiki/api/v1/items?mode=selected&window=24h&limit=20'

Để lật về trang cũ, truyền page.nextCursor trở lại làm cursor và dừng ở mục bạn đã có; đừng mỗi lần lại lật bảy ngày.

Khi có lỗi

400: Tham số sai: sửa theo OpenAPI và mã lỗi trả về; đừng tự nới rộng truy vấn. Cursor không hợp lệ hoặc nằm ngoài khoảng sẽ trả invalid_cursor — hãy bắt đầu lại từ trang đầu.
409: snapshot_required: phần tăng thêm không thể tiếp tục an toàn; hãy lấy snapshot đầy đủ mới.
429: Quá nhiều yêu cầu: chờ theo Retry-After và đừng thử lại song song.
5xx: Lùi dần theo cấp số nhân và tiếp tục dùng kết quả tốt gần nhất; dịch vụ công khai không cam kết SLA.

Truy cập ẩn danh không phải giấy phép cho mọi cách dùng: xemĐiều khoản.