Open citation graph — Cheatsheet

OpenAlex × Claude Code · Blueprint v1 · 1-page

api.openalex.org
Free key · openalex.org/settings/api
$1/day credit · 100 req/sec

01URL 문법 — 5패턴

패턴	예시
단건	`/works/W2741809807`
DOI	`/works/doi:10.1038/nature12373`
검색	`/works?search=AI literacy`
필터	`/works?filter=publication_year:2024`
그룹	`/works?group_by=publication_year`

매번: &api_key=YOUR_OPENALEX_KEY + &per-page=200

02자주 쓰는 필터

목적	필터
연도 범위	`publication_year:>2022`
최소 인용	`cited_by_count:>49`
OA만	`is_oa:true`
저널	`primary_location.source.id:S42640028`
저자	`author.id:A5021100368`
토픽	`topics.id:T14025`
국가	`authorships.institutions.country_code:KR`
인용 X	`cites:W2741809807`
타입	`type:journal-article`

콤마(,) AND · 파이프(|) OR · 느낌표(!) NOT

037대 엔티티

Endpoint	Pre	핵심 필드
/works	W	title, authorships, referenced_works, cited_by_count, topics
/authors	A	display_name, orcid, works_count, last_known_institutions
/sources	S	display_name, issn, type, host_organization
/institutions	I	display_name, ror, country_code
/topics	T	display_name, subfield, field, domain
/funders	F	display_name, country_code, grants_count
/publishers	P	display_name, hierarchy_level

04페이지네이션

≤ 200건: per-page=200 한 번이면 끝
200–10K: cursor=*로 시작, 응답 meta.next_cursor 다음 호출
> 10K: page=N은 10K cap; cursor만 사용
전체 dump: 매월 ~330GB · S3 openalex-snapshot

안전 마진: time.sleep(0.05) (100/sec 하드 리밋)

05Claude Code 연결 패턴

패턴	셋업	언제
A · 직접 프롬프트	0분	일회성·5–20건
B · 헬퍼 스크립트 권장	5분	프로젝트 단위
C · MCP 서버	30분	여러 프로젝트

B로 시작 — openalex_helper.py
두 번째 프로젝트에서 같은 패턴 반복 시 C로 승격

06아이디어 → API 5단계

RQ 한 문장으로
데이터 shape 테이블 형태로 그리기
API 시퀀스: 어떤 entity → 어떤 filter
분석: aggregate / model / test
시각화 + 검증: robustness

한 프롬프트 = 한 단계. 5단계 한 번에 시키지 말 것.

07안 하는 것 Anti

너무 넓은 첫 호출 ("education" → 50만 건)
이름만으로 저자 매칭 (ORCID 없으면 동명이인)
WebFetch 한 번으로 1만 건 (페이지네이션 무시)
인용 그래프 무한 hop (1-hop 제한)
Raw JSON 전체를 LLM에 (필요 필드만 select)
인용수 절대값 단독 보고 (snapshot 날짜 명시)

08검수 체크리스트

총 count 합리적인가 (0/100만 둘 다 의심)
각 단계 결과를 file로 저장 (다음 단계 재사용)
None / 빈 배열 비율 보고
OPENALEX_KEY env var 설정됐나 (api_key 자동 주입)
"OpenAlex API, accessed YYYY-MM-DD" 명시
vault에는 정제 산출물만, 원시는 프로젝트

09자주 쓰는 프롬프트

저자: ORCID 0000-...의 모든 works → JSONL
인용: DOI ...를 인용한 2024+ 논문 표
저널: ISSN로 source_id → 2015–25 paginate
토픽: T14025 group_by=year
알림: search "topic" + 지난 30일

10레퍼런스

developers.openalex.org — 공식 API 문서 (구 docs.openalex.org)
api.openalex.org — API root (모든 호출에 api_key 필수)
openalex.org/settings/api — 무료 키 발급
Priem et al. 2022 — arXiv:2205.01833
pip install pyalex — Python client
가이드북 본체: index.html
케이스 스터디: discourse_lens_v2_recipe.md