官方 SDK

​

查找并验证官方软件包

• 在 pkg.go.dev 搜索 worldmonitor。
• 查看 Go 模块代理上的最新发布元数据。
• 在 Go 项目中运行 go get github.com/koala73/worldmonitor/sdk/go 安装。

​

共享设计

• 任意 MCP 工具——使用带命名参数的 call_tool / CallTool；返回结果是解包后的 JSON-RPC result。
• 精选辅助方法，覆盖流量最高的工具：世界简报、国家简报/风险、市场、冲突、网络、新闻、灾害、制裁、预测、海事。
• 公开列表——list_tools、list_prompts、list_resources 无需密钥。
• REST 备用通道——针对 api.worldmonitor.app 的 get("/api/…") 和 health()。
• 配置方式：通过构造函数参数，或 WORLDMONITOR_API_KEY（别名 WM_API_KEY）、WORLDMONITOR_BASE_URL 和 WORLDMONITOR_MCP_URL 环境变量。
• 错误分为两类：MCP 错误（JSON-RPC error 对象，认证失败会附带密钥提示）和 API 错误（非 2xx 传输）。
• 一个具描述性的 User-Agent（worldmonitor-<lang>/<version>）——API 边缘会拦截通用库代理，因此如果你 fork 了代码，请保留它。

​

Python

from worldmonitor_sdk import Client

client = Client(api_key="wm_...")  # or set WORLDMONITOR_API_KEY
client.list_tools()                # public — no key needed
client.country_risk("IR")
client.conflict_events(country="IR", limit=5)
client.call_tool("get_market_data", asset_class="crypto")

​

Ruby

require "worldmonitor"

client = WorldMonitor::Client.new(api_key: "wm_...")
client.list_tools
client.country_risk("IR")
client.call_tool("get_market_data", asset_class: "crypto")

​

Go

client := worldmonitor.New("wm_...") // "" reads WORLDMONITOR_API_KEY
tools, _ := client.ListTools(ctx)
risk, _ := client.CountryRisk(ctx, "IR", nil)
quotes, _ := client.CallTool(ctx, "get_market_data", worldmonitor.Args{"asset_class": "crypto"})

​

JavaScript

import { parseArgs, planRequest } from 'worldmonitor';
import run from 'worldmonitor/run';

​

获取密钥

​

发布（维护者）

• Python： 在 sdk/python/pyproject.toml 中提升 version，并在 sdk/python/src/worldmonitor_sdk/__init__.py 中提升 __version__，然后打上 py-vX.Y.Z 标签（工作流 publish-python.yml）。
• Ruby： 在 sdk/ruby/lib/worldmonitor/version.rb 中提升 WorldMonitor::VERSION，然后打上 gem-vX.Y.Z 标签（工作流 publish-ruby.yml）。
• Go： 在 sdk/go/worldmonitor.go 中提升 Version，然后打上 sdk/go/vX.Y.Z 标签（工作流 publish-go.yml 会验证并预热模块代理）。