GET/api/v1
API 안내 — 엔드포인트·매개변수·라이선스 목록
curl https://next-token.net/api/v1출처로 확인한 AI 역사 기록 1,295개를 프로그램과 AI 도구에서 읽을 수 있어요. 읽기 전용이고, 로그인도 키도 없어요.
기록 찾기·한 건 읽기·오늘의 AI 역사·5분 용어·축·문장 맞춰 보기. GET 요청만 받고 JSON으로 답해요.
Claude·ChatGPT·Cursor·VS Code 같은 AI 도구에 주소 하나만 넣으면 기록을 찾아 근거로 쓸 수 있어요.
주소는 https://next-token.net/api/v1이에요. 모든 답은 JSON이고, 어느 웹 페이지에서나 부를 수 있게 CORS를 열어 두었어요(Access-Control-Allow-Origin: *).
405.lang=ko(기본) 또는 lang=en으로 한국어·영어를 골라요.Cache-Control: public, max-age=300이 붙어요. 5분 안에 같은 걸 다시 부르지 마세요.400, 없는 것은 404, 너무 잦으면 429와 Retry-After. 오류도 JSON이에요: {"error": {"code", "message"}}.license·attribution·docs가 들어 있어요. 화면에 보여 줄 때는 출처 줄을 함께 적어 주세요./api/v1API 안내 — 엔드포인트·매개변수·라이선스 목록
curl https://next-token.net/api/v1/api/v1/records기록 찾기와 걸러 보기. q가 있으면 가까운 순서(BM25), 없으면 날짜순이에요.
| 이름 | 설명 |
|---|---|
q | 찾을 말 (한국어·영어, 최대 200자) |
axis | 축 번호 0–21 (주 축이나 함께 걸린 축) |
year | 연도 (예: 2017) |
from | 이 날짜부터 (YYYY-MM-DD) |
to | 이 날짜까지 (YYYY-MM-DD) |
source | primary(1차 출처) 또는 secondary(보도) |
order | asc(기본) 또는 desc — q가 없을 때 날짜 순서 |
limit | 한 번에 몇 개 (1–50, 기본 20) |
offset | 건너뛸 개수 (다음 쪽) |
lang | ko 또는 en |
curl -G https://next-token.net/api/v1/records --data-urlencode "q=트랜스포머 논문" -d lang=ko -d limit=1{
"data": [
{
"id": "E0078",
"url": "https://next-token.net/e/E0078/",
"lang": "ko",
"title": "Transformer 논문 Attention Is All You Need 공개",
"date": "2017-06-12",
"date_precision": "day",
"date_text": "2017년 6월 12일",
"axis": 1,
"axis_name": "프롬프트 엔지니어링",
"also_axes": [],
"actor": "Google (Vaswani 외)",
"event": "Transformer 논문 Attention Is All You Need 공개",
"significance": "순환 없이 self-attention만으로 병렬 학습이 가능해져 대규모 사전학습의 구조적 전제가 성립",
"source": {
"url": "https://arxiv.org/abs/1706.03762",
"domain": "arxiv.org",
"type": "primary",
"kind": "paper"
},
"claim_type": "fact",
"added_week": "2026-W35",
"score": 12.09
}
],
"meta": {
"total": 67,
"limit": 1,
"offset": 0,
"lang": "ko",
"order": "relevance",
"query": {
"q": "트랜스포머 논문"
}
},
"license": {
"name": "CC BY-NC 4.0",
"url": "https://creativecommons.org/licenses/by-nc/4.0/"
},
"attribution": "다음 조각 · Next Token (next-token.net) — factnotes, https://blog.naver.com/factnotes",
"docs": "https://next-token.net/developers/"
}/api/v1/records/{id}기록 한 건 (예: E0004)
| 이름 | 설명 |
|---|---|
lang | ko 또는 en |
curl https://next-token.net/api/v1/records/E0004?lang=ko{
"data": {
"id": "E0004",
"url": "https://next-token.net/e/E0004/",
"lang": "ko",
"title": "다트머스 하계 연구 프로젝트 제안서 작성",
"date": "1955-08-31",
"date_precision": "day",
"date_text": "1955년 8월 31일",
"axis": 0,
"axis_name": "전사 — 신경망에서 Transformer까지",
"also_axes": [],
"actor": "John McCarthy·Marvin Minsky·Nathaniel Rochester·Claude Shannon",
"event": "다트머스 하계 연구 프로젝트 제안서 작성 — artificial intelligence 용어 최초 사용",
"significance": "분야에 이름이 붙은 문서. 이듬해 1956년 워크숍으로 이어짐",
"source": {
"url": "http://www-formal.stanford.edu/jmc/history/dartmouth/dartmouth.html",
"domain": "www-formal.stanford.edu",
"type": "primary",
"kind": "official"
},
"claim_type": "fact",
"added_week": "2026-W35"
},
"license": …, "attribution": …, "docs": …
}/api/v1/today오늘의 AI 역사 — 같은 날짜(월·일)의 기록. 날짜를 안 주면 한국 시간으로 오늘이에요.
| 이름 | 설명 |
|---|---|
date | MM-DD (예: 03-14) |
lang | ko 또는 en |
curl https://next-token.net/api/v1/today?date=03-14&lang=ko{
"data": {
"date": "03-14",
"page": "https://next-token.net/today/03-14/",
"records": [
{
"id": "E0201",
"url": "https://next-token.net/e/E0201/",
"lang": "ko",
"title": "Claude 정식 출시",
"date": "2023-03-14",
"date_precision": "day",
"date_text": "2023년 3월 14일"
}
]
},
"meta": {
"lang": "ko"
},
"license": …, "attribution": …, "docs": …
}/api/v1/terms5분 용어 — 낱말 목록과 찾기
| 이름 | 설명 |
|---|---|
q | 낱말이나 뜻으로 찾기 |
lang | ko 또는 en |
curl -G https://next-token.net/api/v1/terms --data-urlencode "q=인공지능" -d lang=ko{
"data": [
{
"slug": "ai",
"term": "인공지능",
"aka": [
"AI",
"artificial intelligence",
"인공 지능",
"에이아이"
],
"short": "사람의 머리가 필요했던 일을 컴퓨터가 해내게 하는 기술이에요.",
"group": "basics",
"level": 1,
"url": "https://next-token.net/glossary/ai/"
}
],
"meta": {
"total": 1,
"lang": "ko",
"query": {
"q": "인공지능"
}
},
"license": …, "attribution": …, "docs": …
}/api/v1/terms/{slug}5분 용어 한 낱말 — 뜻·설명·비유·이어진 기록
| 이름 | 설명 |
|---|---|
lang | ko 또는 en |
curl https://next-token.net/api/v1/terms/ai?lang=ko/api/v1/axes22개 축 — 이름·소개·기록 수
| 이름 | 설명 |
|---|---|
lang | ko 또는 en |
curl https://next-token.net/api/v1/axes?lang=ko{
"data": [
{
"axis": 0,
"mark": "⓪",
"name": "전사 — 신경망에서 Transformer까지",
"lead": "AI가 Transformer에 닿기까지, 80년 동안 무엇이 쌓였나",
"body": "…",
"count": 66,
"url": "https://next-token.net/axis/0/"
}
],
"meta": {
"total": 22,
"lang": "ko"
},
"license": …, "attribution": …, "docs": …
}/api/v1/check문장 맞춰 보기 — 「이 말 맞아?」와 같은 규칙. 판정은 match·mismatch·partial·not_found.
| 이름 | 설명 |
|---|---|
claim | 맞춰 볼 문장 (300자까지). 저장하거나 기록하지 않아요. |
lang | ko 또는 en |
curl -G https://next-token.net/api/v1/check --data-urlencode "claim=다트머스 회의는 1956년에 열렸다" -d lang=ko{
"data": {
"claim": "다트머스 회의는 1956년에 열렸다",
"lang": "ko",
"verdict": "match",
"label": "연도가 기록과 같아요",
"message": "「다트머스 하계 연구 프로젝트 제안서 작성」 기록과 맞춰 봤어요. 문장의 연도가 기록과 같아요. 연도만 맞춰 봤으니 문장 전체가 맞다는 뜻은 아니에요.",
"matched": [
"year"
],
"reason": "same",
"parts": [
{
"part": "year",
"claim": "1956",
"record": "1956",
"ok": true,
"basis": "record_text"
}
],
"records": [
{
"id": "E0004",
"url": "https://next-token.net/e/E0004/",
"lang": "ko",
"title": "다트머스 하계 연구 프로젝트 제안서 작성",
"date": "1955-08-31",
"date_precision": "day",
"date_text": "1955년 8월 31일"
}
],
"note": "기록에 없다고 틀린 말은 아니에요. 이 판정은 기록과 맞춰 본 결과일 뿐이에요."
},
"license": …, "attribution": …, "docs": …
}주소는 https://next-token.net/mcp이에요. Streamable HTTP 방식이고, 상태를 남기지 않아요(세션 없음). 로그인이나 키 없이 바로 연결돼요. 지원하는 프로토콜 버전: 2026-07-28 · 2025-11-25 · 2025-06-18 · 2025-03-26 · 2024-11-05. 한 번에 보내는 묶음(batch)은 4개까지이고, 메시지마다 요청 한도에 들어가요.
설정(Settings) → 커넥터(Connectors) → 사용자 지정 커넥터 추가(Add custom connector)를 누르고 이름(예: 다음 조각)과 아래 주소를 넣어요. 인증은 필요 없어요.
https://next-token.net/mcp터미널에서 한 줄이면 돼요.
claude mcp add --transport http next-token https://next-token.net/mcp~/.cursor/mcp.json(모든 프로젝트) 또는 프로젝트의 .cursor/mcp.json에 넣어요.
{
"mcpServers": {
"next-token": {
"url": "https://next-token.net/mcp"
}
}
}작업 공간의 .vscode/mcp.json에 넣거나, 명령 팔레트의 「MCP: Add Server」에서 HTTP를 고르고 주소를 붙여 넣어요.
{
"servers": {
"next-token": {
"type": "http",
"url": "https://next-token.net/mcp"
}
}
}개발자 모드를 쓸 수 있는 요금제에서: 설정(Settings) → 앱(Apps) → 고급 설정(Advanced settings)에서 개발자 모드를 켜고, 앱 만들기(Create)에 아래 주소를 넣은 뒤 인증은 「없음」을 골라요.
https://next-token.net/mcp모든 도구는 읽기만 해요(readOnlyHint). 답은 짧은 글(기록 주소·출처 줄 포함)과 구조화된 JSON(structuredContent) 두 가지로 와요.
| 도구 | 설명 | 받는 값 |
|---|---|---|
search_records | 기록 찾기 (축·연도로 좁히기) | query, axis?, year_from?, year_to?, lang?, limit? |
get_record | 기록 한 건 전체 | id, lang? |
on_this_day | 같은 날짜(월·일)의 기록 | date? (MM-DD), lang? |
timeline | 한 해나 한 축의 기록을 날짜순으로 | year? | axis?, lang?, limit? |
check_claim | 문장을 기록과 맞춰 보기 | claim, lang? |
define_term | 5분 용어의 뜻과 설명 | term, lang? |
cite | 기록 인용문 (plain·APA·BibTeX) | id, style (plain | apa | bibtex), lang? |
429와 Retry-After를 받아요.문장 맞춰 보기(/check, check_claim)에 보낸 문장은 답을 만드는 데만 쓰고 저장하지도 기록하지도 않아요. 다른 요청도 내용이나 주소를 남기지 않아요.
기록과 글은 CC BY-NC 4.0이에요. 비영리 목적이면 출처를 밝히고 자유롭게 쓰고 고치고 나눌 수 있어요. 출처 줄은 이렇게 적어 주세요:
다음 조각 · Next Token (next-token.net) — factnotes, https://blog.naver.com/factnotes
파일 전체와 열 설명은 데이터셋 페이지에 있어요. 데이터셋 페이지