Skip to main content
worldmonitor 是 World Monitor 全球情报 API 的官方命令行客户端。它是对 MCP 服务器(推荐的智能体接口)的一层轻薄、无依赖封装,并带有 REST 备用通道,因此你无需编写一行 HTTP 底层代码,即可从 shell 脚本或智能体拉取简报、风险评分以及冲突/网络/市场/新闻数据源。它以 ESM 形式发布,运行于 Node 18+ 源码位于主仓库的 cli/,并在每个 cli-v* 发布标签上发布到 npm。 维护者在发布新的 npm 版本时可遵循 CLI 发布手册。 相比 shell 更喜欢库?同一客户端也以官方 SDK 的形式提供 PythonRubyGo 版本。

安装

首次调用——无需密钥

tools 会列出每个 MCP 工具,且是公开的,因此它是确认 CLI 能够访问 API 的最快方式:
你会收到完整的工具定义,格式为 JSON。其他所有返回数据的操作都是 tools/call,需要用户 API 密钥。

身份验证

数据命令映射到 MCP tools/call。除 worldmonitor call get_sources 外,它们都需要订阅 API 密钥。在 worldmonitor.app/pro 获取一个,然后可以每次调用时传入,或一次性导出它:
密钥作为 X-WorldMonitor-Key 头发送。有关密钥、OAuth 和浏览器会话的区别,请参见身份验证;各套餐的额度请参见速率限制。如果你在调用需要订阅的数据命令时未提供密钥,CLI 会以 1 退出,并打印一条提示,准确告诉你应传入哪个标志。

数据命令

针对流量最高的工具的便捷快捷方式。位置参数(如 ISO 国家代码)以及任意 --key value 对都会直接作为工具参数传入:

任意工具,任意参数

精选表格刻意保持精简——每个已注册工具都可通过 call 访问,任何未识别的 --key value 都会成为工具参数,因此无需任何特殊接线:
当你需要有类型的(非字符串)参数时,使用 --args '<json>';否则 --key value 对会被作为字符串收集。
每个工具都接受一个通用的 jmespath 参数,它在响应通过网络传输之前于服务端进行投影——通常可缩小 80–95%。CLI 会像转发任何其他参数一样转发它:
12 个实例请参见 JMESPath 指南

REST 备用通道

适用于主机相对路径、自托管部署或 OpenAPI 目录:
health 映射到需要认证的平台健康端点,因此它需要 --api-keylist 读取公开的 OpenAPI 规范,无需密钥。

标志

退出码

可预测的退出码使得从 shell 管道和 CI 驱动该 CLI 是安全的。

编程式使用

相同的逻辑可以导入——便于嵌入 Node 脚本而无需启动子 shell:
run() 接受一个可注入的 IO 集合(fetchenvstdoutstderr),因此它完全可以离线测试,并返回数字退出码。

接下来去哪里

  • MCP 快速入门——连接 Claude Desktop 并通过 Model Context Protocol 进行你的首次工具调用。
  • MCP 工具参考——实时工具目录的逐工具参数、新鲜度预算和示例。
  • JMESPath 指南——用于将响应缩小 80–95% 的投影语法。
  • 身份验证——API 密钥 vs. OAuth vs. 浏览器会话。
  • API 参考——getlist 命令背后的完整 REST 服务目录。