Reliefweb

@pipeworx/reliefweb

联合国人道主义事务协调厅（UN OCHA）的人道主义信息服务——来自约 4,000 个人道主义组织的局势报告、需求评估、援助呼吁和分析，以及包含 GLIDE 编号的精选灾害登记册。

属于 Pipeworx 的一部分——一个将 AI Agent 连接到 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?) — 获取一份完整报告。

身份验证

仅支持自带凭据（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 已停用。 它会返回 410，提示改用 v2。任何针对 api.reliefweb.int/v1 编写的内容都已失效。
• 公共网站的 RSS 源不能作为替代方案：从服务器出口请求 reliefweb.int/updates/rss.xml 时，无论是否使用浏览器 UA，都会返回 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 的路径，两者均提示“requires an API key”。在 appname 获批之前，无法验证查询路径。

快速开始

添加到你的 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

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

此端点实际提供的内容

tools/list 在 https://gateway.pipeworx.io/reliefweb/mcp 返回上表中的工具，以及 Pipeworx 共享元工具——ask_pipeworx、discover_tools、search_within、remember/recall 和网关级工具集中的其他工具。因此，你看到的工具数量会多于此表：目前，单个工具包端点除了列出该工具包自身的工具外，还会列出大约 30 个共享工具。连接的 initialize 响应会说明其确切范围，并且是当天有效范围的权威说明。

这是有意为之，并非意外多路复用。元工具让受限连接也能回答此工具包未涵盖的问题——通过 ask_pipeworx 跨整个目录进行路由——无需再添加第二个 MCP 服务。目前无法挂载不含这些元工具的工具包端点；如果额外的架构定义耗费的上下文超过了路由带来的收益，请连接一次完整网关，而不是连接多个工具包端点。

也可以连接完整的 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":"..."} 向 https://gateway.pipeworx.io/v1/tools/search_packs 发送 POST 请求。

独立运行（无需网关账户）

此软件包也可以作为本地 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