track-conflict-events

当用户询问近期武装冲突活动——战斗发生地点、参与方以及伤亡估计——时使用本技能。事件数据来源于 UCDP，带有地理位置信息，并支持分页。

身份认证

服务器到服务器的调用方（代理、脚本、SDK）必须通过 X-WorldMonitor-Key 请求头提供 API 密钥。Authorization: Bearer … 用于 MCP/OAuth 或 Clerk JWT——不应用于原始 API 密钥。

X-WorldMonitor-Key: wm_0123456789abcdef0123456789abcdef01234567

可在 https://www.worldmonitor.app/pro 申请密钥。

端点

GET https://worldmonitor.app/api/conflict/v1/list-ucdp-events

参数

名称	位置	是否必需	形式	说明
country	query	否	国家名称（例如 Sudan）	筛选至单一国家。
start / end	query	否	ISO 日期（2026-06-01）	日期范围边界。
page_size	query	否	整数	页面大小；响应中包含 pagination 游标。
cursor	query	否	不透明字符串	来自上一页的 pagination。
jmespath	query	否	JMESPath 表达式，≤ 1024 字符	服务端投影。

响应结构

{
  "events": [
    {
      "id": "…",
      "dateStart": "2026-06-28",
      "dateEnd": "2026-06-28",
      "location": "…",
      "country": "Sudan",
      "sideA": "…",
      "sideB": "…",
      "deathsBest": 12,
      "deathsLow": 8,
      "deathsHigh": 20,
      "violenceType": "state-based",
      "sourceOriginal": "…"
    }
  ],
  "pagination": { "nextCursor": "…" }
}

`deathsBest…