数据
面向 AI 智能体与开发者的 Citoyen
Citoyen 的数据不仅供屏幕前的读者阅读,AI 助手和程序也可以读取。一个只读的公开服务器向它们提供与卡片相同的序列,每个序列都附有官方编制机构、时期和单位,让回答能够说明数字的来源。
MCP 服务器
Model Context Protocol(MCP)是 Claude、ChatGPT 等助手调用外部工具所用的标准。Citoyen 的服务器免费,无需密钥或账户,只做读取:不保存所提的问题,只统计调用次数以保证服务可用。
服务器地址
https://citoyenapp.com/mcp如何连接
在 Claude 中
在 claude.ai 或桌面应用中依次打开“设置”“连接器”“添加自定义连接器”,然后粘贴服务器地址。
在其他助手中
开发者模式下的 ChatGPT 以及其他支持远程 MCP 服务器的助手:用服务器地址添加一个 HTTP 连接器。
在代码编辑器中
Cursor、VS Code、Claude Code 等工具:按下方示例将服务器加入其 MCP 配置。
适用于读取 MCP 配置文件的客户端:
{
"mcpServers": {
"citoyen": {
"type": "http",
"url": "https://citoyenapp.com/mcp"
}
}
}工具
- search
- 查找指标及其代码、问题中提到的国家以及相关出版物。
- get_series
- 某个国家某项指标的序列,与其卡片显示一致:按时期的数值、单位、编制机构和来源链接。默认返回最近 10 年。
- compare_countries
- 2 至 8 个国家的同一指标,取自单一的统一来源,确保数值可比。
- get_ranking
- 所有覆盖国家在某项指标上、按共同的最新时期从高到低排列。
- get_publication
- 综述说明、分析或改革概况的要点,并附全文链接。
- get_release_calendar
- 各序列的下一次发布:编制机构的官方日期或估计时间窗。
限制与规则
- 每个地址每分钟最多 60 次调用。超出后,服务器会提示稍后重试。
- 序列默认覆盖 10 年(可请求最多 80 年,每次回答最多 600 个数据点);比较覆盖 2 至 8 个国家。
- 私营编制机构的序列,以及 SIPRI 通过世界银行发布的军事序列,只提供最新值和卡片链接:其使用条款不允许转发完整序列。
- 出版物只提供要点和链接,从不提供全文。
- 标记为预测的数值是预测,而非实际数据。
- 每个回答都注明编制机构:请注明该机构,并附上回答中给出的 Citoyen 页面链接。
- 调用按天计数,使用由 IP 地址生成、每天更换的匿名密钥;地址本身从不保存,计数保留 30 天。
其他获取方式
- 每个指标页面都以 CSV 格式提供其序列:在其地址后加上 /data.csv(私营编制机构的序列除外)。
- 供 AI 爬虫使用的纯文本网站地图: /llms.txt
- 任何卡片都可以通过“嵌入”按钮嵌入其他网站。
如何引用
请注明每个数字所附的官方编制机构,并注明 Citoyen 为读取该数字的地方,附上其页面链接。
Citoyen 的选择、核查和文字受保护,不允许系统性提取其数据库。详情: 法律声明
