ILO Labour Statistics (ILOSTAT): unemployment, wages, informality

ILO 労働統計（ILOSTAT）— MCP サーバー

🇧🇷 ポルトガル語で読む

公開済みでホスト型、出典情報を最優先する MCP サーバーです。 **国際労働機関（ILO）**の統計データベース、ILOSTATを提供します。 インストール不要、アカウント不要、API キー不要です。MCP クライアントをホスト済みのエンドポイントに接続して、国、年、性別、年齢別の失業、雇用、賃金、労働時間、その他の労働指標について質問できます。Cloudflare Workers 上で Streamable HTTP を使用して動作し、ILO 公式の ILOSTAT SDMX REST API と通信します。

独立したプロジェクトです。 ILO の公開 ILOSTAT API を利用する、非公式のコミュニティ開発クライアントであり、国際労働機関とは提携しておらず、同機関の推奨も受けていません。 データの著作権は引き続き © ILO に帰属し、CC BY 4.0 の下で提供されています。詳しくはデータのライセンスと帰属表示をご覧ください。

すべての応答には、出典情報のブロック（ソース URL、データの時点、実際の取得日時、ライセンス、ILO の引用）が含まれます。学習データから推測した数字ではなく、監査証跡を備えた正確な数値を提供します。

🇧🇷 ポルトガル語版。 ILO の労働市場統計（国、年、性別、年齢別の失業、雇用、賃金、労働時間、インフォーマル雇用）を利用できる、リモートのホスト型 MCP サーバーです（インストール不要、アカウント不要、キー不要）。Claude、ChatGPT、その他あらゆる MCP クライアントから直接利用でき、各応答に出典情報と引用が含まれます。 ポルトガル語版 README。

このサーバーで回答できる質問

わかりやすい言葉で質問すると、MCP クライアント内でアシスタントがツールとフィルターを選びます。

• 「ブラジルの失業率は2015年以降、どう推移していますか？」（ilo_get_data）
• 「ブラジル、メキシコ、南アフリカの若年失業率を比較してください。」（ilo_compare_countries）
• 「男女間の賃金格差はどのくらいで、ILO はどこで公開していますか？」 （ilo_search_indicators → ilo_get_data）
• 「インドでは、雇用のうちインフォーマル雇用はどのくらいの割合ですか？」（ilo_search_indicators → ilo_get_data）
• 「性別および経済活動別の平均月収がある ILOSTAT のデータフローはどれですか？」 （ilo_search_indicators）
• 「この指標を絞り込むために使える国、年齢、性別のコードはどれですか？」（ilo_list_dimension_values）
• 「ベトナムの労働市場の概要を教えてください。」（ilo_country_labour_profile）

ILO の言い回しではなく、ご自身の言葉で質問してください。 ILOSTAT の表記は英国式の統計用語で、カタログはデータフロー名を照合するため、一般的な言葉や米国式の言葉ではまったく結果が返らないことがありました。公式カタログの1,212件のデータフロー（2026-09-13）を対象に測定し、0.6.0 以降はこの問題を修正しています。検索時に用語を変換し、そのことをお知らせします。

質問に使う言葉	変換前のヒット数	ILOSTAT での表記	ヒット数
labor、labor force	0	labour、labour force	176、122
wages、salary	0	earnings	107
informality	0	informal	133
gender	2	sex	1,131
productivity	0	output per worker	4
jobless	0	unemployment	108

代替ツールとの比較

すでにILOSTATを利用している方には優れたツールがあり、このサーバーがそれらに取って代わることはありません — このサーバーは処理の別の段階で機能します。質問された時点で、つまりアシスタント内で、出典、データの時点、ライセンスを回答に添えて質問に答えます。詳細、比較例、計測値については docs/alternatives.mdをご覧ください。

ツール	概要	適している場面
ilo-mcp-server（本サーバー）	ホスト型のリモートMCPサーバーで、インストール不要です。約1,200のILOSTATデータフローに対応する6つのツールを提供し、回答ごとに来歴情報のブロックを添えます	アシスタント（Claude、ChatGPT、Cursor、Claude Code）で質問し、回答を監査可能にする必要がある場合
Rilostat 2.5.0（R、CRAN）	ILO独自のRパッケージで、ILOのスタッフが作成しています。一括ダウンロード、メタデータ、フィルタリング、データの再整形に対応します	Rを使っており、データフレームとしてデータセットを取得し、分析のために表全体を繰り返し扱いたい場合
sdmx1 2.27.0／pandaSDMX 1.10.0（Python）	汎用SDMXクライアントです。対応する約36のデータソースの1つにILOがあります	Pythonでパイプラインを構築していてSDMXオブジェクトを使いたい場合、または複数のSDMX機関に同じコードを使いたい場合
DBnomics（API、Python向けのdbnomics、R向けのrdbnomics 0.6.4）	1,071件のILOデータセットを他のプロバイダーのデータと並べて再公開するアグリゲーターで、すべてのデータを1つのAPIから利用できます	IMF、OECD、EurostatのデータとILOの系列を1つのインターフェースで利用したい場合
ILOSTAT SDMX REST API	このサーバーが呼び出すデータソースそのものです	独自のクライアントを構築し、すべてを制御したい場合
cyanheads/ilostat-mcp-server 0.1.2	別のILOSTAT MCPサーバーです。ホスト型またはローカルで利用でき、調査値とILOのモデル推計値を行ごとに示します。1回の呼び出しで最大300の地域に対応し、大きな結果はSQLでクエリできるデータフレームとして段階的に提供します	各行の報告値とモデル推計値を確認したい場合、または多くの国を対象に大量のデータを取得してSQLで扱いたい場合
Pipeworx mcp-ilostat 0.1.4	PipeworxゲートウェイのILOSTATパックです。SDMXキーは位置指定で、出典、ライセンス、値の状態を付けずに回答します	すでにPipeworxゲートウェイを使っており、他のデータソースと並べてILOSTATも利用したい場合

次の場合はこのサーバーを使わないでください。回答ではなくデータセット全体が必要な場合（Rilostatの一括ダウンロードが適しています）、質問がILOの公表する労働統計に関するものではない場合（教育 → UNESCO UIS、国民経済計算 → IMF／World Bank）、またはミクロデータが必要な場合です。ILOSTATが公表するのは集計値であり、このサーバーも同様です。

姉妹サーバー：同じ設計と同じ来歴情報ブロックを、他の公式データソース向けに提供しています。 IBGE（ブラジルの統計）、 BCB（ブラジル中央銀行）、 Senado（ブラジル上院のオープンデータ）、 SIH/SUS（ブラジルの入院データ）、 医療用語（ICD-11、ICD-10、LOINC、RxNorm、ATC、MeSH）。

利用方法（ホスト型 — セットアップ不要）

Streamable HTTPエンドポイントを任意のMCPクライアントに指定します。

https://ilo.sidneybissoli.com/mcp

Claude Desktop／Claude Codeなど、リモート接続をネイティブにサポートするクライアントの場合：

{
  "mcpServers": {
    "ilostat": {
      "url": "https://ilo.sidneybissoli.com/mcp"
    }
  }
}

コマンドとしてMCPサーバーを起動するクライアントでは、mcp-remoteブリッジを使用します。

{
  "mcpServers": {
    "ilostat": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://ilo.sidneybissoli.com/mcp"]
    }
  }
}

ilo-mcp-server.sidneybissoli.workers.devのホスト名も、セカンダリとして提供されています。

ChatGPT（Deep Research）

ChatGPT の Deep Research（および企業ナレッジ、Responses API を利用したリサーチワークフロー）では、search と fetch のみを公開する MCP サーバーを使用します。このサーバーは、ilo_* ツールに加えてこれらを提供します。ホストされたエンドポイントをコネクターに指定してください。キーは不要です。

https://ilo.sidneybissoli.com/mcp

search はクエリを ILOSTAT のデータフローカタログ全体（雇用、失業、賃金、労働時間、インフォーマル経済、SDG の労働指標など、約 1,200 件の SDMX データフロー）と照合して順位付けし、{ id, title, url }（ind:<DATAFLOW_ID>、例：ind:DF_UNE_2EAP_SEX_AGE_RT）を返します。fetch はデータフローを読みやすい Markdown として返します。内容は、名称、データのビンテージ、ディメンションとコードリスト、ILO のデフォルト選択、および ilo_get_data を使ったクエリ方法です。url には公開されている ILOSTAT データエクスプローラーページが設定され、ChatGPT はこの URL を引用します。どちらも、他のすべてのツールと同じ出典情報ブロックを structuredContent と _meta に含みます（テキストチャネルの形式は契約上 JSON です）。ChatGPT の開発者モード（Settings → Security and login → Developer mode）では、どのツールも呼び出せます。データには引き続き ilo_* ツールを使用してください。

ローカルで実行する（stdio）

クエリをサードパーティのホスト経由で送信したくない場合は、同じサーバーを、 公式 ILOSTAT API と直接通信するローカル stdio プロセスとして実行することもできます。6 つのツール、リソース、プロンプト、制限、出典情報ブロックは同じで、Cloudflare を経由しません。

インストールは不要です。パッケージは npm にあります（ilo-mcp-server、Node ≥ 20）。

{
  "mcpServers": {
    "ilostat": {
      "command": "npx",
      "args": ["-y", "ilo-mcp-server"]
    }
  }
}

ソースから実行する場合：

git clone https://github.com/SidneyBissoli/ilo-mcp-server
cd ilo-mcp-server
npm install
npm run build
node dist/cli.js   # serves MCP over stdio (Ctrl+C to stop)

（その後、クライアントで node /path/to/ilo-mcp-server/dist/cli.js を指定します）。

ホスト型サーバーとの違いは、すべて Cloudflare バインディングがないことによるものです。SDMX キャッシュはプロセスメモリ内に保持されます（構造とコードリストは同じセッション内では再利用されますが、セッション間では再利用されません）。検索カタログは最初の検索時に公式エンドポイントからダウンロードされます（実際の retrieved_at が出典情報に記録されます）。使用状況メトリクス、レート制限、認証はありません。ログは stderr に出力され、stdout には JSON-RPC ストリームのみが出力されます。リポジトリの Dockerfile はこのランタイムをビルドします（Glama レジストリで使用）。

ツール

ツール	機能	ソース
ilo_search_indicators	約 1,210 件のデータフローをキーワード検索します（offset でページネーション）	ローカルカタログ（上流への呼び出しなし）
ilo_get_indicator_metadata	データフローのディメンション、コードリスト、ビンテージ、デフォルト選択を取得します	キャッシュ済みの構造（キャッシュミス時は上流へ）
ilo_list_dimension_values	1 つのディメンションの有効なコードを取得します（offset でページネーション）	キャッシュ済みのコードリスト（キャッシュミス時は上流へ）
ilo_get_data	ディメンションと期間で絞り込んだ観測値を取得します	クエリごとに REST を 1 回呼び出し
search	ChatGPT Deep Research の契約：クエリをデータフローカタログ全体と照合して順位付けし、{ id, title, url }（ind:<DATAFLOW_ID>）を返します	ローカルカタログから構築されたメモリ内インデックス（24 時間）
fetch	ChatGPT Deep Research の契約：1 つのデータフローを読みやすい Markdown として、公開データエクスプローラーページを url に設定して返します	キャッシュ済みの構造（キャッシュミス時は上流へ）

一般的な流れ：ilo_search_indicators → ilo_get_indicator_metadata／ilo_list_dimension_values で有効なフィルターコードを確認 → 国と期間のフィルターを指定して ilo_get_data を実行します。

すべてのレスポンスには、ポートフォリオの出典情報ブロック （@sbissoli/mcp-provenance、provenance_mode パラメーターで concise／detailed を指定）を、3 つのチャネルに含みます。 structuredContent、名前空間付き _meta（com.sidneybissoli.ilostat/*）、テキストのフッターです。 1.1.0 以降、このブロックには、呼び出しの発生元を示す診断情報である retrieval が含まれます。具体的には、ILOSTAT へのリクエスト数、試行回数、克服した異常、および回答が unstable かどうかです。これはポートフォリオ共通の fetch （@sbissoli/mcp-upstream）によって計測されます。回答が ILOSTAT にアクセスしていない場合（カタログまたはキャッシュ済みの構造）は null です。

リソースとプロンプト

クライアントがツールを呼び出す前にコンテキストへ添付できる3つのリソース（静的なtext/markdown形式で、上流への呼び出しはありません）。これにより、多くのセッションで発生する「どのデータフローか、どのコードか」を確認するための2～3回の呼び出しを省けます。

URI	内容
ilostat://guide	ツールのワークフロー、安定したコードの規則（REF_AREAはISO3＋X集計値、SEX、AGE、FREQ、データフローIDの接尾辞）、制限、報告ルール
ilostat://reference/key-dataflows	トピック別に検証済みのデータフローID（失業、雇用、労働参加、賃金、労働時間、インフォーマル就業、NEET、SDG 8、生産性）
ilostat://reference/provenance	すべてのプロベナンスフィールドの意味と、ILOの引用方法

3つのプロンプトでは、ツールを連鎖させ、最後に引用ルールを確認する既成のワークフローを利用できます（引数は文字列で、期間の引数は省略可能です）。

プロンプト	引数	結果
ilo_country_labour_profile	country、start_period、end_period	1か国の労働市場プロファイル（失業、労働参加、雇用比率、インフォーマル就業、NEET、所得、労働時間）
ilo_compare_countries	countries、indicator、start_period、end_period	1回のデータ呼び出しで、各国・集計値の比較表を作成し、モデル推計値と報告データを区別します
ilo_indicator_trend	indicator、country、start_period、end_period	1つの指標の時系列。最初と最後の値、ピークとボトム、OBS_STATUSの変化点を示します

リソースとプロンプトに記載されているすべてのデータフローIDは、テストスイートによってカタログのシードデータと照合されます。そのため、検索で見つからないIDがドキュメントに記載されることはありません。

動作と制限

• ilo_get_dataではREF_AREAが必須で、1回の呼び出しにつき最大30地域です。 ILOゲートウェイは無制限のクエリでタイムアウト（HTTP 504）するため、サーバーがそのようなクエリを発行することはありません。広範なパネルを取得する場合は、地域を複数のバッチに分けるか、期間（start_period／end_period）でページ分割してください。エラーメッセージに方法が説明されています。
• データクエリごとに、実際のREST呼び出しは1回です。 データはキャッシュされません。ilo_get_dataの結果は毎回、リクエスト時にILOSTATから取得されます。データフローの構造（TTL 24時間）とコードリスト（TTL 7日間、データフロー間で共有）はキャッシュされます。
• **data_vintage**は、ILOが公開するデータフローの最終更新日（LAST_UPDATEアノテーションをISO形式に正規化したもの）です。
• retrieved_atは、ILOSTATから実際にデータを抽出した時刻を常に示します。 キャッシュされた値にもその時刻が保持され、ビルド時刻や応答時刻が使われることはありません。キャッシュされた応答では、その旨が示されます（served_from_cache: true）。
• 指標カタログはローカルのスナップショット（約1,210のデータフロー）で、定期的に更新されます。カタログ自体のretrieved_atはilo_search_indicatorsのプロベナンスに記録されるため、データの経過時間を常に確認できます。
• 上流への呼び出しには、識別可能なUser-Agent（サービスURL＋連絡先）が付与されるため、ILOの管理者は運用者に連絡できます。
• 上流へのすべての呼び出しには、タイムアウトと再試行ポリシーが設定されています（1.1.0以降、稼働中のAPIで測定）：1回の試行につき65秒です。これは、ILOゲートウェイ自体が無制限のクエリを504で拒否するまでにかかる約61秒より長いため、正当な広範クエリがこのサーバーによって途中で打ち切られることはありません。5xx、429（Retry-Afterに従います）、およびネットワークエラーの場合、最大3回まで再試行し、1回の呼び出しの合計時間は70秒です。タイムアウト、HTTP 504（クエリの範囲が広すぎる場合）、HTTP 404（観測値がない場合）は再試行されません。何が起きたかは、プロベナンスのretrievalフィールドに記録されます。
• 言語：英語、タイムゾーン：UTC（ILOのデータは英語で公開されます）。

出所フィールド

• derived — 実際の変換（集計、サーバーで計算されたレート、補間、調和化）を行った場合に限りtrueとなり、必ずderivation_noteを伴います。単位変換と丸めは該当しません。このサーバーは値を変換しないため、derivedは常にfalseです（簡潔なブロックには含まれません）。
• notices（ilo_get_data）— 行に含まれるOBS_STATUS（SDMXのステータス／免責事項チャンネル。例：「系列の断絶」）、UNIT_MEASURE、UNIT_MULT（例：「Thousands」：単位とスケールは数値の一部です）のそれぞれ異なる値と、その値を持つ観測値の数です。テキストのフッターにも繰り返し記載されます。特記事項がない場合は省略されます。観測値ごとの技術属性（DECIMALSなど）は行（rows[].attributes）に保持されます。
• revision（契約1.3、サーバー1.6.4以降）— 常にcurrentです。ILOSTATが提供するのは現行リリースのみで、後日改訂される場合があります。データの回答には、ILOがリリースごとにモデル化された系列（_2 ID）を過去の年も含めて再推定する旨の注記が含まれます。

レジストリから確認できるサーフェスフィンガープリント

各リリースでは、MCP Registryのエントリーで、このバージョンが提供するサーフェス（initialize、ツール、リソース、プロンプト）のsha256と、認証情報なしで応答するメソッドを公開します。バージョンを上げずにサーフェスを変更するとビルドに失敗します。レジストリのフィンガープリントを使えば、クライアント側でも同じ内容を確認できます。正規形式と手順については、@sbissoli/mcp-surfaceのSPEC.mdを参照してください。自分で確認する場合（Node 18+、依存関係なし）：

curl -sO https://raw.githubusercontent.com/SidneyBissoli/mcp-br-commons/main/packages/mcp-surface/exemplos/verify.mjs
node verify.mjs io.github.SidneyBissoli/ilo-mcp-server

データライセンスと帰属表示

• ILOSTATのデータとメタデータ：CC BY 4.0（2023-05-03以降。ライセンス確認日：2026-08-04）。
• すべての回答におけるILOの帰属表示（citationフィールド）： International Labour Organization, ILOSTAT, https://ilostat.ilo.org/data/, accessed <date>.
• ILOのロゴは使用していません。このサービスはILOの推奨を受けていません。

セルフホスト／開発

以下はすべて、ご自身のインスタンスを実行する場合にのみ必要です。公開サーバーの利用には必要ありません。

npm install
npm run typecheck && npm test   # offline suite (parsers, key, tools, output contract, resources/prompts, in-memory catalogue, vocabulary, eval fixtures)
npm run dev                     # http://localhost:8787/mcp (Worker)
npm run build && npm start      # stdio runtime (dist/cli.js)

# Catalogue seed (D1) — required before first use:
node scripts/seed-catalog.mjs   # downloads via curl and generates scripts/seed-catalog.sql
npx wrangler d1 execute ilostat-catalog --local  --file=scripts/seed-catalog.sql
npx wrangler d1 execute ilostat-catalog --remote --file=scripts/seed-catalog.sql

npm run deploy
node scripts/smoke-mcp.mjs      # smoke test against production (initialize → 6 tools → search → fetch → errors)
npm run manifest:lhm            # regenerate tools/resources/prompts in lhm.plugin.json from the real server
# (the seed also writes tests/fixtures/catalog-ids.txt — the versioned id list the tests check resources/prompts against)

バインディング（wrangler.jsoncを参照）：KV SDMX_CACHE、D1 CATALOG_DB、Durable Object USAGE（SQLiteベースの利用カウンター）、CF_VERSION_METADATA。任意のBearer認証（wrangler secret put API_KEY）。IPごとのトークンバケット方式のレート制限。

運用担当者向けの注意事項：

• ILOSTATがJSONを返すのは、Acceptヘッダー（application/vnd.sdmx.{structure,data}+json）で指定した場合のみです。?format=は無視され、XMLが返されます。
• ILOゲートウェイは、Nodeのfetch（undici）がデフォルトで送信するAccept-Language: *ヘッダーに対し、HTTP 500（languageTag1）を返します。そのため、すべての上流呼び出しでAccept-Language: enを明示的に設定しています（Cloudflareのランタイムはこのヘッダーを送信しないため、Workerには影響がありませんでした）。また、識別可能なUser-Agentも必要です。
• カタログの更新は手動で行います（cronはありません）。四半期ごと、または上流に存在するデータフローが検索結果に表示されない場合は、直ちに更新してください。手順は上記の3つのシードコマンドです。データクエリは常にライブで実行されるため、古くなる可能性があるのは検索カタログのみで、その経過時間は出所情報に示されます。

評価

@sbissoli/mcp-evals：evals/fixtures/queries.tsに24件のフィクスチャがあり、npm testでオフライン検証されます。実際のモデルを使った実行（npm run eval）にはAnthropic APIを使用し、ANTHROPIC_API_KEYが必要です（設定されていない場合は、手順を表示して終了します）。2026-08-07の実行結果：トップ1正解率100%（24/24） — evals/results/。

エンドツーエンド：検証可能な答えが1つある複雑な質問10件をevals/e2e/evaluation.xmlに収録し、回答は本番環境と照合して手動で検証しています（evals/e2e/validacao-respostas.md）。2026-08-07の実行結果（Sonnet）：文字列の完全一致9/10、内容の正確性10/10 — evals/results/2026-08-07-e2e.md。

エンドポイント

ルート	用途
/	ランディングページ（サービスの概要と連絡先 — 公開）
/health	稼働状況
/status	バージョン、ツール／リソース／プロンプトの件数と名称、来歴契約のバージョン、現在のデプロイ（README バッジに反映）
/metrics	使用状況の集計（MCP エンドポイントのみ。IP アドレスやクエリ内容は含まれません）
/.well-known/mcp/server-card.json	ディレクトリスキャナー向けの MCP サーバーカード（実行中のサーバーから取得した serverInfo、ツール、リソース、プロンプト）
/mcp	MCP Streamable HTTP

セキュリティ

Snyk Agent Scan（2026-08-07）：合格 — レポートは security/にあります。

ライセンス

コード：MIT。データ：ILOSTAT、CC BY 4.0（上記の「データライセンスと帰属表示」を参照）。

プライバシー

ホスト型サービスのプライバシーポリシー：PRIVACY.md。

お問い合わせ

Sidney da Silva Pereira Bissoli — [email protected]。このサービスは ILO の推奨を受けていません。