koala73/worldmonitor

Kết luận: partial · Công nghệ: osint · monitoring-dashboard · news-aggregation · geopolitics · mcp

worldmonitor là một dashboard tình báo thời gian thực gom tin tức, tín hiệu địa chính trị và theo dõi hạ tầng vào một giao diện situational awareness duy nhất. Với quy mô 76k+ stars, repo này đáng xem như một mẫu tham chiếu mạnh về OSINT + monitoring UX + AI aggregation, nhưng phù hợp hơn để học kiến trúc/pattern hơn là nhúng nguyên khối vào các dự án cá nhân hiện có.

📖 Giới thiệu chi tiết

🧩 Nó là gì?

koala73/worldmonitor là một dashboard theo dõi tình hình thế giới theo thời gian gần thực: tin tức, rủi ro địa chính trị, tài chính, năng lượng, thiên tai, hạ tầng và nhiều tín hiệu khác được gom vào một giao diện bản đồ/dữ liệu trực quan.

Nói đơn giản: đây là “phòng quan sát thế giới” chạy trên web, desktop, CLI và API, có AI hỗ trợ tóm tắt và kết nối các sự kiện quan trọng.

🎯 Giải quyết vấn đề gì? Dành cho ai?

koala73/worldmonitor giúp bạn tránh phải mở hàng chục trang tin, biểu đồ, bản đồ và nguồn dữ liệu khác nhau để hiểu “đang có chuyện gì xảy ra trên thế giới”.

Dự án này phù hợp với:

• Người muốn theo dõi tin tức toàn cầu theo cách có cấu trúc, không chỉ đọc từng bài lẻ.
• Nhà phân tích, nhà nghiên cứu, phóng viên, sinh viên hoặc người làm chính sách cần nhìn nhanh các điểm nóng.
• Người quan tâm đến tài chính, hàng hóa, năng lượng, công nghệ, khí hậu, hàng không, quân sự hoặc an ninh mạng.
• Lập trình viên muốn tự host, tích hợp dữ liệu qua API, CLI, SDK hoặc MCP server.
• Người thích chạy AI cục bộ bằng Ollama, tức là chạy mô hình AI trên máy của mình thay vì bắt buộc dùng dịch vụ bên ngoài.

⚙️ Hoạt động ra sao?

• Thu thập dữ liệu từ hơn 65 nhà cung cấp/API bên ngoài, bao gồm tin tức, địa chính trị, tài chính, năng lượng, khí hậu, hàng không, cyber, quân sự và hạ tầng.
• Gom hơn 500 nguồn tin đã chọn lọc vào 15 nhóm nội dung, sau đó dùng AI để tổng hợp thành các bản tin ngắn dễ đọc.
• Hiển thị dữ liệu trên bản đồ 3D dạng quả địa cầu bằng globe.gl và bản đồ phẳng WebGL bằng deck.gl, có 56 loại lớp bản đồ.
• Tìm mối liên hệ giữa nhiều luồng tín hiệu, ví dụ: quân sự, kinh tế, thiên tai và dấu hiệu leo thang căng thẳng.
• Tính Country Instability Index (CII), tức chỉ số đo mức độ bất ổn quốc gia, cho 31 quốc gia Tier-1.
• Có radar tài chính theo dõi 29 sàn chứng khoán, hàng hóa, crypto và các tín hiệu thị trường tổng hợp.
• Hỗ trợ 6 biến thể từ cùng một codebase: worldmonitor.app, tech.worldmonitor.app, finance.worldmonitor.app, commodity.worldmonitor.app, happy.worldmonitor.app, energy.worldmonitor.app.
• Có app desktop bằng Tauri 2 cho Windows, macOS và Linux.
• Hỗ trợ 25 ngôn ngữ, bao gồm cả nguồn tin bản địa và RTL, tức các ngôn ngữ viết từ phải sang trái.
• Cho phép truy cập bằng trình duyệt, REST API, MCP server, CLI worldmonitor, và SDK cho Python, Ruby, Go.

🆚 Khi nào nên dùng / không nên

Nên dùng koala73/worldmonitor khi:

• Bạn muốn một nơi tổng hợp nhiều loại tín hiệu toàn cầu thay vì chỉ đọc tin tức thông thường.
• Bạn cần bản đồ, dashboard, chỉ số rủi ro và tóm tắt AI trong cùng một giao diện.
• Bạn muốn tự chạy dự án, tùy biến, hoặc tích hợp vào script/agent qua API, CLI, SDK.
• Bạn cần lựa chọn chạy AI cục bộ với Ollama, không nhất thiết phải có API key.

Không nên dùng khi:

• Bạn chỉ cần đọc tin tức hằng ngày đơn giản như một trang báo thông thường.
• Bạn muốn một sản phẩm “cắm là chạy” cực nhẹ, không cần bản đồ, dữ liệu thời gian thực hay nhiều nguồn phức tạp.
• Bạn cần dữ liệu tuyệt đối chính xác cho quyết định pháp lý, quân sự, tài chính hoặc an toàn sinh mạng mà không có bước kiểm chứng độc lập.
• Bạn không muốn tuân thủ giấy phép AGPL-3.0-only khi sửa đổi hoặc triển khai theo cách có yêu cầu chia sẻ mã nguồn.

So với việc tự mở nhiều trang tin, biểu đồ tài chính và bản đồ riêng lẻ, koala73/worldmonitor mạnh ở chỗ gom chúng vào một hệ thống thống nhất. Đổi lại, vì hệ thống rộng và nhiều tính năng, người mới có thể cần chút thời gian để hiểu hết các phần nâng cao.

🚀 Bắt đầu nhanh

Cách chạy bản web trên máy cá nhân:

git clone https://github.com/koala73/worldmonitor.git
cd worldmonitor
npm install
npm run dev

Sau đó mở:

http://localhost:3000

Ứng dụng chạy được mà không cần biến môi trường. Nếu muốn đổi cổng, đặt DEV_PORT trong .env.local.

Chạy các biến thể khác khi phát triển:

npm run dev:tech       # tech.worldmonitor.app
npm run dev:finance    # finance.worldmonitor.app
npm run dev:commodity  # commodity.worldmonitor.app
npm run dev:happy      # happy.worldmonitor.app
npm run dev:energy     # energy.worldmonitor.app

Dùng CLI nhanh bằng npx:

npx worldmonitor tools

Cài CLI toàn cục:

npm install -g worldmonitor
worldmonitor risk IR --api-key wm_xxx

Dùng REST API:

Base URL: https://api.worldmonitor.app
OpenAPI: https://worldmonitor.app/openapi.yaml

Dùng MCP server:

https://worldmonitor.app/mcp

tools/list có thể dùng công khai. tools/call cần xác thực bằng header X-WorldMonitor-Key hoặc OAuth.

Cài SDK Python:

pip install worldmonitor-sdk

Cài SDK Ruby:

gem install worldmonitor

Cài SDK Go:

go get github.com/koala73/worldmonitor/sdk/go

Kiểm tra kiểu dữ liệu và build production:

npm run typecheck
npm run build:full

✅ Điểm mạnh & ⚠️ Hạn chế

✅ Điểm mạnh:

• Gom nhiều loại dữ liệu quan trọng vào một dashboard thống nhất: tin tức, bản đồ, tài chính, năng lượng, hạ tầng, rủi ro và tín hiệu địa chính trị.
• Có AI hỗ trợ tóm tắt, giúp người dùng mới nắm ý chính nhanh hơn thay vì đọc quá nhiều nguồn rời rạc.
• Chạy được trên web, desktop, CLI, REST API, MCP server và SDK, nên phù hợp cả người dùng phổ thông lẫn lập trình viên.
• Có thể chạy với Ollama để dùng AI cục bộ, không bắt buộc phải có API key cho mọi thứ.
• Một codebase nhưng có nhiều biến thể theo chủ đề như world, tech, finance, commodity, happy và energy.
• Hỗ trợ nhiều ngôn ngữ và nhiều nền tảng: Windows, macOS, Linux.

⚠️ Hạn chế:

• Một số nguồn dữ liệu hoặc tính năng chuyên sâu có thể cần credentials/API key riêng.
• Vì dự án bao phủ rất nhiều lĩnh vực, người mới có thể thấy giao diện và thuật ngữ hơi dày lúc đầu.
• Dữ liệu tổng hợp và tóm tắt AI nên được xem là công cụ hỗ trợ phân tích, không phải nguồn sự thật tuyệt đối.
• Nếu tự host hoặc chỉnh sửa để dùng nghiêm túc, bạn cần hiểu và tuân thủ giấy phép AGPL-3.0-only.
• Các tính năng bản đồ, AI và dữ liệu thời gian thực có thể yêu cầu máy hoặc hạ tầng mạnh hơn so với một website tin tức đơn giản.