机器访问层 · AI 原生
水务图谱，可被查询、被引用、被调用。
机器访问层随网站一同上线，而非事后附加：公开 REST API、模型上下文协议（MCP）服务器、RSS/JSON 订阅源与 llms.txt。默认开放、免费，为 AI 生态提供检索基础设施。
REST API v1
基于 HTTPS 的 JSON，开放 CORS，公开读取层无需密钥。基础路径 /api/v1。
GET/api/v1/facilities
搜索并筛选已发布到图谱的处理设施GET/api/v1/facilities/{id-or-slug}
设施档案、溯源、图谱数据集与公开链接GET/api/v1/facilities/{id-or-slug}/relationships
含陈述证据的设施规范及反向关系GET/api/v1/facilities/{id-or-slug}/observations
经权利审核的观测元数据（绝不返回私有存储 URI）GET/api/v1/facility-coverage
国家与设施类别覆盖台账GET/api/v1/companies
列出并筛选企业和公用事业（kind、地区、wics、等级、q）GET/api/v1/companies/{slug}
含溯源的完整企业记录GET/api/v1/news
含实体链接的情报快讯GET/api/v1/research
按文本、年份、出版物、类型、WICS、开放获取或相关实体检索研究GET/api/v1/research/{id-or-slug}
出版物元数据、溯源与人工批准的分析GET/api/v1/wiki
含结构化信息框的维基条目GET/api/v1/taxonomy
完整 WICS 分类体系（CC BY 4.0）GET/api/v1/stats
语料库实时统计GET/api/v1/search?q=
跨全部实体的统一搜索curl
$ curl https://wateratlas.ai/api/v1/companies?region=apac&wics=02
{
"meta": { "count": 8, "license": "CC0-1.0" },
"results": [
{
"name": "Toray Industries",
"nativeName": "東レ株式会社",
"country": "Japan",
"wics": ["02", "02.1", "02.2", "02.3"],
"tier": 1,
"href": "/api/v1/companies/toray-industries"
}
]
}旗舰
MCP Server
模型上下文协议（MCP）服务器将水务图谱暴露为可调用工具——让 WaterAtlas 成为 Claude、ChatGPT 与 Copilot 工作流中的“水务工具”。
search_companies()按类型、查询、地区、WICS 类别或等级查找水企业或公用事业
get_company()按 slug 获取完整企业档案
find_suppliers()将供应商匹配至自然语言能力需求
search_news()检索情报存档
get_wiki_article()获取维基条目及其结构化信息框
search_research()检索具备溯源的研究文献库
get_research_work()按 ID、slug 或 DOI 获取出版物
find_research_for_entity()查找与特定 WaterAtlas 实体相连的已审研究证据
latest_in()某主题/地区的最新快讯
Claude Code / 命令行
$ claude mcp add --transport http \
wateratlas https://wateratlas.ai/api/mcpmcp.json
{
"mcpServers": {
"wateratlas": {
"type": "http",
"url": "https://wateratlas.ai/api/mcp"
}
}
}端点：POST /api/mcp — 可流式 HTTP 传输。匿名访问每分钟限 120 次，突发上限为 240 次。管理员签发的密钥通过 X-WaterAtlas-API-Key 提交，并受声明的分钟与每日配额约束；未知密钥会被拒绝。暂不提供自助签发。
可选 API 密钥请求头
X-WaterAtlas-API-Key: wa_live_<issued-key>
智能体期望的其他接口
许可
结构化数据采用 CC0 1.0（与维基数据一致），正文采用 CC BY-SA 4.0，WICS 分类采用 CC BY 4.0。公开读取层默认开放——可见性优先于收费。批量与高级端点将对经核验的高流量使用者计量收费（§8.1）。