koala73/worldmonitor · 上手攻略

• 仓库：koala73/worldmonitor
• 链接：https://github.com/koala73/worldmonitor
• 分类：agent / monitoring / llm-infra
• 作者：Jay
• 更新：2026-07-07

是什么

worldmonitor 是一个实时全球情报仪表板，用 AI 聚合新闻、地缘政治监测、金融市场和基础设施追踪，统一呈现在一个态势感知界面里。它并非新项目（Stars 61k+），但近期周增 +280 说明仍在快速增长，背后可能有 AI Agent 接入场景的推动。

核心亮点： - 500+ 精选新闻源，15 个分类，AI 摘要 - 双地图引擎：3D 地球（globe.gl + Three.js）和 WebGL 平面地图（deck.gl + MapLibre GL），56 种地图图层 - Country Instability Index（CII）：对 31 个 Tier-1 国家进行稳定性评分 - 本地 AI：支持 Ollama，不需要任何外部 API Key - MCP 服务器 + REST API + CLI + 多语言 SDK（Python / Ruby / Go） - 原生桌面应用（Tauri 2），支持 macOS / Windows / Linux - 25 种语言，RTL 支持

解决什么问题

• 情报碎片化：地缘政治、金融、能源、气候、军事等数据散落在各处，worldmonitor 统一汇聚
• 缺乏 AI 摘要：信息过载但缺乏 AI 驱动的结构化分析，CII 指数提供量化评估
• 需要 API 接入：开发者想把情报数据接入自己的 Agent 或工作流，提供完整 MCP/REST/CLI/SDK
• 离线/隐私需求：支持本地 Ollama，真正做到不依赖外部 AI 服务
• 多平台部署：同一个代码库可构建 6 个站点变体（world、tech、finance、commodity、happy、energy）和桌面应用

快速安装

方式一：直接克隆开发（推荐先跑通）

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

访问 http://localhost:3000（端口可通过 DEV_PORT 环境变量覆盖）。无需任何环境变量即可运行，但部分数据源需要凭证。

方式二：使用 npm CLI（不需要克隆）

# 安装 CLI
npm install -g worldmonitor   # 安装后命令为 worldmonitor 或 wm

# 查看所有 MCP 工具（无需 API Key）
npx worldmonitor tools

# 用 API Key 查询风险指数
worldmonitor risk IR --api-key wm_xxx

CLI 文档：https://www.npmjs.com/package/worldmonitor

方式三：Docker 自托管

参考官方自托管指南：https://www.worldmonitor.app/docs/getting-started

docker pull ghcr.io/aiacos/worldmonitor:latest   # 前提是镜像在 GHCR 存在
docker compose up -d

官方支持的部署方式：Vercel（Edge Functions）、Railway relay、Docker、本地 PWA。

桌面应用下载（无需安装 Node）

https://worldmonitor.app/api/download?platform=windows-exe
https://worldmonitor.app/api/download?platform=macos-arm64
https://worldmonitor.app/api/download?platform=macos-x64
https://worldmonitor.app/api/download?platform=linux-appimage

核心用法

1. Web 界面（开箱即用）

无需安装，直接访问以下站点之一： - 主站：https://worldmonitor.app - 科技：https://tech.worldmonitor.app - 金融：https://finance.worldmonitor.app - 大宗商品：https://commodity.worldmonitor.app - 能源：https://energy.worldmonitor.app - 正面/社会：https://happy.worldmonitor.app

各变体共用同一代码库，差异化在于数据源和展示逻辑。

2. MCP 服务器（Agent 开发者重点）

在支持 MCP 的 AI 客户端配置：

{
  "mcpServers": {
    "worldmonitor": {
      "url": "https://worldmonitor.app/mcp"
    }
  }
}

MCP 认证通过 X-WorldMonitor-Key 请求头或 OAuth。获取 API Key：https://worldmonitor.app/pro

⚠️ 注意：工具调用需要认证（免费/付费 Tiers），免费可能有限制速率。详见 https://worldmonitor.app/mcp

3. REST API

# 获取 OpenAPI 规范
curl https://worldmonitor.app/openapi.yaml -o openapi.yaml

# 基础请求（需 API Key）
curl -H "X-WorldMonitor-Key: wm_xxx" \
  https://api.worldmonitor.app/v1/...

API Base: https://api.worldmonitor.app，完整规范见 OpenAPI 文件。

4. Python SDK

pip install worldmonitor-sdk

from worldmonitor_sdk import WorldMonitor

wm = WorldMonitor(api_key="wm_xxx")

# 查询国家风险指数
result = wm.risk.get_cii(country="UA")
print(result)

# 获取新闻摘要
news = wm.news.summarize(category="geopolitics", hours=24)
print(news)

Python SDK 源码在 sdk/python/，零外部依赖。

5. 本地 AI（Ollama，无需 API Key）

在 .env.local 中配置 Ollama 端点后，AI 摘要和合成走本地模型，数据不外传：

# 安装 Ollama
curl -fsSL https://ollama.com/install.sh | sh
ollama pull llama3.2

# 在 worldmonitor .env.local 中添加
OLLAMA_BASE_URL=http://localhost:11434

典型适用场景

技术架构一览

Frontend:   Vanilla TypeScript + Vite + globe.gl(3D) + deck.gl(WebGL)
Desktop:    Tauri 2 (Rust) + Node.js sidecar
AI/ML:      Ollama / Groq / OpenRouter + Transformers.js(浏览器侧)
API:        Protocol Buffers (278 protos, 35 services)
Caching:    Redis (Upstash) + 3-tier cache + CDN + Service Worker
Deployment: Vercel Edge Functions (60+) + Railway relay + Tauri + PWA

架构复杂度较高，适合有全栈能力的团队或作为基础设施参考。

坑与注意

1. AGPL-3.0 许可：源代码是 AGPL-3.0-only——修改后必须开源；商业使用需遵守 AGPL 的源代码可获得性要求。如果需要私有化商业使用，需单独联系获取商业许可。

2. 部分数据源需 Key：核心新闻和基础地图无需凭证，但 CII 指数、财经数据、部分 AI 模型可能需要付费 API Key。具体见 .env.example。

3. Ollama 支持但需配置：本地 AI 是可选功能，不是默认开启。需要自行安装 Ollama 并在环境变量中配置端点。

4. MCP 服务器在 /mcp 路径：官方 MCP 端点路径是 /mcp（Streamable HTTP），注意别配错。

5. 6 个变体代码共用：如果你只需要某一个变体（如 finance），需要注意它依赖其他变体的数据源，单独部署可能有数据缺失。

6. Stars 61k 但周增 +280：绝对 Stars 仍然很高，但周增相对温和——说明项目已进入成熟期，不是有巨大增长动量的新项目。

7. 桌面应用是单一 Tauri 二进制：Windows/macOS/Linux 三个平台的桌面 App 是同一个二进制，通过 in-app 切换变体。当前 CI 发布目标为 full 和 tech 变体，其他变体可能不是默认发布的。

与同类对比

worldmonitor 最大的差异化是开源 + AI + MCP 三合一——大多数 OSINT 工具要么是纯数据收集，要么没有 MCP 支持，要么不开源。

一句话推荐结论

如果你需要一个开源的、可自托管的、且能被 AI Agent 直接调用的全球情报仪表板，worldmonitor 是目前生态最完整的选项——支持 MCP/REST/CLI 多端接入，Ollama 本地 AI 保护隐私，AGPL 许可也保证了透明度。

来源：GitHub README (https://github.com/koala73/worldmonitor)、文档站点 (worldmonitor.app/docs)、npm 页面 (worldmonitor)、PyPI (worldmonitor-sdk)