数据

面向 AI 智能体与开发者的 Citoyen

Citoyen 的数据不仅供屏幕前的读者阅读,AI 助手和程序也可以读取。一个只读的公开服务器向它们提供与卡片相同的序列,每个序列都附有官方编制机构、时期和单位,让回答能够说明数字的来源。

MCP 服务器

Model Context Protocol(MCP)是 Claude、ChatGPT 等助手调用外部工具所用的标准。Citoyen 的服务器免费,无需密钥或账户,只做读取:不保存所提的问题,只统计调用次数以保证服务可用。

服务器地址

https://citoyenapp.com/mcp

如何连接

  1. 在 Claude 中

    在 claude.ai 或桌面应用中依次打开“设置”“连接器”“添加自定义连接器”,然后粘贴服务器地址。

  2. 在其他助手中

    开发者模式下的 ChatGPT 以及其他支持远程 MCP 服务器的助手:用服务器地址添加一个 HTTP 连接器。

  3. 在代码编辑器中

    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 的选择、核查和文字受保护,不允许系统性提取其数据库。详情: 法律声明