Community研究&データ分析github.com

World Bank Indicators API(世界銀行指標API)

AIエージェントに、無料のWorld Bank API(APIキー不要)を使ってGDP、人口、インフレ率など約3万の開発指標を取得する方法を教えるスキルです。

World Bank Indicators API(世界銀行指標API) とは?

このスキルは、AIエージェント(Claude Code、Cursor、Codexなど)がWorld Bank Indicators APIを介して約3万の時系列開発指標にアクセスできるようにします。APIキーやサインアップは不要で、レート制限も文書化されていません。217の経済圏と78の地域・所得グループをカバーし、一部のデータは1960年まで遡ります。主な機能には、バンドルされたPythonスクリプト(wb_data.py)による迅速なデータ取得、ISOコードまたは集計コードによる国指定、日付範囲、mrv(最新N件)などのフィルタリングパラメータが含まれます。このスキルは、推奨されるエンドポイント、エラーハンドリング、実用的なヒント(mrnevを使用して最新の非NULL値を取得するなど)に関する詳細なドキュメントを提供します。100以上の検証済み指標コードが表にまとめられており、完全なエンドポイントカタログと追加の指標コードはreferences/ディレクトリにあります。このスキルは、開発データをレポート、ダッシュボード、または分析に統合する必要があるAIエージェントに最適です。

対応~Claude Code~Codex CLI~Cursor
npx skills add NanookAI/worldbank-api

Installed? Explore more 研究&データ分析 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

World Bank Indicators API(世界銀行指標API) は何をしますか?

World Bank Indicators APIは、217の経済圏と78の地域・所得グループに関する約3万の時系列指標を公開しています。一部の系列は1960年まで遡ります。 APIキー不要、サインアップ不要、文書化されたレート制限なし — 単純なHTTPS GETリクエストです。

ベースURL: https://api.worldbank.org/v2

常にformat=jsonを付加してください — デフォルトのレスポンス形式はXMLです。

最速の方法:バンドルスクリプト

一般的なケース(1つ以上の国に対する1つ以上の指標)では、バンドルされた依存関係のないスクリプト(Python 3.8+、標準ライブラリのみ)を実行します:

python3 scripts/wb_data.py gdp US,JP,CN                    # エイリアス + ISOコード、最新5年
python3 scripts/wb_data.py SP.POP.TOTL BR --date 2000:2024 # 明示的な指標コード + 範囲
python3 scripts/wb_data.py inflation all --mrv 1           # すべての経済圏、最新値
python3 scripts/wb_data.py population WLD,EUU --json       # 集計、生JSON出力
python3 scripts/wb_data.py --search "renewable energy"     # キーワードで指標コードを検索
python3 scripts/wb_data.py --aliases                       # 組み込み指標エイリアスを一覧表示

終了コード: 0 成功、1 見つからない/データなし、2 APIまたはネットワークエラー。

それ以外(国メタデータ、トピック/ソース別の指標検索、月次/四半期系列、Python以外の環境)については、以下のAPIを直接呼び出してください。

コアデータクエリ

GET https://api.worldbank.org/v2/country/{codes}/indicator/{indicator}?format=json
  • {codes} — ISO-2またはISO-3の国コード、セミコロン区切り(US;JP;CN)、集計コード(WLD、EUU、HIC...)、またはall(265すべての経済圏+集計)。
  • {indicator} — NY.GDP.MKTP.CDのような指標コード(大文字小文字は区別されません)。

例

GET https://api.worldbank.org/v2/country/US;JP/indicator/NY.GDP.MKTP.CD?format=json&mrv=2
[
  {"page": 1, "pages": 1, "per_page": 50, "total": 4,
   "sourceid": "2", "lastupdated": "2026-07-01"},
  [
    {"indicator": {"id": "NY.GDP.MKTP.CD", "value": "GDP (current US$)"},
     "country": {"id": "US", "value": "United States"},
     "countryiso3code": "USA", "date": "2025",
     "value": 30769700000000, "unit": "", "obs_status": "", "decimal": 0},
    {"...": "国×年ごとに1オブジェクト、新しい順"}
  ]
]

レスポンスの構造: 2要素のJSON配列 — [0]はページネーションメタデータ、[1]はデータ配列(該当なしの場合はnull)。valueは、国が報告していない年に対してnullになります。行は国ごとに新しい順にソートされます。

時間とページネーションパラメータ

パラメータ意味
date=2020 / date=2000:2024単一年または範囲。月次は2025M01:2025M06、四半期は2024Q1:2025Q4(限られた月次/四半期ソースの場合)。
mrv=N国ごとの最新N値(dateを上書き)
mrnev=N国ごとの最新N 非NULL 値 — 多くの系列が1〜2年遅れるため、「最新の利用可能な値」に使用
gapfill=Ymrvと併用:欠落年を最後の既知の値で前方補完
per_page=N(デフォルト50)1ページあたりの行数;大きな値(例:20000)でも正常に動作 — ページネーションを避けるために高く設定
page=Nページ番号;メタデータのpage < pagesの間ループ
footnote=y各データポイントにfootnoteフィールドを追加

1回の呼び出しで複数の指標を取得するには、明示的なソースが必要です: /country/BR/indicator/NY.GDP.MKTP.CD;SP.POP.TOTL?source=2&format=json (ソース2 = World Development Indicators、最も一般的な系列をホスト)。

最もよく使われる指標コード(すべてライブで検証済み)

コード指標
NY.GDP.MKTP.CDGDP(現在の米ドル)
NY.GDP.MKTP.KD.ZGGDP成長率(年率 %)
NY.GDP.PCAP.CD1人当たりGDP(現在の米ドル)
NY.GNP.PCAP.CD1人当たりGNI(アトラス方式、現在の米ドル)
SP.POP.TOTL総人口
FP.CPI.TOTL.ZGインフレ率、消費者物価(年率 %)
SL.UEM.TOTL.ZS失業率(労働力人口の%、ILO)
SP.DYN.LE00.IN出生時の平均余命(年)
SI.POV.GINIジニ係数
SI.POV.DDAY1日3.00ドル未満の貧困率(人口の%)
EN.GHG.CO2.PC.CE.AR51人当たりCO2排出量(t CO2e)
IT.NET.USER.ZSインターネット利用者(人口の%)
NE.EXP.GNFS.ZS財・サービスの輸出(GDPの%)
BX.KLT.DINV.WD.GD.ZSFDI純流入(GDPの%)
PA.NUS.FCRF公式為替レート(1米ドルあたりの現地通貨)
SP.URB.TOTL.IN.ZS都市人口(総人口の%)

トピック別にグループ化されたさらに100以上の検証済みコードはreferences/indicators.mdにあります — 必要な系列がこの表にない場合は、それを読んでください。キーワードで検索するには、スクリプトの--searchまたはreferences/endpoints.mdの検索エンドポイントを使用してください(APIにはサーバー側のテキスト検索はありません)。

国コードと集計

国: ISO-2(US)またはISO-3(USA)の両方が機能します。知っておくべき集計: WLD 世界、EUU 欧州連合、EMU ユーロ圏、HIC/UMC/LMC/LIC 所得グループ、EAS 東アジア・太平洋、ECS ヨーロッパ・中央アジア、LCN ラテンアメリカ・カリブ海、MEA 中東・北アフリカ、SAS 南アジア、SSF サハラ以南アフリカ、NAC 北アメリカ。

country/allは経済圏と集計が混在して返されます(年間265行)。実際の国だけを保持するには、/v2/country?format=json&per_page=400を1回取得し、region.value == "Aggregates"のエントリを削除します。

国のメタデータ(地域、所得レベル、首都、座標):

GET https://api.worldbank.org/v2/country/JPN?format=json
GET https://api.worldbank.org/v2/country?incomeLevel=LIC&format=json&per_page=100

コード例

import requests

def wb_series(indicator: str, countries: str = "all", **params) -> list[dict]:
    """World Bankの系列を取得;フラットなデータポイントのリストを返す。"""
    url = f"https://api.worldbank.org/v2/country/{countries}/indicator/{indicator}"
    r = requests.get(url, params={"format": "json", "per_page": 20000, **params}, timeout=30)
    r.raise_for_status()
    body = r.json()
    if "message" in body[0]:          # APIエラーはHTTP 200として返される
        raise ValueError(body[0]["message"][0]["value"])
    return body[1] or []

gdp = wb_series("NY.GDP.MKTP.CD", "US;JP;CN", date="2015:2024")
latest = wb_series("SP.DYN.LE00.IN", "all", mrnev=1)
const url = "https://api.worldbank.org/v2/country/US;JP/indicator/NY.GDP.MKTP.CD"
          + "?format=json&mrv=5&per_page=1000";
const [meta, rows] = await (await fetch(url)).json();
if (meta.message) throw new Error(meta.message[0].value);
for (const r of rows ?? []) console.log(r.country.value, r.date, r.value);

エラー

エラーはHTTP 200としてメッセージエンベロープとともに返されます — 常にチェックしてください:

[{"message": [{"id": "120", "key": "Invalid value",
               "value": "The provided parameter value is not valid"}]}]
  • 120 — 無効な国または指標コード(World Bankがカバーしていない経済圏、例えば台湾にはどのコードでもデータがない場合にも返されます)。
  • 175 — 指標は存在するが、そのデータは削除またはアーカイブされています(例:古いCO2系列EN.ATM.CO2E.PC → EN.GHG.*の代替を使用;Doing Businessソース全体がアーカイブされています)。後継コードを検索してください。
  • 時折、JSONの代わりに一時的なHTMLの「Request Error」ページが返される場合があります — 失敗とみなす前に1回再試行してください。

実用的なヒント

  • 「最新の数値」にはmrv=1よりもmrnev=1を優先してください — ほとんどの系列は1〜2年遅れるため、mrv=1はvalue: nullの最新年を返すことがよくあります。
  • per_pageを高く設定し(例:20000)、ページネーションはほとんど不要になります。all国×1年はわずか265行です。
  • メタデータのtotalは、null値を含む国×期間のスロットをカウントします。
  • ローカライズされた名前:/v2の後に言語コードを挿入 — /v2/zh/country/CN/indicator/...(対応言語:en、es、fr、ar、zh)。ラベルのみが翻訳され、コードと値は同一です。
  • データの改訂はほぼ毎月行われます。メタデータのlastupdatedがソースの更新日を示します。
  • 年次が標準です。月次/四半期はごく一部のソース(Global Economic Monitor source=15、四半期債務 source=20/22/23)にのみ存在します — references/endpoints.mdを参照してください。

完全なエンドポイントカタログ(指標リスト、トピック、ソース、地域、所得レベル、貸付タイプ、言語、月次/四半期データ)についてはreferences/endpoints.mdを読み、トピック別のさらに100以上の検証済み指標コードについてはreferences/indicators.mdをお読みください。

関連スキル