Nature 문헌 다운로더
이 스킬은 합법적인 오픈 액세스, 출판사 API, CNKI 기관, 브라우저 기반 기관 공급자를 통해 문헌을 라우팅합니다. scripts/batch_download.mjs가 오케스트레이션 진입점이며, 학교 구성, 출판사 자격 증명, 메타데이터/OA 해결, 공급자 다운로드, 콘텐츠 검증, 매니페스트는 별도 모듈입니다.
검증된 경로는 예시일 뿐, 기본값이 아닙니다. 모든 기관은 사용자의 실제 도서관 리소스 URL에서 시작해야 합니다. 리소스 포털, CAS 콜백, EZproxy, WebVPN, IP 인증 데이터베이스 페이지, 데이터베이스 상세 페이지는 학교 이름보다 실제 승인 경로를 더 안정적으로 드러내기 때문입니다.
SI 확인 게이트 — 먼저 수행하세요. PDF, CAJ, HTML, XML, 아카이브 또는 첨부 파일을 다운로드하기 전에 사용자에게 지원 정보(Supporting Information)를 원하는지 물어보세요. SI에 대한 명시적 요청은 '예', 본문만 요청하는 것은 '아니오'로 간주합니다. 그렇지 않으면 전체 배치에 대해 한 번 물어보세요.
--si또는--no-si중 정확히 하나를 사용하여 다운로더를 실행하세요. 두 플래그 중 어느 것도 없으면 스크립트는si_confirmation_required를 반환하고 출력 디렉터리를 생성하지 않습니다.
주 워크플로. 라우팅 전에 DOI/제목을 정규화하고 언어와 출판사를 식별하세요. 중국어 문헌은 항상 CNKI를 사용합니다. 영어 Elsevier, Springer Nature, IEEE 기사 중 사용 가능한 공급자 자격 증명이 있는 경우 출판사 API를 먼저 시도하고 API 다운로드 성공 후 OA 확인을 요구하지 마세요. 해당 API 시도가 실패하면 자동으로 합법적인 OA 소스를 확인하세요. 다른 영어 출판사는 OA를 먼저 확인하고, OA를 사용할 수 없으면 기관 웹 접근 경로를 사용하세요.
정규화된 DOI/제목 및 언어/출판사 식별
├─ 중국어 문헌: 직접 CNKI로 이동
└─ 영어 문헌
├─ Elsevier / Springer Nature / IEEE, 유효한 키가 구성된 경우
│ ├─ 출판사 API를 통해 우선 다운로드
│ ├─ API 다운로드 성공: 종료, OA 확인 강제하지 않음
│ └─ API 다운로드 실패: 기사 수준 OA 확인 후 PMC / Unpaywall / 합법적 리포지토리로 이동
└─ 기타 출판사
├─ 기사 수준 OA 확인
└─ OA 사용 불가: Web Access 기관 승인으로 이동
중국어 문헌은 CNKI 전용입니다. 중국어 제목,
zh메타데이터 언어, 명시적 CNKI 소스 URL 또는--route cnki는 다른 OA 복사본이 있는 것처럼 보여도 CNKI를 사용해야 합니다. 사용자의 현재 Chrome 라이브러리/CNKI 로그인 상태를 재사용하고 구성된discovery.cnki_url을 선호하세요. 쿠키를 내보내거나 기관 비밀번호를 수집하지 마세요.
출판사 API 폴백. 유효한 API 키가 전체 텍스트 이용 자격을 보장하지는 않습니다. Elsevier, Springer Nature 또는 IEEE API 시도가 이용 자격이나 사용 가능한 전체 텍스트를 반환하지 않으면 먼저 합법적인 OA 소스를 자동으로 시도하세요. 출판사 API와 OA 경로 모두 실패한 후에만
api_fallback_confirmation_required를 반환하고 Web Access 사용 여부를 한 번 물어보세요. 기관 Web Access로 자동 전환하지 마세요.
브라우저 상태 원칙. 승인된 다운로드는 사용자가 로그인한 정확한 브라우저 프로필에 따라 달라집니다. 프록시, CDP 세션 또는 브라우저 자동화 도구가 새 프로필이나 로그인 상태가 없는 다른 브라우저를 열면 실패를 라이브러리 권한 부족으로 처리하지 마세요. 사용자의 활성 브라우저 세션을 재사용하는 제어 경로로 전환하거나 사용자에게 제어된 브라우저 인스턴스에서 인증하도록 요청하세요.
형식 원칙. PDF, HTML 전체 텍스트 및 CAJ와 같은 데이터베이스 고유 형식은 서로 다른 결과물입니다. 사용자가 PDF만 요청하는 경우 실제 PDF 링크 또는
no_authorized_pdf_found/pdf_fetch_failed를 보고하세요. CAJ, HTML 또는 로그인 페이지를 PDF처럼 저장하지 마세요.
다운로드 수신 및 첫 실행 구성
모든 다운로드 요청에 대해 먼저 논문 목록을 확인하고 다음을 물어보세요:
이 논문들의 Supporting Information(SI, 보충 자료)도 함께 다운로드하시겠습니까?
이 질문을 하기 전에 메타데이터 조회는 요청된 논문을 식별하는 데 필요한 경우에만 수행하세요. 답변을 알기 전까지 파일을 다운로드하지 마세요. 선택한 경로가 CNKI 또는 Web Access인 경우에만 라이브러리를 구성하세요. 선택한 영어 기사가 Elsevier, Springer Nature 또는 IEEE에 속하는 경우에만 출판사 API를 구성하고, 구성된 공급자 API를 시도하기 전에 OA 결정은 필요하지 않습니다.
유료 도서관 리소스 구성
사용자가 실제로 사용하는 도서관 리소스 URL을 물어보세요:
평소에 도서관 전자자원/데이터베이스에 접속할 때 사용하는 플랫폼 링크를 보내주세요.
리소스 포털, 데이터베이스 목록, Web of Science 입구, 특정 데이터베이스 상세 페이지,
또는 통합 인증 로그인 링크일 수 있습니다.
그런 다음 URL에서 승인 경로를 추론하여 구성을 저장하세요:
python3 scripts/configure_school.py infer "https://example.edu/library/resources"
python3 scripts/configure_school.py url "https://example.edu/library/resources"
python3 scripts/configure_school.py show
python3 scripts/configure_school.py health --force
배포된 스킬에는 학교 사전 설정이 포함되어 있지 않습니다. 사용자가 리소스 URL을 제공할 수 없는 경우, 학교별 도메인을 추측하는 대신 기관의 도서관/데이터베이스 항목을 찾도록 요청하세요.
기본 구성 경로는 다음과 같습니다:
~/.config/lit-dl/school.json
테스트 또는 격리된 프로필의 경우 다음을 설정하세요:
LIT_DL_CONFIG_DIR=/path/to/configdir
다운로더는 이 구성을 자동으로 읽습니다. discovery.web_of_science_url이 있으면 scripts/batch_download.mjs는 이를 Web of Science 진입점으로 사용하고, 그렇지 않으면 https://www.webofscience.com/wos/woscc/basic-search로 폴백합니다.
중국어 문헌의 경우 다운로더는 discovery.cnki_url이 있으면 이를 읽습니다. 없으면 scripts/batch_download.mjs --title "<중국어 제목>"은 https://kns.cnki.net/kns8s/defaultresult/index로 폴백합니다.
고정 출판사 API 온보딩 출력
도서관 리소스 URL이 저장, 표시되고 상태 확인을 통과한 직후, 다음 Markdown 블록을 정확히 출력하세요. URL을 검색 결과로 대체하지 말고, IEEE 경고를 줄이지 말며, 사용자에게 API 키를 채팅에 붙여넣도록 요청하지 마세요.
장기적이고 안정적인 다운로드를 위해 다음 출판사를 구성하세요:
Elsevier API Key (필수 구성)
[https://dev.elsevier.com/apikey/manage](https://dev.elsevier.com/apikey/manage)
Website URL 입력: [Yuan1z0825/nature-skills](https://github.com/Yuan1z0825/nature-skills)
Springer Nature Developer Portal (권장 구성)
https://dev.springernature.com/#api
아래로 스크롤하여 **Subscribe now** - "free"를 차례로 클릭하세요.
IEEE Developer Registration (필요 시)
[https://developer.ieee.org/member/register](https://developer.ieee.org/member/register)
로그인/등록 및 "학교 이메일" 인증을 완료한 후 API Management 페이지로 이동하여 API Key를 복사하세요. IEEE 일반 키는 Metadata API에만 사용되며, 전체 텍스트 접근을 위해서는 Full-Text Access를 별도로 신청해야 합니다.
이 블록을 표시한 후 중단하고 사용자가 등록, 학교 이메일 인증, 관련 API 키 복사를 완료할 때까지 기다리세요. 사용자는 모든 비밀번호, CAPTCHA, OTP, 이메일 확인, 동의, API 키 복사 단계를 직접 수행합니다. 브라우저 페이지에서 API 키를 읽거나 사용자에게 채팅으로 보내도록 요청하지 마세요.
API 우선 및 오픈 액세스 폴백
영어 기사의 경우, 기사 수준 OA를 해결하기 전에 출판사를 식별하세요:
-
DOI, PMID, 정확한 제목, 기사 URL 또는 확정된 논문 목록을 수집한 다음 메타데이터와 출판사를 정규화합니다.
-
Elsevier, Springer Nature 또는 IEEE에 속하고 사용 가능한 공급자 자격 증명이 구성된 경우 해당 출판사 API를 먼저 시도합니다. 성공하면
accessMode: publisher_api및oa_status: not_checked_api_first를 기록하고, 기사에 레이블을 지정하기 위해 OA 해결을 실행하지 않습니다. -
출판사 API가 실패하면 PMC, Unpaywall, 출판사 OA 페이지, arXiv 및 기타 합법적 리포지토리 또는 명확한 오픈 PDF URL과 같은 합법적 OA 소스를 자동으로 검색합니다.
-
다른 모든 영어 출판사의 경우 Web Access 전에 합법적 OA 소스를 검색합니다.
-
정확한 제목 또는 명시적 OA 전용 요청의 경우 다음을 선호하세요:
node scripts/batch_download.mjs --title "<정확한 제목>" --open-access --no-si --out "<프로젝트>"사용자가 알려진 합법적 OA PDF URL을 제공하는 경우
--pdf-url을 사용하세요. -
다운로드한 파일을 확인하고 출처를 기록하세요. 성공적인 PDF는
open_access_downloaded로 표시하세요. -
합법적 OA 전체 텍스트를 찾을 수 없으면
oa_not_found로 표시하세요. API가 이미 실패한 지원 출판사의 경우 Web Access 전에 확인을 요청하세요. 다른 출판사의 경우 Web Access를 계속 진행하세요.--route open_access가 명시적으로 요청된 경우 OA 결과 후 중단하세요.
출판사 API 자격 증명
고정 출판사 온보딩 블록 이후에만 사용자가 API 키를 얻은 공급자를 구성하세요. 사용자가 로컬 숨김 프롬프트를 통해 각 키를 입력하도록 하세요:
python3 scripts/configure_credentials.py set elsevier
python3 scripts/configure_credentials.py set springer_nature
python3 scripts/configure_credentials.py set ieee --fulltext-endpoint 'https://issued-endpoint.example/articles/{doi}'
python3 scripts/configure_credentials.py show
python3 scripts/configure_credentials.py validate <provider>
python3 scripts/configure_credentials.py delete <provider>
python3 scripts/configure_credentials.py contact-email [email protected]
위 고정 온보딩 블록의 등록 URL만 사용하세요. 사용자가 로컬 숨김 프롬프트를 통해 각 키를 입력하도록 하고, 절대 에코하지 말거나 매니페스트에 배치하지 마세요. IEEE Metadata API 접근은 유료 전체 텍스트 접근이 아닙니다. IEEE를 API를 통해 다운로드 가능한 것으로 처리하려면 발급된 Full-Text Access 엔드포인트/템플릿이 필요합니다. 비밀은 ~/.config/lit-dl/credentials.json에 모드 0600으로 저장됩니다.
리소스 URL 분류
접근 경로를 선택하기 전에 사용자가 제공한 URL을 분류하세요:
cas.* / /authserver/login CAS / SSO 로그인 페이지; service= 콜백을 검사한 후 서비스 포털로 돌아가기
idp/shibboleth / carsi CARSI / Shibboleth 기관 경로
ezproxy / libproxy EZproxy 원격 접근 프록시
webvpn / vpn WebVPN 경로
metaersp / metaauth / uas 도서관 리소스 집계 포털
webofscience / sciencedirect 데이터베이스 또는 출판사 진입점; 포털을 통해 도달했는지 확인
URL이 service= 매개변수가 있는 로그인 페이지인 경우, 콜백 호스트를 리소스 서비스로 처리하고 로그인 페이지를 전체 워크플로로 만들지 마세요. 예를 들어, https://login.university.example/authserver/login?service=https://resources.university.example/callback은 인증 후 ID 서비스가 사용자의 리소스 포털로 돌아간다는 것을 의미합니다.
기관별 도메인
사용자의 주소 표시줄에 실제로 나타나는 내용과 대조하여 확인하고, 사전 설정이 완전하다고 가정하지 말고 각 기관에 맞게 수정하세요.
도서관 홈 / 집계: library.example.edu, resources.example.edu
디스커버리/데이터베이스 진입점: webofscience.com, clarivate.com, cnki.net, sciencedirect.com, provider.example.com
통합 ID / SSO: sso.example.edu, cas.example.edu, idp.example.edu
연합 / WAYF: ds.carsi.edu.cn, wayf.example.org, shibboleth/openathens 호스트
프록시 / WebVPN: ezproxy.example.edu, webvpn.example.edu
구성된 기관 로그인, 연합, 프록시 및 데이터베이스 로그인 호스트를 로그인 단계로 처리하세요. 이들에 도달하는 것을 최종 실패로 처리하지 마세요.
경계
사용자의 합법적 기관 접근만 사용하세요. 페이월, DRM 또는 이중 인증을 우회하지 마세요.
검증 우선 규칙: 사용자의 인증된 Chrome 세션에 보이는 슬라이더, 체크박스, 로봇 확인 또는 간단한 검증 컨트롤이 나타나면 사용자에게 개입을 요청하기 전에 브라우저에서 시도하세요. 시도를 제한하고(한 탭에서 최대 두 번), 챌린지가 사라졌는지 확인하고, 성공하면 동일한 탭에서 계속 진행하세요.
- 슬라이더/드래그 챌린지(CNKI 퍼즐 슬라이더 포함): 보이는 이동 거리를 추정하고 점진적인 드래그를 시뮬레이션하세요.
- ScienceDirect 로봇 확인, 관리형 Turnstile 및 reCAPTCHA 체크박스 단계: 보이는 체크박스를 한 번 시도하세요.
- 간단한
Continue,Verify또는 이에 상응하는 보이는 컨트롤: 한 번 클릭한 다음 페이지 상태를 다시 확인하세요.
사용자 전환: 제한된 시도가 실패한 후에만 사용자에게 요청하거나, 페이지에 이미지 선택 답변, QR 승인, SMS/OTP, 패스키, 하드웨어 키 또는 이중 인증과 같은 비밀 또는 신원 정보 입력이 필요한 경우 즉시 요청하세요. 챌린지가 있는 탭을 열어 두고 사용자에게 채팅에 자격 증명이나 코드를 붙여넣도록 요청하지 마세요.
무제한 또는 무차별 다운로드를 피하세요. 사용자가 확인한 특정 논문 목록만 처리하고, 공급자 친화적인 속도를 적용하며, 무엇을, 어디서, 지원 정보가 발견되었는지에 대한 명확한 감사 추적을 남기세요.
사용자에게 기관 비밀번호, 데이터베이스 비밀번호, OTP 코드, 복구 코드 또는 세션 토큰을 채팅이나 터미널에 붙여넣도록 요청하지 마세요. 사용자가 비밀번호를 제공하는 경우 거절하고 대신 핸드오프 로그인 워크플로를 사용하세요.
저장된 기관 로그인 페이지 예외: 사용자가 브라우저에 자격 증명을 이미 입력했고 보이는 로그인/확인 버튼을 클릭하도록 승인한다고 명시적으로 말하는 경우, 에이전트는 해당 버튼을 예상되는 기관 SSO / CAS / CARSI / Shibboleth 페이지에서 자격 증명을 읽거나 복사하거나 입력하지 않고 한 번 클릭할 수 있습니다. 이 예외는 CAPTCHA, QR 로그인, SMS/OTP, 출판사 봇 확인, 동의/보안 경고 또는 예상되는 기관 로그인 흐름 외부의 모든 페이지에는 적용되지 않습니다.
쿠키, 비밀번호, 로컬 저장소, 브라우저 프로필 또는 세션 파일을 검사하거나 내보내지 마세요. 브라우저의 이미 인증된 페이지 컨텍스트만 사용하세요.
전제 조건
다운로드를 시도하기 전에 선택한 접근 분기에 적용되는 조건을 확인하세요.
OA 전용 분기의 경우 대상 논문 식별자/목록, 출력 폴더, Node.js 22+ 및 PDF 확인에 필요한 경우 Python 3을 확인하세요. 라이브러리 구성이나 기관 브라우저 로그인이 필요하지 않습니다.
유료 도서관 분기의 경우 다음 조건을 확인하세요:
- 사용자의 라이브러리/데이터베이스 로그인 상태를 보유한 브라우저가 사용자 컴퓨터에서 열려 있어야 합니다.
- 학교 구성이 존재하고 유효해야 합니다.
python3 scripts/configure_school.py show를 실행하세요.- 없으면
python3 scripts/configure_school.py preset "<학교 이름>"을 실행하거나 사용자를src/wizard.py로 안내하세요.
- 사용자가 기관에 직접 로그인해야 합니다.
이하는 원본이 잘렸으나 번역은 완료되었습니다.