免费了解积分 →
WB
发展指标World Bank Indicators API v2

World Bank

世界银行发布的世界发展指标(World Development Indicators)是一套按年统计的跨国数据,涉及经济、人口、健康、教育和环境。通过 ScholarMuse,agent 可以用 find_series 按名称搜索这些指标,再用 get_series 取回某个国家、地区或收入分组的一项指标。

对应的 ScholarMuse 工具:find_series、get_series。每次成功调用都会扣积分。

可以这样问你的 agent

2000 年以来中国每年的人均 GDP(现价美元)是多少?
取尼日利亚和全球的出生时预期寿命,比较最近一年的数值。
找世界银行里关于互联网使用的指标,并取巴西的数据。

你的 agent 会拿到什么

每条记录都带有 id、source、title、url、license、attribution 和 retrievedAt。下面是来自 World Bank 的数据字段。

find_series

匹配依据是指标名称。查询里写了国家时,seriesId 会自带 ?country=ISO3。

seriesId
如 world-bank:NY.GDP.PCAP.CD?country=CHN
title
指标名称
frequency
该来源固定为 Annual
units
从指标名称里读出的单位
geography
查询中提到的国家(如有)
description
世界银行的指标说明,前 400 个字符
originalSource
世界银行取数的原始机构

get_series

seriesId
带有已解析国家代码的指标编号
title
指标名称
units
从指标名称里读出的单位
frequency
年度
geography
世界银行给出的国家或汇总区域名称
lastUpdated
世界银行最近更新数据的日期
start
返回的首个年份
end
返回的最后年份
count
返回的观测值个数
observations
年份与数值组成的列表

覆盖范围

  • 搜索范围只限世界发展指标数据库(World Bank API 中的 source 2)。
  • 地理范围是单个国家,或世界银行的汇总区域,如全球、欧元区、欧盟或某个收入分组,用 ISO 代码或名称指定。
  • 序列为年度数据。编号形如 NY.GDP.PCAP.CD(人均 GDP)、SP.POP.TOTL(人口)、SP.DYN.LE00.IN(预期寿命)。

限制

  • 每次调用只取一项指标、一个国家或汇总区域。不指定国家时返回全球汇总值。
  • 搜索只匹配英文指标名称,不匹配说明文字,并且只保留包含至少一半查询词的指标。
  • find_series 每次最多返回 8 条 World Bank 候选,没有数值的年份不会出现在结果里。

ScholarMuse 怎么访问 World Bank

连接器直接调用 World Bank Indicators API v2,不发送任何 key。该 API 没有文本搜索,所以 ScholarMuse 会下载世界发展指标的清单,用你的查询去匹配指标名称;数值来自 /country/{code}/indicator/{id}。

数值最多缓存 1 天,指标清单缓存 7 天,国家清单缓存 30 天,世界银行的新发布可能要这么久才会出现。

API key:上游 API 不用 key 也能调用,你不用申请。

许可与署名

许可:CC-BY-4.0

Data from the World Bank, World Development Indicators (data.worldbank.org), CC BY 4.0.

来自 World Bank 的记录都带这段许可和署名。 在论文里引用时,请按 World Bank 自己的引用要求来写。

常见问题

ScholarMuse 不是 World Bank 的官方产品。它是一个面向学术数据的 MCP server,其中的 find_series、get_series 工具会查询 World Bank。agent 连上 ScholarMuse 后就能用 World Bank,不用再单独装一个 server。

不需要。World Bank 的 API 不用 key 也能调用,ScholarMuse 也不会向你要 key。登录一次 ScholarMuse,agent 就能调用工具。

连接器直接调用 World Bank Indicators API v2,不发送任何 key。该 API 没有文本搜索,所以 ScholarMuse 会下载世界发展指标的清单,用你的查询去匹配指标名称;数值来自 /country/{code}/indicator/{id}。数值最多缓存 1 天,指标清单缓存 7 天,国家清单缓存 30 天,世界银行的新发布可能要这么久才会出现。

许可:CC-BY-4.0。署名:Data from the World Bank, World Development Indicators (data.worldbank.org), CC BY 4.0. 来自 World Bank 的记录都带这段许可和署名。

需要。每次成功调用 find_series、get_series 都会扣积分,调用失败不扣。当前价格:经济与社会统计,1 积分 / 次。