연구 커넥터 인증키 발급 가이드

CMDS Achmage · Research 탭

검증 기준일: 2026-09-16 · 대상 버전: CMDS Achmage 1.2.0 아래 모든 URL은 이 날짜에 직접 접속해 응답을 확인했습니다. 다만 무료 한도·승인 방식·요금 정책은 기관 사정으로 바뀝니다. 최종 기준은 언제나 발급 화면에 실제로 표시되는 내용입니다.

0. 시작하기 전에

설정 화면 찾아가는 법 (모든 소스 공통)

Obsidian 설정 (⌘ ,)
  → 왼쪽 사이드바 아래 '커뮤니티 플러그인' 영역의 CMDS Achmage
  → 상단 탭에서 Research 선택
  → 연결할 소스 카드를 클릭해 펼침
  → 카드 오른쪽 토글을 켬
  → 필드 입력 → [Save] → [Test connection]

상단 탭은 Plan · Research · Writing · MCP · Advanced 다섯 개입니다.

알아둘 것 세 가지

1. 키는 이 컴퓨터에만 저장됩니다. Obsidian SecretStorage에 기기별로 보관되므로, 사무실 PC와 노트북에 각각 입력해야 합니다. Dropbox·iCloud·Git으로 설정을 동기화해도 키는 따라가지 않습니다. 불편하지만 키가 평문으로 클라우드에 올라가지 않게 하려는 의도된 설계입니다. 새 PC에서 소스가 안 되면 대개 이것이 원인입니다.
2. Test connection도 실제 호출을 소비합니다. 성공 메시지에도 그렇게 적혀 있습니다 — "This test used at least one provider request." 하루 50회짜리 소스에서 테스트를 남발하지 마세요.
3. Enabled와 Connected는 다릅니다. 토글을 켠 것은 "쓰겠다"는 뜻이고, Test connection 성공이 "이 기기에서 실제로 된다"는 뜻입니다.

⚠️ 검색어가 외부 서버로 나갑니다 — 이 청중에게 특히 중요합니다

Research 소스를 호출하면 검색어가 해당 기관(미국 NLM, 영국 EMBL-EBI, Clarivate, 한국연구재단, 네이버 등) 서버로 전송됩니다.

• 비공개 심사 자료, 미공개 품목 정보, 업체명이 들어간 문장을 통째로 검색창에 넣지 마세요.
• 공개해도 무방한 일반 학술 키워드로 줄여서 쓰는 것이 원칙입니다.
• 예: "○○사 ○○정 이상사례 보고 건 검토" ❌ → "이상사례 보고" ✅

AI에게 문서를 요약시키는 것과, 그 문서의 문장을 외부 검색 API로 보내는 것은 다른 행위입니다. Research 소스를 켜 두면 후자가 자동으로 일어날 수 있습니다. 민감한 작업에서는 Research 탭 상단의 Source routing을 Off 또는 Explicit @Source only로 두세요.

키가 틀렸을 때 화면에 뜨는 메시지 (공통)

Test connection 결과 줄에 아래 문구가 그대로 표시됩니다. 플러그인 실제 문구입니다.

보안상 안심할 점: 오류 메시지에 provider 응답이 함께 붙는데, 그 안에 키·토큰·secret이 섞여 있으면 플러그인이 자동으로 [redacted]로 가립니다. 오류 메시지를 그대로 복사해 문의해도 키가 새지 않습니다.

막혔을 때 확인 순서 1. 토글이 켜져 있는가 (토글이 꺼져 있으면 Test connection 버튼 자체가 비활성) 2. Save를 눌렀는가 — 입력만 하고 저장 안 한 경우가 가장 흔합니다 3. 키 앞뒤에 공백이 붙어 복사되지 않았는가 4. 해당 API 상품이 승인된 상태인가 (KCI·NTIS·ScienceON은 신청 ≠ 승인) 5. 다른 PC에서 되던 것이면 → 이 PC에 키를 다시 입력해야 합니다 (위 1번 참조)

A. 오늘 당장 되는 것 — 발급 절차 없음

이 셋은 회원가입도, 키 발급도, 승인도 없습니다. 강의 끝나고 10분이면 켤 수 있습니다.

A-1. PubMed

한 줄 설명 — 미국 국립의학도서관(NLM)의 의학·생명과학 문헌 색인. 세계 최대 규모.

이 분들께의 가치 — 독성학, 약동학, 이상사례(pharmacovigilance), 임상시험, 의료기기 안전성 문헌의 1차 검색처입니다. 규제 판단의 과학적 근거를 찾을 때 가장 먼저 여는 곳입니다. 심사보고서나 가이드라인 초안의 참고문헌 후보를 모을 때 기본입니다.

무엇을 돌려주는가 — 서지정보만입니다. 초록이 오지 않습니다. 제목 · 저자 · 저널명 · 출판일 · DOI · PMID · PubMed 링크가 전부입니다. 플러그인이 ESearch로 PMID를 찾고 ESummary로 요약 정보를 받는 구조인데, ESummary에는 초록이 포함되지 않습니다. → 모델이 "초록을 보니 이 연구는…"이라고 말하면 그건 지어낸 것입니다. 초록이 필요하면 Europe PMC를 함께 켜세요 (A-2).

발급 단계 1. 없습니다. Research 탭에서 PubMed 토글을 켭니다. 2. Contact email에 업무용 이메일을 넣습니다. 선택이지만 권장 — NCBI가 과부하 시 연락할 수 있도록 하는 관례이고, 넣어두면 차단 위험이 줄어듭니다. 3. Optional NCBI API key는 비워둡니다. 4. Save → Test connection.

소요 시간·비용·승인 — 1분 / 무료 / 승인 없음 / 기관 소속 불필요

Achmage 설정 위치 — Research → PubMed - Optional NCBI API key (선택, 비워도 됨) - Contact email (권장)

호출 제한 — 키 없이 같은 IP에서 초당 3회. 무료 키를 받으면 초당 10회로 올라갑니다.

키를 굳이 받고 싶다면 (대부분 불필요) 1. https://www.ncbi.nlm.nih.gov/account/ 에서 계정 생성 (→ account.ncbi.nlm.nih.gov로 이동) 2. 로그인 후 우측 상단 사용자명 → Account Settings 3. API Key Management → Create an API Key

주의사항 — Achmage는 검색(ESearch) 후 요약(ESummary)을 부르므로 한 번 검색에 HTTP 요청이 2회 이상 발생합니다. 초당 3회 제한에 생각보다 빨리 닿습니다.

검증 상태 — ✅ 2026-09-16 키 없이 실제 검색 성공 (HTTP 200). 반환 필드는 플러그인 코드에서 직접 확인

A-2. Europe PMC

한 줄 설명 — 유럽 생명과학 문헌 데이터베이스. PubMed와 겹치지만 초록과 오픈액세스 원문 위치를 함께 줍니다.

이 분들께의 가치 — PubMed 결과의 보강용입니다. 같은 주제를 두 곳에서 검색해 한쪽에만 있는 문헌을 잡아냅니다. 특히 유럽 규제기관(EMA) 맥락의 문헌, 그리고 원문을 바로 읽을 수 있는 오픈액세스 논문 위치를 찾는 데 강합니다. 유료 저널 구독이 제한된 환경에서 실질적으로 유용합니다.

무엇을 돌려주는가 — 서지정보 + 초록(abstract) + 인용 수 + 오픈액세스 여부. PubMed와 달리 초록 본문이 실제로 옵니다. 다만 원문 전체(full text)는 아닙니다. 오픈액세스 = Y 표시는 "누구나 볼 수 있는 곳에 원문이 있다"는 뜻이지 "AI가 원문을 읽었다"는 뜻이 아닙니다.

발급 단계 1. 없습니다. 토글을 켜고 Save → Test connection.

소요 시간·비용·승인 — 30초 / 무료 / 승인 없음 / 키 필드 자체가 없음

Achmage 설정 위치 — Research → Europe PMC (입력 필드 없음)

주의사항 — 인용 수는 신뢰도 점수가 아닙니다. 오래된 논문일수록 높게 나옵니다.

검증 상태 — ✅ 2026-09-16 키 없이 실제 검색 성공. pharmacovigilance 검색 시 40,231건 반환 확인. 초록 반환은 코드에서 확인

A-3. Crossref + Retraction Watch

한 줄 설명 — DOI 등록기관. DOI가 진짜인지, 그 논문이 정정·철회(retraction)되었는지 확인합니다.

이 분들께의 가치 — 이 청중에게 가장 중요한 소스일 수 있습니다. 규제 판단 근거로 인용한 논문이 나중에 철회된 것으로 밝혀지면 심각한 문제가 됩니다. 보고서·심사자료의 참고문헌 목록을 통째로 넣고 "DOI와 제목이 맞는지, 철회·정정된 것이 있는지" 확인시키는 용도로 쓰세요. AI가 지어낸 가짜 DOI를 잡아내는 데도 결정적입니다.

무엇을 돌려주는가 — 서지정보 + DOI + 정정·철회 관계 메타데이터. 플러그인이 Crossref의 relation 및 update-to 항목을 읽어 retracted(철회됨) / updated(갱신됨) 상태를 표시하고, 어떤 관계가 붙어 있는지도 함께 보여줍니다. 초록은 등록되어 있을 때만 옵니다. 원문은 오지 않습니다.

발급 단계 1. 없습니다. 토글을 켭니다. 2. Contact email for polite pool에 이메일을 반드시 넣으세요. 선택 항목이지만 실질적 차이가 큽니다 (아래 참조). 3. Save → Test connection.

소요 시간·비용·승인 — 1분 / 무료 / 승인 없음 / 기관 소속 불필요

Achmage 설정 위치 — Research → Crossref + Retraction Watch - Contact email for polite pool (선택이지만 강력 권장)

호출 제한 — 이메일 한 줄의 실제 효과 (직접 측정)

이메일을 넣는 것만으로 3배 빨라집니다. 비용도 승인도 없습니다.

주의사항 — 이것은 Crossref가 보유한 관계 메타데이터를 읽는 기능입니다. Retraction Watch 데이터베이스 전체를 독립적으로 검색하는 도구가 아닙니다. "철회 기록이 없다"가 "철회되지 않았다"는 증명은 아닙니다. 중요한 인용은 출판사 원문과 Crossmark를 함께 확인하세요.

검증 상태 — ✅ 2026-09-16 실제 검색 성공. polite/public 풀 전환을 응답 헤더(x-api-pool)로 직접 확인. 철회 판정 로직은 코드에서 확인

B. 이번 주에 발급할 것 — 이 청중에게 가치가 높음

먼저: A의 무키 3종으로 어디까지 되는가 국제 문헌 검색(PubMed) · 초록과 오픈액세스 원문 찾기(Europe PMC) · DOI 진위와 철회 확인(Crossref)까지 이미 됩니다. 영문 문헌 기반 업무는 A만으로 상당 부분 커버됩니다. B는 A가 원리적으로 못 하는 두 가지를 채웁니다 — 국내 문헌(KCI)과 색인 등재 확인(WoS).

B-1. KCI (한국학술지인용색인) — 한국연구재단

한 줄 설명 — 국내 학술지 논문 색인. 한국연구재단이 운영하는 공식 국내 학술 DB.

이 분들께의 가치 — 국내 규제과학 문헌은 PubMed에 거의 없습니다. 약학회지, 한국독성학회지, 식품위생안전성학회지 등 국내 연구 성과는 KCI에서만 검색됩니다. 국내 선행연구 확인, 국내 연구진 동향 파악, 국문 보고서의 참고문헌 구성에 필수입니다.

지금 이걸 안 해도 되는 이유 — 영문 문헌 중심으로 일하신다면 급하지 않습니다. 국문 참고문헌을 달아야 하는 보고서를 쓸 때 발급하면 충분합니다. 그 전까지는 KCI 웹사이트에서 직접 검색해도 됩니다.

무엇을 돌려주는가 — 서지정보(제목·저자·학술지·연도) + 초록(등록된 경우). 원문은 오지 않습니다.

발급 단계 1. https://www.kci.go.kr/kciportal/po/openapi/openApiList.kci 접속 2. 상단 메뉴 경로는 HOME > KCI 데이터 제공 > OPEN API 입니다. 3. 목록에서 「논문 기본 정보 제공」을 확인합니다. (Achmage가 쓰는 API가 이것입니다.) 4. 페이지의 OPEN API 키신청 버튼을 누릅니다. 5. 로그인이 필요합니다. 계정이 없으면 KCI 회원가입을 먼저 합니다. 6. 용도를 작성하고 인증키를 신청합니다.

현재 제공되는 KCI Open API는 5종입니다 — 인용지수 상세/기본, 논문 상세, 참고문헌, 논문 기본 정보.

소요 시간·비용·승인 - 회원가입 + 신청 작성: 약 10분 - 비용: 별도 요금 고지 없음 (국가 공공 서비스) - 승인 방식: ⚠️ 미확인. 키 신청 페이지가 로그인 뒤에 있어 자동발급인지 심사인지 확인하지 못했습니다. 신청 화면의 안내를 따르세요. - 개인 신청 가능 여부: ⚠️ 미확인 - 문의: 042-869-6674 / kciadmin@nrf.re.kr

Achmage 설정 위치 — Research → KCI - KCI API key

주의사항 — 이게 제일 중요합니다 Achmage의 KCI 어댑터는 제목(title) 검색만 수행합니다. 코드상 검색어가 title 파라미터로 들어갑니다. 따라서: - 자연어 의미 검색이 아닙니다. 초록·본문 검색도 아닙니다. - 검색어를 길게 쓰면 결과가 0건이 됩니다. "의약품 이상사례 보고 체계의 개선방안에 관한 연구"처럼 넣지 말고 "이상사례 보고"처럼 핵심 명사 2~3개로 줄이세요. - 0건이 나오면 "국내 연구가 없다"가 아니라 "제목에 그 단어가 없다"일 가능성이 높습니다.

실패했을 때 — KCI API key is not configured.는 저장이 안 된 것, kci: Authentication or entitlement was rejected.는 키가 틀렸거나 승인 전입니다.

검증 상태 — ✅ 2026-09-16 발급처 URL·API 목록 5종·신청 버튼 확인 / ⚠️ 승인 방식·소요기간·개인 신청 가능 여부 미확인 (로그인 필요)

B-2. ScienceON (KISTI) — ⚠️ 먼저 읽으세요

한 줄 설명 — KISTI(한국과학기술정보연구원)의 국내외 과학기술 문헌·보고서 플랫폼.

이 분들께의 가치 — 국가 R&D 연구보고서 원문, 국내 과학기술 논문, 연구자·연구기관 정보. 국가 과제 결과물을 추적할 때 강합니다.

⚠️ 결론부터: 현재 Achmage 1.2.0에서는 실질적으로 연결이 어렵습니다.

기존 안내 문서(2026-07-27 기준)와 실제가 다릅니다. 이번에 직접 확인한 내용:

(1) 기존 문서에 적힌 발급처 URL이 죽었습니다. https://scienceon.kisti.re.kr/por/oapi/openApi.do → HTTP 404 현행 주소: https://scienceon.kisti.re.kr/por/api/intro/about.do (플러그인 소스 카드의 링크도 아직 옛 404 주소입니다.)

(2) 인증 방식이 단순 API 키가 아닙니다. ScienceON은 현재 토큰 방식입니다: - 인증키(API Key)를 발급받고 → MAC 주소를 등록하고 - {mac_address, datetime}를 발급받은 키로 AES256 암호화해 accounts 값을 만들고 - https://apigateway.kisti.re.kr/tokenrequest.do?accounts=...&client_id=... 호출로 - access_token을 받습니다. 유효기간 2시간. - 실제 검색은 openapicall.do?client_id=...&token=...&searchQuery={"BI":"검색어"}

(3) Achmage의 ScienceON 어댑터는 이 절차를 수행하지 못합니다. 코드상 Approved request URL에 {Query parameter}=검색어 & {Key parameter}=키만 붙여 보내는 단순 구조입니다. AES256 토큰 교환 단계가 없습니다.

(4) 억지로 맞춰도 실용성이 없습니다. 설령 직접 토큰을 발급해 Key parameter를 token으로 놓아도 — ① 2시간마다 토큰을 손으로 다시 붙여넣어야 하고 ② searchQuery는 {"BI":"검색어"} 형태의 JSON이어야 하는데 Achmage는 평문 검색어를 보내며 ③ client_id를 넣을 별도 필드가 없습니다.

지금 이걸 안 해도 되는 이유 — 위 그대로입니다. 발급받아도 쓸 수 없습니다. 국내 문헌은 KCI로, 국가과제는 NTIS로 커버하세요.

그래서 지금 권하는 것 - 국내 문헌은 KCI로 충분히 커버됩니다. ScienceON은 건너뛰세요. - ScienceON 자료가 꼭 필요하면 웹 사이트에서 직접 검색하고 결과를 노트에 붙여넣은 뒤 그 노트를 AI에게 참조시키는 편이 훨씬 빠릅니다. - 향후 플러그인이 토큰 교환을 지원하면 그때 발급받으면 됩니다.

그래도 키를 받아두려면 1. https://scienceon.kisti.re.kr/por/api/intro/about.do 접속 2. 인증키 발급 신청 (회원가입 및 로그인 필요) 버튼 → /por/api/useRequest/useRequestList.do 3. 논문 검색이 목적이면 「논문」 API를 선택합니다. 4. 인증 방식 문서: /por/api/way/guide/tokenGuide.do

비용·승인 — 공공데이터포털 등록 정보 기준 무료 (공공누리 제4유형: 출처표시·상업적이용금지·변경금지). 승인은 개발단계 자동승인 / 운영단계 심의승인 2단계. ⚠️ 소요 기간은 고지되어 있지 않습니다.

Achmage 설정 위치 — Research → ScienceON - ScienceON API key / Approved request URL / Query parameter / Key parameter

실패했을 때 — Approved request URL이 비어 있으면 ScienceON needs the approved request URL from its provider console.이 뜹니다. 토큰이 만료되면 401이 돌아와 scienceon: Authentication or entitlement was rejected.가 표시됩니다.

검증 상태 — ✅ 2026-09-16 기존 문서 URL 404 확인, 현행 URL·토큰 인증 규격·요청 파라미터(client_id·token·searchQuery) 공식 문서에서 확인, Achmage 어댑터 코드 대조 완료 / ⚠️ 승인 소요기간 미확인

B-3. Web of Science Starter (Clarivate)

한 줄 설명 — SCIE/SSCI 국제 학술 색인. 논문이 어느 색인에 등재되어 있는지 확인하는 공식 경로.

이 분들께의 가치 — 두 가지입니다. 첫째, 연구실적 관리. 공무원 연구직은 SCI(E) 등재 여부가 실적 평가에 직결되는데, 그 색인 여부를 공식 데이터로 확인할 수 있습니다. 둘째, 인용 논문의 급(級) 판별. 규제 근거로 쓸 문헌이 어느 수준의 저널인지 빠르게 가늠할 때 유용합니다.

지금 이걸 안 해도 되는 이유 — 문헌을 찾는 일 자체는 A만으로 됩니다. WoS가 추가하는 것은 "이 논문이 SCIE/SSCI에 등재되어 있는가"라는 색인 판정입니다. 실적 정리 시즌이나 저널 급을 따져야 할 때 발급하면 충분합니다.

무엇을 돌려주는가 — 서지정보(제목·저자·저널·연도·DOI·WoS UID) + 초록 또는 저자 키워드(등록된 경우). Free Trial에는 인용 수(times-cited)가 오지 않습니다. 원문도 오지 않습니다. 검색 결과에 나왔다는 것은 "그 색인 범위에서 검색되었다"는 뜻일 뿐, 논문 내용이 옳다거나 그 주장을 지지한다는 뜻이 아닙니다.

💡 소속 기관을 먼저 확인하세요 — 기존 문서에 없는 내용입니다 무료 플랜이 세 가지입니다:

플랜	초당	하루	인용 수(times-cited)	대상
Free Trial	1회	50회	❌ 안 나옴	누구나 (기관 구독 불필요)
Free Institutional Member	5회	5,000회	✅ 나옴	소속 기관이 WoS 구독 중일 때
Free Institutional Integration	5회	20,000회	✅ 나옴	기관 전산 담당자만

소속 기관이 Web of Science를 구독하고 있다면 Free Trial(50회)이 아니라 Institutional Member(5,000회)를 신청할 수 있습니다. 100배 차이이고 인용 수도 함께 옵니다. 도서관·정보자료실에 WoS 구독 여부를 먼저 문의해 보시길 권합니다.

발급 단계 1. https://developer.clarivate.com/ 에서 계정 생성 후 로그인 (기존 Clarivate 계정 있으면 그대로 사용) 2. https://developer.clarivate.com/apis/wos-starter 로 이동 3. Application을 등록합니다. (포털의 모든 API는 application 등록이 전제입니다.) 4. 플랜을 선택해 subscribe 합니다 — 위 표에서 본인에게 맞는 것으로. 5. 이용약관 동의 후 발급된 API key 복사

소요 시간·비용·승인 - 약 10~15분 / 전 플랜 무료 - Free Trial: 즉시 발급 · 개인 가능 · 기관 구독 불필요 (공식 문구: "available to anyone, even if your organization does not subscribe") - Institutional 플랜: 기관 구독 자격 확인 절차 있음. Integration 플랜은 기관 전산 담당자만 승인됩니다.

Achmage 설정 위치 — Research → Web of Science Starter - API key - Default editions — 기본값 WOS+SSCI

Editions 선택 — 이 청중이라면 바꾸세요. 기본값 WOS+SSCI는 사회과학 색인입니다. 식의약 분야는 자연과학이므로 WOS+SCI로 바꾸는 것이 맞습니다. 여러 개를 쓰려면 본인 플랜 권한을 확인하세요.

WOS+SCI    ← 과학 (이 분들께 해당)
WOS+SSCI   ← 사회과학 (기본값)
WOS+AHCI   ← 인문예술
WOS+ESCI   ← 신흥 저널

주의사항 - Free Trial은 하루 50회입니다. Test connection도 1회를 씁니다. Achmage에서 이 소스는 자동 검색(Auto)에서 빼고 @WoS Starter로 직접 지목할 때만 쓰도록 두세요 (기본값이 이미 Explicit @Source only입니다). - 검색어는 WoS의 주제 검색(TS=) 구문으로 변환되어 전송됩니다.

실패했을 때 — 한도를 넘기면 wos: The source quota or rate limit was reached.가 뜹니다. 다음 날까지 기다려야 합니다. 키가 틀렸거나 해당 edition 권한이 없으면 wos: Authentication or entitlement was rejected.입니다 — 이 경우 Default editions를 본인 플랜이 허용하는 값으로 줄여 보세요.

검증 상태 — ✅ 2026-09-16 발급처·3개 플랜·한도·인용수 제공 여부·개인 신청 가능 여부 공식 페이지에서 확인

C. 필요하면 하는 것

C-1. OpenAlex — ⚠️ 기존 문서와 다릅니다

한 줄 설명 — 오픈 학술 그래프. 논문·저자·기관·인용 관계를 무료로 개방한 데이터베이스.

이 분들께의 가치 — 넓게 훑는 발견(discovery) 도구입니다. PubMed가 놓치는 인접 분야 문헌, 특정 연구기관의 논문 목록, 저자의 전체 연구 이력을 볼 때 유용합니다. 국제 규제기관 소속 연구자의 발표 논문을 추적하는 데도 씁니다.

무엇을 돌려주는가 — 서지정보 + 인용 수 + 오픈액세스 여부 + 초록(복원된 경우). 초록은 OpenAlex가 역색인(inverted index) 형태로 저장한 것을 플러그인이 문장으로 되돌리는 방식이라 없거나 불완전할 수 있습니다. 원문은 오지 않습니다.

⚠️ Achmage에서는 키가 필수입니다. OpenAlex 자체는 키 없이도 됩니다 (공식 문서: "you can make basic queries with no key at all"). 그러나 Achmage 1.2.0은 OpenAlex를 키 필수(required)로 구현했습니다. 코드상 키가 없으면 검색 자체가 실패합니다. 즉 쓰려면 키를 받아야 합니다.

발급 단계 1. https://openalex.org/ 에서 계정 생성 (공식 안내상 약 30초) 2. https://openalex.org/settings/api 에서 API key 복사

소요 시간·비용·승인 — 약 2분 / 무료 / 승인 없음 / 개인 가능 / 기관 소속 불필요

호출 한도 (직접 측정한 값)

검색 1회당 10크레딧이 소모되는 것을 응답 헤더로 확인했습니다. 무료 키를 받으면 10배로 늘어납니다. 별도로 초당 100회 제한이 있습니다.

Achmage 설정 위치 — Research → OpenAlex - API key (필수)

주의사항 - 기존 문서의 링크가 이전되었습니다. developers.openalex.org/guides/authentication → 현재는 help.openalex.org/api/authentication/로 리디렉션됩니다. - 개인 키는 로그인 자격증명을 겸합니다. 키를 교체(rotate)하면 다른 브라우저·기기에서 즉시 로그아웃됩니다. - OpenAlex는 공개 발견용 그래프이지 SCIE/Scopus 등재 여부를 판정하는 도구가 아닙니다. 등재 확인은 WoS로 하세요. - 인용 수는 영향력의 한 지표일 뿐 품질 점수가 아닙니다.

실패했을 때 — 예산을 넘기면 openalex: The source quota or rate limit was reached.가 뜹니다. UTC 자정(한국시간 오전 9시)에 초기화됩니다.

검증 상태 — ✅ 2026-09-16 발급 URL·무료 정책 확인, 크레딧 한도를 API 응답 헤더로 직접 측정, Achmage의 키 필수 구현을 코드에서 확인 / ⚠️ openalex.org 본 사이트는 자동화 접근을 차단(403)하므로 브라우저로 접속하세요

C-2. NAVER API HUB (뉴스·웹·블로그 검색)

한 줄 설명 — 네이버 검색 API. 국내 뉴스·웹문서·블로그를 검색합니다.

이 분들께의 가치 — 학술 DB가 못 잡는 영역입니다. 식품·의약품 안전 이슈의 언론 보도 모니터링, 회수·리콜 보도 추적, 특정 성분·제품에 대한 소비자 여론 파악에 씁니다. 다만 발견 단계의 도구이지 사실 확정 근거가 아닙니다.

무엇을 돌려주는가 — 검색 스니펫입니다. 기사 본문이 아닙니다. 제목 · 요약 몇 줄 · 원문 링크 · 보도일이 전부입니다. 제목과 요약만 보고 사실을 확정하면 안 됩니다. 반드시 원문 링크를 열어 확인하세요.

발급 단계 1. https://www.ncloud.com/ 에서 NAVER Cloud Platform 계정 생성 후 콘솔 로그인 2. 콘솔에서 Menu → All Services → Application Services → NAVER API HUB → 신청하기 3. Subscription → [서비스 이용 신청] 4. Application → [Application 등록] 5. 사용할 검색 API를 선택합니다. Achmage가 지원하는 것은 세 가지 — 뉴스(news), 국내 웹문서(webkr), 블로그(blog) 6. Application의 인증 정보에서 Client ID와 Client Secret 확인

소요 시간·비용·승인 - 약 20~30분 (클라우드 계정 생성 포함) - 호출 한도: 하루 25,000회 (검색 API 기준) - 승인: 콘솔 내 신청, 별도 심사 언급 없음 - ⚠️ 비용·결제수단 등록 요건은 공식 문서에 명시되어 있지 않습니다. NAVER Cloud Platform은 클라우드 서비스 계정이므로 가입 과정에서 결제수단 등록을 요구할 수 있습니다. 공공기관 소속으로 개인 카드 등록이 곤란하다면 이 소스는 건너뛰는 편이 낫습니다. 뉴스 모니터링은 네이버에서 직접 검색해도 충분합니다.

Achmage 설정 위치 — Research → NAVER API HUB Search - Client ID / Client Secret - Credential service — 기본 Auto detect (recommended) 유지 - Default search vertical — News / Korean web / Blog - Console daily limit / Console monthly limit (사용량 표시용, 선택)

주의사항 - 예전 NAVER Developers(developers.naver.com)에서 받은 Client ID/Secret은 API HUB에서 쓸 수 없습니다. 공식 이관 가이드가 명시합니다. 새 Application을 등록해야 합니다. (인증 헤더도 X-Naver-Client-Id → X-NCP-APIGW-API-KEY-ID로 바뀌었습니다.) - ⚠️ 기존 문서는 구형 API 지원 종료일을 "2027년 6월 30일"로 적고 있으나, 이번에 공식 이관 가이드에서 해당 날짜를 확인하지 못했습니다. 플러그인 경고 메시지에도 같은 날짜가 들어 있습니다. 날짜 자체는 검증되지 않은 것으로 보시고, 어차피 신규 발급은 API HUB로 하면 됩니다.

실패했을 때 — 헷갈리기 쉬운 함정 네이버는 인증 실패를 errorCode: 200으로 돌려줍니다. HTTP 200(성공)이 아닙니다. 플러그인이 이걸 알아채고 이렇게 표시합니다: naver: NAVER API HUB authentication failed. Provider errorCode 200 is an authentication error, not HTTP 200 success. 이 메시지가 보이면 Client ID/Secret이 같은 Application에서 발급된 한 쌍인지, 그리고 구형 Developers 키를 쓰고 있지 않은지 확인하세요.

검증 상태 — ✅ 2026-09-16 발급 경로·인증 헤더·하루 25,000회 한도·구 키 사용 불가 공식 문서에서 확인 / ⚠️ 요금·결제수단 요건 미확인, 2027-06-30 종료일 미확인

C-3. NTIS (국가R&D 정보)

한 줄 설명 — 과학기술정보통신부의 국가 R&D 과제·성과 정보 시스템.

이 분들께의 가치 — 국가 연구개발 과제 이력 조회. 유사 과제 중복 확인, 선행 국가과제 파악, 기관별 R&D 현황 조사에 씁니다. 연구기획 단계에서 유용합니다.

무엇을 돌려주는가 — 과제 메타데이터(과제명·수행기관·연구기간·과제 ID)와 상세 링크. 보고서 원문은 오지 않습니다.

발급 단계 1. https://www.ntis.go.kr/rndopen/api/mng/apiMain.do 접속 후 로그인 2. ⚠️ 소속기관 등록이 먼저입니다. 회원정보에 소속기관이 없으면 신청 자체가 막힙니다. 경로: 로그인 → 초기화면 프로필 이미지 클릭 → 내정보 → 비밀번호 확인 → 소속기관 등록 3. 목록에서 「국가R&D 과제검색 서비스(전체용)」의 활용신청 4. 성과 정보도 필요하면 「국가R&D 성과검색 서비스(전체용)」를 별도로 신청

제공 API는 8종이며 전부 이용대상이 "대국민"입니다 (과제검색, 성과검색, 수행기관 현황, 연구보고서 검색, 이슈로보는R&D, 용어사전, 표준분류코드, 연관콘텐츠 추천).

소요 시간·비용·승인 - 소속기관 등록 + 신청: 약 15분 - 승인: 자동이 아닙니다. 공식 안내 — "신청자의 소속기관 확인을 거쳐 승인되므로". 서비스별 담당자가 지정되어 있습니다. - ⚠️ 승인 소요 기간·비용은 고지되어 있지 않습니다. 문의: 042-865-1115

이 청중에게는 오히려 유리한 조건입니다. 소속기관 등록이 필수라는 점이 일반인에게는 장벽이지만, 공공 연구기관 소속이라면 그대로 통과합니다.

Achmage 설정 위치 — Research → NTIS - NTIS API key / Approved request URL / Query parameter / Key parameter

주의사항 - 키 하나로 모든 API가 열리지 않습니다. API 상품별로 활용신청이 필요합니다. - 승인 화면에 표시되는 실제 request URL과 파라미터 이름을 그대로 Achmage에 입력해야 합니다. - ⚠️ 기존 문서는 파라미터를 searchWord / apprvKey로 안내하지만 이번에 확인하지 못했습니다. 승인 화면의 값을 기준으로 하세요. - ⚠️ 기존 문서는 IP 등록 가능성을 언급하는데, 이번에 본 안내 페이지에는 IP 관련 내용이 없었습니다. 신청 화면에 IP 항목이 있으면 실제 Obsidian을 쓸 네트워크(사무실 고정 IP 여부)를 확인하세요.

실패했을 때 — Approved request URL 미입력 시 NTIS needs the approved request URL from its provider console.. 승인 전이면 401/403으로 ntis: Authentication or entitlement was rejected.가 뜹니다. 키가 있어도 해당 API 상품이 승인되지 않았으면 이 오류가 납니다.

검증 상태 — ✅ 2026-09-16 발급처·8개 서비스명·로그인/소속기관 필수·심사 승인 방식 확인 / ⚠️ 승인 기간·비용·IP 요건·파라미터명 미확인

C-4. OpenDART (금융감독원 전자공시)

한 줄 설명 — 기업이 제출한 공식 공시 자료.

이 분들께의 가치 — 관련도 낮음. 제약·바이오 기업의 파이프라인·투자·임상 진행을 공시로 확인하는 정도입니다. 산업 동향 보고서를 쓸 일이 있을 때만 고려하세요.

무엇을 돌려주는가 — 공시 목록 메타데이터(회사명·보고서명·접수일·제출인)와 DART 원문 링크. 공시 본문은 오지 않습니다.

발급 단계 1. https://opendart.fss.or.kr/ 접속, 개인 회원가입 후 로그인 2. 인증키 신청/관리 → 인증키 신청 3. 사용환경·용도 작성, 약관 동의 4. 발급된 인증키 확인

소요 시간·비용·승인 — 약 10분 / 무료 / 개인 가능 / ⚠️ 승인 방식·한도 미확인

Achmage 설정 위치 — Research → OpenDART → OpenDART API key

주의사항 — Achmage 1.2.0에는 회사명으로 corp_code를 찾아주는 기능이 없습니다. 8자리 corp_code를 질문에 직접 넣어야 정확히 검색됩니다. 회사명만 넣으면 최근 1년 공시 목록에서 이름을 필터링하는 수준이라 놓치는 것이 많습니다.

검증 상태 — ✅ 2026-09-16 발급처 URL 접속 확인. 검색 동작은 코드에서 확인 / ⚠️ 승인 방식·한도 미확인

C-5. KOSIS (국가통계포털) — 키 불필요

한 줄 설명 — 통계청 국가통계 조회. MCP 방식이라 연결 절차가 다릅니다.

이 분들께의 가치 — 보건·인구·식품 소비 관련 공식 통계를 표 ID와 함께 인용할 때. 보고서에 수치를 넣을 때 출처가 명확해집니다.

무엇을 돌려주는가 — 통계표의 수치·단위·통계표 ID·KOSIS 원문 URL. 해석이나 분석은 오지 않습니다.

발급 단계 — 키가 없습니다. 다만 MCP라 설치 절차가 한 단계 더 있습니다. 1. Research 탭에서 KOSIS 카드를 펼치고 토글을 켭니다. 2. Install MCP preset 클릭 3. 상단 MCP 탭으로 이동 4. Connect and scan tools 클릭 5. 도구 목록과 권한(read/write)을 검토하고 승인

소요 시간·비용·승인 — 약 5분 / 무료 / 승인 없음

Achmage 설정 위치 — Research → KOSIS MCP (입력 필드 없음) → 이후 MCP 탭

주의사항 - ⚠️ 이 MCP 서버는 통계청 공식 서버가 아니라 공개 파일럿 운영자(kosismcp2026.vercel.app)입니다. 조회하는 데이터는 KOSIS 공식 통계지만, 중계 서버의 가용성·운영 정책은 바뀔 수 있습니다. - MCP는 사이드 채팅에서만 동작합니다. 인라인 편집에서는 호출되지 않습니다. - 도구 수가 많으므로 자동 선택보다 @KOSIS MCP로 직접 지목하는 편이 안전합니다. - 조사 기준이 다른 통계표를 직접 비교하지 마세요. 단위와 기준이 다르면 숫자만 같아 보여도 의미가 다릅니다.

실패했을 때 — MCP는 메시지가 다릅니다. 프리셋 설치 전이면 Install the curated MCP preset first., 설치 후에는 MCP preset is installed. Use Connect and scan tools in the MCP tab to verify the live endpoint.가 뜹니다. 후자는 "설치됐다"는 뜻이지 "연결됐다"는 뜻이 아닙니다. 반드시 MCP 탭에서 Connect and scan tools까지 하세요.

검증 상태 — ✅ 2026-09-16 MCP 서버에 직접 접속해 응답 확인 (initialize 성공, KOSIS 통계 조회 서버로 자기 식별)

D. 기존 안내 문서(2026-07-27)와 달라진 점

강의에서 배포된 기존 문서를 이미 보신 분들을 위한 정오표입니다.

E. 3단 요약

🟢 오늘 당장 되는 것 — 가입도 키도 없음 (10분)

이 셋만으로도 문헌 검색과 인용 검증의 큰 축은 완성됩니다. 강의 끝나고 바로 이것부터 하세요.

🟡 이번 주에 발급할 것 — 이 업무에 값어치가 있음

⚪ 필요하면 하는 것

F. 마지막으로 — 이것만은 기억하세요

1. 검색되었다 ≠ 사실이다. 이 도구들은 근거 후보를 찾아줄 뿐입니다. 색인에 있다는 것, 동료심사를 거쳤다는 것, 원문이 그 주장을 지지한다는 것은 서로 다른 세 가지입니다.
2. "원문을 읽어보니"는 거의 항상 과장입니다. 초록까지 오는 곳은 Europe PMC와 일부 소스뿐이고, 원문 전체를 가져오는 소스는 하나도 없습니다. PubMed는 초록조차 오지 않습니다.
3. 규제 판단에 쓸 인용은 반드시 원문에서 다시 확인하세요. 특히 Crossref로 철회 여부를 한 번 걸러내는 습관을 권합니다.
4. 비공개 자료를 검색어로 보내지 마세요. 검색어는 외부 서버로 전송됩니다.
5. 키는 절대 노트·채팅·스크린샷·메일에 적지 마세요. Obsidian 설정 화면에만 입력합니다.
6. 정책은 바뀝니다. 이 문서의 한도·요금·승인 방식은 2026-09-16 기준입니다. 실제 발급 화면의 안내가 언제나 최종 기준입니다.