Pyzotero — Zotero 라이브러리 자동화
Claude가 pyzotero로 Zotero 문헌 라이브러리를 검색·생성·수정하고 BibTeX까지 내보내게 해주는 스킬입니다.
웹·API 연동중급★ 33,030⑂ 3,248AI 점수 8/10마지막 업데이트: 2026. 8. 9.
무엇을 해주나
Zotero Web API v3를 감싼 파이썬 클라이언트 pyzotero를 Claude가 능숙하게 다루도록 안내하는 스킬입니다. 항목(item)·컬렉션·태그·첨부파일의 조회와 생성/수정/삭제, 검색 파라미터, 페이지네이션(everything()), 전문(full-text) 색인 접근, BibTeX·CSL-JSON 내보내기까지 다룹니다. 인증 설정, 오류 처리, Zotero 7 로컬 API(CLI·MCP) 사용법이 14개의 참조 문서로 분리돼 있어 필요한 부분만 불러 읽습니다.
이런 분께 추천
- 논문·리서치 참고문헌을 Zotero로 관리하며 반복 작업을 자동화하고 싶은 연구자·대학원생
- 문헌 리뷰 파이프라인이나 서지 데이터 수집 스크립트를 만드는 개발자
- 팀 그룹 라이브러리에 PDF와 메타데이터를 대량으로 정리해 넣어야 하는 연구실 운영자
활용 예시
- "내 Zotero에서 'machine learning' 키워드가 들어간 항목 50개를 뽑아 연도순으로 정리한 표를 만들어줘" →
zot.items(q=...)+ 정렬 파라미터로 조회 후 마크다운 표 생성. - "이 논문 목록을 journalArticle 템플릿으로 새 컬렉션에 등록하고 PDF를 첨부해줘" →
item_template()→create_items()→ 첨부 업로드 순서로 처리. - "제출용 참고문헌을 BibTeX 파일로 내보내줘" →
add_parameters(format='bibtex')로 상위 항목을 받아 .bib 파일로 저장.
· · · 설치 가이드 · · ·
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 K-Dense-AI/scientific-agent-skills 의 skills/pyzotero 폴더를 내 ~/.claude/skills/pyzotero/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/K-Dense-AI/scientific-agent-skills.git && mkdir -p ~/.claude/skills && cp -r scientific-agent-skills/skills/pyzotero ~/.claude/skills/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 터미널을 열고 스킬 저장소를 클론합니다:
git clone https://github.com/K-Dense-AI/scientific-agent-skills.git - 스킬 폴더를 Claude Code 스킬 경로로 복사합니다:
mkdir -p ~/.claude/skills && cp -r scientific-agent-skills/skills/pyzotero ~/.claude/skills/ - 파이썬 3.10 이상이 설치돼 있는지 확인하고 라이브러리를 설치합니다:
uv add pyzotero(또는pip install pyzotero). - https://www.zotero.org/settings/keys 에서 userID를 확인하고 새 API 키를 발급받습니다.
- 작업 폴더에
.env파일을 만들어ZOTERO_LIBRARY_ID,ZOTERO_API_KEY,ZOTERO_LIBRARY_TYPE=user(그룹이면group)를 적어 둡니다. 이 파일은 절대 깃에 커밋하지 마세요. - Claude Code를 재시작한 뒤 "Zotero 라이브러리에서 최근 항목 10개 보여줘"처럼 요청하면 스킬이 자동으로 실행됩니다.
- 삭제·수정 명령은 실제 라이브러리에 반영되므로, 처음에는 테스트용 그룹 라이브러리에서 확인하는 것을 권장합니다.
GitHub에서 원본 보기 ↗라이선스: MIT