NS Pros Data API

NS Pros Data API

全球公共数据，一个 API。

公共数据分散在数千个政府门户网站中——每个来源都有自己的 API 风格、响应格式和许可条款。NS Pros Data API 将许可已审核的公共数据来源规范化为一个 REST API 和一个 MCP 服务，让开发者和 AI Agent 只需一个密钥和一种响应格式，就能查询所有数据。

• 目录（无需密钥）： https://api.nspros.ca/v1/sources
• 产品与注册： https://data.nspros.ca
• 文档： https://data.nspros.ca/docs · REST 参考 · MCP 指南 · OpenAPI 规范 · llms.txt

目录内容

天气、地震、金融、健康、商业、科学和公共记录数据，来源包括：

• 日本气象厅 — 天气预报和地震报告
• 世界银行 — 全球经济指标
• 美国国家气象局和美国财政部财政数据
• 加拿大政府开放数据和省级门户网站
• 英国 data.gov.uk / GOV.UK — 包括英国银行假日
• 澳大利亚、新西兰、德国、芬兰、爱尔兰和香港的开放数据门户，以及 arXiv、Crossref 和 DailyMed 等学术来源

每天都会新增来源。目录中的每个来源都具有许可等级 A：其许可条款均已审核，并确认允许商业再分发。每条响应都会自动附带来源的署名文本，因此遵守许可条款是默认设置，而非事后补救。

快速入门

1. 浏览目录——无需密钥

curl "https://api.nspros.ca/v1/sources?category=finance&country=US"

2. 获取免费 API 密钥

在 https://data.nspros.ca/signup 注册——系统会立即发放免费层级密钥，无需银行卡。REST 和 MCP 均可使用同一个密钥。

3a. 通过 REST 查询

curl -H "Authorization: Bearer <key>" \
  "https://api.nspros.ca/v1/query/uk_bank_holidays?q=2026"

响应结构（节选）：

{
  "source": {"name": "UK bank holidays (GOV.UK)", "id": "uk_bank_holidays"},
  "license": "Open Government Licence v3.0 (OGL)",
  "attribution": "Source: UK bank holidays (GOV.UK) — contains public sector information licensed under the Open Government Licence v3.0 (OGL).",
  "query": "2026",
  "cached": false,
  "results": [
    {"title": "...", "snippet": "...", "url": "..."}
  ]
}

无论原始来源采用什么格式，每条结果都是包含 title、snippet 和 url 字段的规范化记录。

完整参考：docs/rest-api.md · 机器可读规范： openapi.yaml

3b. 通过 MCP 连接

服务 URL：https://api.nspros.ca/mcp（可流式传输的 HTTP，使用相同的 Bearer 密钥）

Claude Desktop / Claude Code / Cursor — 在 MCP 配置中添加 （mcpServers）：

{
  "mcpServers": {
    "nspros-data": {
      "url": "https://api.nspros.ca/mcp",
      "headers": {
        "Authorization": "Bearer <key>"
      }
    }
  }
}

VS Code — 改为使用 servers 块：

{
  "servers": {
    "nspros-data": {
      "type": "http",
      "url": "https://api.nspros.ca/mcp",
      "headers": {
        "Authorization": "Bearer <key>"
      }
    }
  }
}

可直接复制的文件位于 examples/。

MCP 工具

工具	说明
search_sources	按关键词、category 和 country 搜索目录。
query_source	按 source_id 查询单个来源。查询次数计入密钥的月度配额。
get_usage	返回密钥的套餐和当前月度用量。

详情和 JSON-RPC 示例：docs/mcp.md

定价

套餐	价格	包含内容
免费	$0	每月 1,000 次请求，无需银行卡
按量付费	每 1,000 次请求 $1.99	超出免费层级后按每千次请求计费

目前注册后会立即发放免费层级密钥。按量付费将于下一步通过 Stripe 接入；在此之前，不会收取任何使用费用。

类别

weather_env · finance · health · business · science · general · immigration_life · library · vehicles

使用 ?category= 和 ?country= 筛选目录（国家代码采用 ISO 标准，例如 US、CA、GB、JP）。

许可政策

每个数据源都有一个许可等级，会在目录中与许可名称和署名文本一同显示：

• 等级 A — 已确认可用于商业再分发。仅提供此等级。
• 等级 B — 使用者可提供自己的上游密钥（BYO）。计划中，尚未提供。
• 等级 C — 仅限内部使用。不提供。
• 等级 D — 暂缓，等待许可审核。不提供。

展示或再分发结果时，请保留每个响应附带的 attribution 字段——其中说明了原始数据源及其许可。

本仓库中的文档和示例代码采用 MIT 许可（参见 LICENSE）。API 返回的数据仍受各原始数据源的许可约束，具体信息见响应中的 license 和 attribution 字段。

速率限制

• 每个密钥：每分钟 120 个请求
• 每个数据源：每分钟 30 个请求
• 响应会根据各数据源专属的 TTL 进行缓存，因此重复的相同查询会更快返回。

联系方式

NS Pros — 加拿大新斯科舍省哈利法克斯 [email protected] · https://nspros.ca · https://data.nspros.ca