Reliefweb

@pipeworx/reliefweb

UN OCHAの人道情報サービスです。約4,000の人道支援組織による状況報告、ニーズ評価、支援要請、分析に加え、GLIDE番号付きの厳選された災害登録情報を提供します。

Pipeworx の一部です。AI エージェントを1683以上の稼働中データソースに接続するMCPゲートウェイです。

ツール

• reliefweb_reports(query?, country?, disaster_type?, source?, theme?, format?, from_date?, to_date?, include_body?, limit?, offset?)
• reliefweb_disasters(query?, country?, status?, disaster_type?, include_description?, limit?, offset?)
• reliefweb_report(report_id, max_body_chars?) — レポートを1件、全文で取得します。

認証

BYOのみで、認証情報はキー形式ではありません。

APIは無料で、料金はかかりません。2025年11月1日以降、すべての呼び出しに、事前承認済みのappnameクエリパラメーターが必要です。任意の文字列を指定すると、403 AccessDeniedHttpExceptionで拒否されます。2026-09-17にライブで確認済みです。v2ではappname=pipeworx、appname=reliefweb、appname=testはいずれも403を返し、v1はさらに410（廃止済み）を返します。

https://apidoc.reliefweb.int/parameters#appnameから申請してください。ReliefWebが申請内容を審査し、承認された文字列をメールで通知します。この文字列には、組織名、利用目的、ランダムな文字列を組み合わせる必要があります。_apiKeyとして渡してください。

Pipeworxは承認済みのappnameを保持していません。取得した場合はPLATFORM_RELIEFWEB_APPNAMEになります。値が反映されるのと同じ変更で、パックのマニフェストにplatformKeyEnvを追加してください。先に宣言すると、人道支援に関する質問が、拒否しかできないツールに送られてしまいます。

ReliefWebはappnameごとにレート制限を行うため、共有appnameは共有の制限枠になります。

データソース

• POST https://api.reliefweb.int/v2/reports?appname=…
• POST https://api.reliefweb.int/v2/disasters?appname=…
• フィールド一覧：https://apidoc.reliefweb.int/fields-tables

知っておくとよいこと：

• v1は廃止されています。 v2を使用するよう案内する410が返されます。api.reliefweb.int/v1を使用するよう書かれたものは、すべて利用できません。
• 公開サイトのRSSフィードは代替手段になりません。サーバーからの外向き通信では、ブラウザーのUAを使ってもreliefweb.int/updates/rss.xmlは本文が0バイトの202を返します。
• フィルターには、単一の{field, value}または{operator, conditions[]}グループを指定します。フィルターの配列をそのまま渡すと拒否されます。
• 日付フィルターは、公開日を表すdate.originalに、日付のみではなく完全なISOタイムスタンプを使った{from, to}として指定します。
• 分類フィールド（source、country、theme、format、disaster_type）はオブジェクトの配列で返されます。パックはこれらを名前にフラット化します。
• レポート本文は長文です。reliefweb_reportsは、要求しない限り本文を省略します。全文を返すのはreliefweb_reportです。

検証済み

2026-09-17 — 設計上、拒否される経路のみを確認しています。キーなしの場合の拒否と、未承認appnameに対する上流の403の両方をライブで試し、どちらも「APIキーが必要」と返すことを確認しました。appnameが承認されるまでは、クエリの経路を検証できません。

クイックスタート

MCPクライアント（Claude Desktop、Cursor、Windsurfなど）に追加します：

{
  "mcpServers": {
    "reliefweb": {
      "url": "https://gateway.pipeworx.io/reliefweb/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/reliefweb/mcp の tools/list は、上記の表にあるツールに加えて、Pipeworx 共通のメタツールである ask_pipeworx、 discover_tools、search_within、remember／recall など、ゲートウェイ全体で利用できるツールも返します。そのため、表示されるツール数はこの表より多くなります。単一パックのエンドポイントには現在、そのパック固有のツールに加えて、共通ツールが約 30 個表示されます。接続の initialize 応答に正確な範囲が記載されており、その日の状況を確認する際の正式な情報源となります。

これは意図的な設計であり、偶然複数の接続を束ねているわけではありません。メタツールを使うと、このパックが扱わない質問にも、カタログ全体を対象にルーティングする ask_pipeworx を通じて回答できます。MCP サーバーをもう 1 つ追加する必要はありません。現在、メタツールなしでパックのエンドポイントに接続する方法はありません。追加のスキーマによるコンテキスト消費がルーティングの利便性を上回る場合は、複数のパックのエンドポイントではなく、フルゲートウェイに一度だけ接続してください。

または、フル Pipeworx ゲートウェイに接続すると、このパックだけでなく、すべてのパックのツールが直接表示されます。

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL も、同じゲートウェイと同じ 1683+ のデータソースにアクセスします。異なるのは、どのパックのツールが直接表示されるかだけです。ask_pipeworx を使えば、どちらからでもすべてのツールにアクセスできます。

MCP クライアントをお持ちでない場合：HTTP で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/reliefweb_reports \
  -H 'Content-Type: application/json' \
  -d '{"country":"Sudan","format":"Situation Report","limit":10}'

最初の呼び出しにアカウントは必要ありません。ツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/reliefweb_reports を実行してください。ツールを検索するには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行してください。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージは、ローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイへの往復通信も不要です。

{
  "mcpServers": {
    "reliefweb": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-reliefweb"]
    }
  }
}

または、直接実行して起動を確認してください。

npx -y @pipeworx/mcp-reliefweb

stdin/stdout 経由で MCP 通信を行い、このパックのツールのみに対して initialize／tools/list／tools/call に応答します。上記のゲートウェイ接続で追加される共通メタツールは含まれません。同じソース、同じツールですが、ask_pipeworx によるルーティングはありません。

ask_pipeworx を使用する

ツールを直接呼び出す代わりに、自然な英語で質問できます。この方法は、上記のパックエンドポイントでもフルゲートウェイでも利用できます。

ask_pipeworx({ question: "your question about Reliefweb data" })

ゲートウェイが適切なツールを選び、引数を自動的に設定します。

その他

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT