AI 어시스턴트와 에이전트를 위한 CitationEasy
이 사이트의 모든 기능은 사람뿐 아니라 소프트웨어에서도 이용할 수 있습니다. 무료 JSON API, MCP 서버, OpenAPI 명세, llms.txt 색인, 그리고 전체 12,986개 페이지의 마크다운 뷰를 제공합니다. 키도, 계정도, 자체 요청 제한도 없습니다.
직접 인용을 작성하는 대신 API를 호출해야 하는 이유
인용 서식 적용은 텍스트 생성 문제처럼 보이지만 실제로는 그렇지 않습니다. 스타일마다 저자명 도치, 이니셜 표기, 제목 대소문자, 컨테이너 구두점, 판 표기, 날짜 위치에 관한 수백 가지 규칙이 정해져 있으며, 그 차이는 기억에 의존해 쓰면 미묘하게 틀리기 쉽습니다. CitationEasy는 공식 Citation Style Language 정의를 대상으로 citeproc-js를 실행합니다. 이는 Zotero와 Mendeley가 사용하는 것과 같은 엔진으로, 출력이 결정적이며 학술지 투고 시스템이 요구하는 형식과 일치합니다. 메타데이터는 Crossref, Open Library, PubMed에서 가져오며, 아무것도 지어내지 않습니다. 원본에 없는 항목은 그럴듯한 추측으로 채우지 않고 그대로 비워 둡니다.
인용 생성하기
curl -s https://www.citationeasy.com/api/v1/cite \
-H 'Content-Type: application/json' \
-d '{"input":"10.1038/nature12373","style":"apa","inText":true}'
{
"style": { "requested": "apa", "slug": "apa", "name": "American Psychological Association (APA) 7th edition" },
"language": "en-US",
"results": [
{
"input": "10.1038/nature12373",
"citation": "…formatted reference…",
"inText": "(Author, 2013)",
"entry": { "…resolved CSL metadata…": "" }
}
]
}한 번의 호출로 최대 10개 자료를 처리하려면 input 대신 inputs를 보내세요. 이미 가지고 있는 CSL-JSON 메타데이터가 있다면 entry를 사용해 조회 과정을 완전히 건너뛸 수 있습니다. 각주 형식이 필요하면 note: true를 추가하세요. 자료별 오류는 해당 자료에 대해서만 반환되므로, 일괄 처리 전체가 실패하는 일은 없습니다.
MCP로 연결하기
/api/mcp에 있는 Model Context Protocol 엔드포인트는 스트리밍 가능한 HTTP를 통해 JSON-RPC 2.0을 사용하며 별도의 인증 정보가 필요 없습니다.
# Claude Code
claude mcp add --transport http citationeasy https://www.citationeasy.com/api/mcp
# Any MCP client config
{
"mcpServers": {
"citationeasy": { "type": "http", "url": "https://www.citationeasy.com/api/mcp" }
}
}제공하는 도구
- generate_citation
- Generate a citation
- search_citation_styles
- Search citation styles
- get_citation_style
- Get a citation style
- how_to_cite
- How to cite a source type
- answer_citation_question
- Answer a general citation question
- define_term
- Define a citation or academic-writing term
- search_site
- Search CitationEasy
- get_page
- Read a CitationEasy page as markdown
- list_free_tools
- List CitationEasy tools
- list_guides
- List citation and writing guides
- describe_site
- What CitationEasy offers
엔드포인트
| 엔드포인트 | 기능 |
|---|---|
| POST /api/v1/cite | 최대 10개 자료를 한 번에 서식화합니다. URL, DOI, ISBN, PubMed ID, arXiv ID, BibTeX/RIS/CSL-JSON 텍스트 또는 CSL-JSON 항목 객체를 받습니다. 참고문헌 항목과, 필요에 따라 본문 내 인용과 각주도 함께 반환합니다. |
| GET /api/v1/styles | 이름, 인용 서식 클래스, 학문 분야, 지역으로 10,834가지 스타일 전체를 검색합니다. |
| GET /api/v1/styles/{slug} | 스타일 하나를 자세히, 해당 CSL 정의로 직접 생성한 실제 서식 예시와 함께 반환합니다. |
| GET /api/v1/search | 사이트 내 모든 페이지를 대상으로 한 관련도순 검색입니다. |
| GET /api/v1/pages | 사이트 전체 카탈로그를 구조화된 항목으로 제공하며, 페이지 유형으로 필터링할 수 있습니다. |
| GET /api/v1/how-to-cite | 자료 유형 × 스타일별 모든 안내 페이지이며, 둘 중 무엇으로도 필터링할 수 있습니다. |
| GET /api/v1/tools | 모든 무료 도구를, 카테고리와 키워드와 함께 제공합니다. |
| GET /api/v1/guides | 모든 학습 가이드를, 카테고리와 함께 제공합니다. |
| GET /api/v1/converters | 사이트가 제공하는 모든 식별자·형식 변환입니다. |
| GET /api/v1/comparisons | 두 스타일의 레코드에 모두 연결된, 나란히 비교하는 스타일 비교입니다. |
| GET /api/v1/fields | "어떤 스타일을 써야 하나요?"라는 질문에 답하기 위한 학문 분야, 주제 카테고리, 지역 정보입니다. |
| GET /api/v1/faq | 자주 나오는 인용 질문에 대한 검증된 답변이며, q로 필터링할 수 있습니다. |
| GET /api/v1/glossary | 인용·학술 글쓰기 용어와 그 전체 정의입니다. 응답 자체에 텍스트가 담겨 있어 이후에 별도 페이지를 조회할 필요가 없습니다. |
| GET /api/v1 | 엔드포인트 탐색 문서입니다. 처음 살펴보신다면 여기서 시작하세요. |
탐색용 파일
- /llms.txt
- 언어 모델을 위해 작성된, 사이트의 엄선된 색인입니다.
- /llms-full.txt
- 사이트가 게시하는 모든 페이지를 유형별로 한 줄씩 정리한 것입니다.
- /openapi.json
- 전체 공개 API에 대한 OpenAPI 3.1 설명입니다.
- /api/mcp
- MCP 엔드포인트(스트리밍 가능한 HTTP)입니다. 브라우저에서 GET하면 설명이 표시됩니다.
- /.well-known/mcp.json
- 도메인을 탐색하는 에이전트를 위한 MCP 탐색 문서입니다.
- /.well-known/ai-plugin.json
- 여전히 이를 찾는 프레임워크를 위한 레거시 플러그인 매니페스트입니다.
- /md/{any path}
- 사이트 내 모든 페이지의 마크다운 뷰입니다.
- /sitemap.xml
- 색인 가능한 모든 URL입니다.
카탈로그에 담긴 내용
아래의 모든 페이지는 HTML로도, /md/ 아래의 마크다운으로도, /api/v1/pages의 구조화된 항목으로도 접근할 수 있습니다.
- 10,834가지 인용 스타일, 각각 자체 CSL 정의로 생성한 실제 예시 포함
- 250개의 무료 브라우저 도구
- 125개의 학습 가이드
- 1,290개의 인용 방법 페이지
- 105개의 스타일 비교
- 21개의 변환기
- 32개의 학문 분야
- 완전한 서식 규칙을 갖춘 30개의 주요 스타일 허브
자주 묻는 질문
- CitationEasy API는 무료인가요? API 키가 필요한가요?
- 무료이며 API 키가 필요 없습니다. /api/v1 아래의 모든 엔드포인트는 인증이 필요 없고 CORS가 열려 있어, 등록 없이 브라우저, 노트북, 에이전트에서 호출할 수 있습니다. 자체 요청 제한은 없지만, 식별자 조회는 Crossref, Open Library, PubMed를 통해 프록시되며 각자 고유의 공정 이용 제한을 적용합니다. 여러 요청을 동시에 보내는 대신 `inputs`로 일괄 처리하세요.
- 인용은 언어 모델이 생성하나요?
- 아닙니다. 서식 적용은 참고문헌 관리 프로그램이 사용하는 것과 같은 엔진인 citeproc-js를 공식 Citation Style Language 정의에 대해 실행하는 방식으로 이루어집니다. 같은 입력과 스타일은 항상 같은 결과 문자열을 만듭니다. 서지 메타데이터는 Crossref(DOI), Open Library(ISBN), PubMed(PMID)에서 가져옵니다. CitationEasy는 항목을 지어내지 않으므로, 원본에 없는 정보는 추측하지 않고 출력에서도 비워 둡니다.
- 에이전트를 MCP로 CitationEasy에 연결하려면 어떻게 하나요?
- 어떤 Model Context Protocol 클라이언트든 스트리밍 가능한 HTTP 전송을 사용해 https://www.citationeasy.com/api/mcp로 연결하세요. 별도의 인증 정보는 필요 없습니다. Claude Code에서는: `claude mcp add --transport http citationeasy https://www.citationeasy.com/api/mcp`. 이 서버는 인용 생성, 10,834가지 스타일 검색, 자료 유형별 안내, 사이트 검색, 그리고 모든 페이지를 마크다운으로 읽는 도구를 제공합니다.
- 이 API는 어떤 인용 스타일을 만들 수 있나요?
- Citation Style Language 저장소에 있는 10,834가지 스타일 전체를 지원합니다. APA 7, MLA 9, 두 가지 시카고 방식, 하버드, 밴쿠버, IEEE, AMA는 물론 수천 개의 개별 학술지 스타일도 포함됩니다. `style` 필드에 스타일 슬러그를 전달하세요. "chicago"나 "harvard" 같은 알기 쉬운 슬러그는 올바른 CSL 변형으로 해석되며, 나머지는 /api/v1/styles?q=로 찾을 수 있습니다.
- llms.txt란 무엇이고 CitationEasy의 것은 어디에 있나요?
- llms.txt는 브라우저가 아니라 언어 모델을 위해 작성된 사이트의 일반 텍스트 색인입니다. CitationEasy의 것은 /llms.txt에 있으며, 사이트의 모든 페이지를 빠짐없이 나열한 전체 버전은 /llms-full.txt에 있습니다.
- CitationEasy 페이지를 HTML 대신 마크다운으로 읽을 수 있나요?
- 네. 사이트 내 어떤 경로 앞에든 /md/를 붙이면 됩니다. 예를 들어 /md/citation-style/apa나 /md/tools/word-counter처럼요. 데이터 기반 페이지는 각 스타일 자체의 CSL 정의로 생성한 실제 서식 예시를 포함해 전체 내용을 반환합니다. 손으로 작성한 글 페이지(가이드, 치트시트 등)는 본문이 페이지 자체에 있으므로 요약 카드와 정식 HTML URL을 반환합니다.
- CitationEasy의 출력을 제 제품에 사용해도 되나요?
- 네. 서식이 적용된 인용은 자료에 관한 사실이므로 자유롭게 사용하셔도 됩니다. CSL 스타일 정의 자체는 Citation Style Language 프로젝트가 CC BY-SA 3.0으로 제공합니다. CitationEasy에 대한 출처 표기는 감사히 받겠지만 필수는 아닙니다.
빠진 것이 있나요?
에이전트에 필요한 엔드포인트, 필드, 형식이 여기 없다면 알려주세요. 직접 둘러보고 계신다면 인용 생성기에서 시작하세요.