データ

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
1つの国の1つの指標の系列を、カードと同じ形で返します。期間ごとの値、単位、作成機関、出典へのリンク。既定は直近10年です。
compare_countries
2〜8か国の1つの指標を、値が比較できるよう単一の調和化された出典から返します。
get_ranking
対象となるすべての国を、共通する最新の期間について1つの指標で値の高い順に並べます。
get_publication
総括ノート、分析、改革ファクトシートの要点を、全文へのリンクとともに返します。
get_release_calendar
系列の次回公表予定:作成機関の公式日程、または推定期間。

制限とルール

  • 1つのアドレスにつき毎分60回まで。それを超えると、少し時間をおいて再試行するよう求められます。
  • 系列は既定で10年分です(要求に応じて最大80年、1回の回答で最大600点)。比較は2〜8か国が対象です。
  • 民間の作成機関による系列と、SIPRIが世界銀行を通じて公表する軍事関連の系列は、最新値とカードへのリンクのみを返します。それらの利用条件では系列全体の提供が認められていないためです。
  • 出版物は要点とリンクのみを返し、全文は返しません。
  • 予測と表示された値は見通しであり、実績値ではありません。
  • 各回答には作成機関が明記されています。回答に含まれるCitoyenのページへのリンクとともに出典として示してください。
  • 呼び出しは、IPアドレスから毎日変わる匿名キーを作って日ごとに数えます。アドレス自体は保存せず、集計は30日間保管します。

その他の利用方法

  • 各指標ページは系列をCSVで提供しています。アドレスの末尾に /data.csv を付けてください(民間の作成機関による系列を除く)。
  • AIクローラー向けのプレーンテキストのサイトマップ: /llms.txt
  • どのカードも「埋め込む」ボタンで他のサイトに埋め込めます。

出典の示し方

各数値とともに示された公式の作成機関と、数値を参照した場所としてCitoyenを、そのページへのリンクとともに記してください。

Citoyenの選定、検証、テキストは保護されており、データベースの体系的な抽出は認められていません。詳細: 法的表示