artpi/roam-research-private-api

🔌 Roam Research Private API - Kết nối Roam Research với mọi dự án của bạn

Roam Research chưa có REST API chính thức, dự án này dùng Puppeteer mở trình duyệt ẩn tự động hóa mọi thao tác như người dùng thực hiện.

Roam Research Private API là một thư viện Node.js và công cụ dòng lệnh (roam-api) giúp bạn kết nối Roam Research với các ứng dụng khác. Vì Roam chưa cung cấp REST API, dự án sử dụng Puppeteer để điều khiển trình duyệt ẩn, thực hiện các hành động tự động như export, tìm kiếm, query và tạo nội dung. Thư viện đi kèm trình duyệt Chrome, hỗ trợ đăng nhập bằng email/password (không hỗ trợ Google login).

✨ Điểm nổi bật

• Export toàn bộ graph: xuất graph ra thư mục hoặc đẩy lên URL tùy chỉnh
• Tìm kiếm nhanh: tìm kiếm cụm từ trong graph, trả về JSON
• Hỗ trợ Datalog query: thực hiện truy vấn Datalog đầy đủ qua roam-api query
• Tạo block tự động: chèn nội dung vào Daily Notes hoặc theo UID
• Dùng như thư viện Node.js: tích hợp vào project, script bash, GitHub Actions
• Đi kèm Chrome: không cần cài đặt Chrome thủ công

💡 Vì sao đáng chú ý

Dự án khắc phục thiếu hụt REST API chính thức của Roam bằng cách mô phỏng hành vi người dùng qua trình duyệt ẩn. Phù hợp cho workflow tự động hoá như đồng bộ dữ liệu, backup graph, hoặc tích hợp Roam vào hệ sinh thái công cụ khác. Cảnh báo: chỉ hỗ trợ đăng nhập email/password, không hỗ trợ Google login.

#RoamResearch #APIWrapper #Puppeteer #Automation #TiniX