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