经济指标

查询某个国家或地区汇总的世界银行年度发展指标（如 GDP），跨度最多 70 年，默认最近 10 年。

接口	POST /v1/economic-indicator-queries
所需权限	economic_indicator:query
MCP 工具	economic_indicator
计量单位	points

计量单位出现在 execution.usage.units 中，用于对账和计费。

请求字段

字段	类型	必填	说明
invocation_id	string	是	调用方（市场）生成的调用 ID：同一个 ID 在同一操作上只执行一次，用同一 ID 重试会被拒绝而不会重复计费。1–128 个字符，可用 A-Z a-z 0-9 . _ : -。
provider	string	是	处理本次请求的数据源，按下方数据源表的覆盖范围选择。 可选值：world-bank
country	string	是	ISO 3166-1 二位或三位国家代码，或世界银行汇总代码，例如 US、CHN、WLD。
indicator	string	是	世界银行指标代码，3–64 个字母、数字、点或下划线，例如 NY.GDP.MKTP.CD（GDP，现价美元）。
end_year	integer	否	可选，结束年份，不晚于今年，默认今年；跨度最多 70 年。
start_year	integer	否	可选，开始年份，不早于 1960，默认为结束年份往前 9 年。

数据源

数据源	区域	说明	限制
world-bank	US	世界银行开放数据	max_years: 70, timeout_seconds: 60

示例

curl

curl -sS https://services.zgi.im/v1/economic-indicator-queries \
  -H "Authorization: Bearer $ZGI_SERVICES_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"invocation_id": "docs-1791778521-economic_indicator", "provider": "world-bank", "country": "CN", "indicator": "NY.GDP.MKTP.CD", "start_year": 2021, "end_year": 2023}'

HTTP

POST /v1/economic-indicator-queries HTTP/1.1
Host: services.zgi.im
Authorization: Bearer <token>
Content-Type: application/json

{
  "invocation_id": "docs-1791778521-economic_indicator",
  "provider": "world-bank",
  "country": "CN",
  "indicator": "NY.GDP.MKTP.CD",
  "start_year": 2021,
  "end_year": 2023
}

MCP

通过 MCP 调用时，工具参数与 HTTP 请求体完全相同。

request.json

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "economic_indicator",
    "arguments": {
      "invocation_id": "docs-1791778521-economic_indicator",
      "provider": "world-bank",
      "country": "CN",
      "indicator": "NY.GDP.MKTP.CD",
      "start_year": 2021,
      "end_year": 2023
    }
  }
}

curl -sS https://services.zgi.im/v1/mcp \
  -H "Authorization: Bearer $ZGI_SERVICES_TOKEN" \
  -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
  -H 'MCP-Protocol-Version: 2025-11-25' \
  -d @request.json

返回

以下为一次真实调用的返回，列表只保留前两项，长文本已截断。

{
  "code": 0,
  "message": "success",
  "data": {
    "execution": {
      "id": "exe_01a12e52a3877609ae4068b210f2ee08",
      "invocation_id": "docs-1791778521-economic_indicator",
      "capability": "economic_indicator",
      "operation": "economic_indicator.query",
      "provider": "world-bank",
      "outcome": "succeeded",
      "error_category": null,
      "error_code": null,
      "usage": {
        "provider_requests": 1,
        "units": [
          {
            "name": "points",
            "value": 3,
            "source": "measured"
          }
        ]
      },
      "upstream_ref": null,
      "request_id": "req_0eec0b8365e4da96a817cf29",
      "started_at": "2026-10-12T04:15:30.183393545Z",
      "finished_at": "2026-10-12T04:15:30.735150514Z",
      "duration_ms": 551
    },
    "result": {
      "indicator": {
        "id": "NY.GDP.MKTP.CD",
        "name": "GDP (current US$)"
      },
      "country": {
        "id": "CN",
        "name": "China"
      },
      "values": [
        {
          "year": 2021,
          "value": 18201698719564
        },
        {
          "year": 2022,
          "value": 18316765021690.2
        }
      ],
      "last_updated": "2026-10-08",
      "source": {
        "name": "The World Bank: World Development Indicators",
        "license": "CC-BY-4.0",
        "url": "https://data.worldbank.org"
      }
    }
  }
}