데이터

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의 선정, 검증, 텍스트는 보호되며 데이터베이스의 체계적 추출은 허용되지 않습니다. 자세한 내용: 법적 고지