WB
发展指标World Bank Indicators API v2World 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 自己的引用要求来写。
用到 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 积分 / 次。
