LabArchives 연동 (labarchive-integration)
LabArchives 전자실험노트(ELN) API와 Inventory v1 API를 안전하게 연동하도록 서명·지역 엔드포인트·검증 절차를 안내하는 스킬입니다.
웹·API 연동고급★ 33,030⑂ 3,248AI 점수 7/10마지막 업데이트: 2026. 8. 9.
무엇을 해주나
- LabArchives의 두 가지 인터페이스(레거시 ELN REST-like API, Inventory API v1)를 혼용하지 않도록 구분해 주고, 각각의 경로·응답 형식·인증 방식을 정리합니다.
- HMAC-SHA-512 서명 생성 절차(ELN은
akid+메서드명+expires쿼리 서명, Inventory는 상대 경로 서명 +X-LabArchives-*헤더)를 단계별로 알려줍니다. - 지역별 API 호스트 허용 목록을 확인하고, 브라우저 로그인 URL로 API URL을 만드는 흔한 실수를 막아줍니다.
- 네트워크 호출 없이 요청 계획(dry-run JSON)을 만들어 주는 로컬 스크립트와, LA 컨테이너(ZIP) 안전 점검 도구를 포함합니다.
- 자격증명 취급 규칙(환경변수만 사용,
.env미사용, 쿼리스트링·헤더 로그 금지)과 재시도·속도 제한 등 운영 규칙을 강제합니다.
이런 분께 추천
- 대학·연구소에서 LabArchives ELN 데이터를 자동 수집·백업하려는 연구 데이터 엔지니어
- Inventory API로 시약·재고·주문 데이터를 사내 시스템과 연결해야 하는 랩 매니저/개발자
- 실험 기록 시스템 연동 시 보안 검토 기준이 필요한 IT·정보보호 담당자
활용 예시
- "우리 기관 ELN API 엔드포인트가 올바른지 확인해줘" →
setup_config.py regions및check --require-user-id로 지역 URL 형식과 필수 환경변수 존재 여부를 검증. - "
entries/entry_info호출 계획을 먼저 보여줘" →entry_operations.py eln-plan으로 민감값이 가려진 요청 계획을 받아 검토 후 실제 코드 작성. - "내려받은
example_lacontainer.zip이 정상 LA 컨테이너인지 봐줘" →notebook_operations.py inspect로 압축을 풀지 않고 매니페스트 참조와 위험 경로를 점검하고 JSON 리포트 저장.
· · · 설치 가이드 · · ·
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 K-Dense-AI/scientific-agent-skills 의 skills/labarchive-integration 폴더를 내 ~/.claude/skills/labarchive-integration/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/K-Dense-AI/scientific-agent-skills.git && mkdir -p ~/.claude/skills && cp -r scientific-agent-skills/skills/labarchive-integration ~/.claude/skills/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 터미널을 열고 Python 3.11 이상과
uv가 설치돼 있는지 확인합니다. (python3 --version,uv --version) - 저장소를 클론합니다:
git clone https://github.com/K-Dense-AI/scientific-agent-skills.git - 스킬 폴더를 Claude 스킬 경로로 복사합니다:
mkdir -p ~/.claude/skills && cp -r scientific-agent-skills/skills/labarchive-integration ~/.claude/skills/ - LabArchives에서 발급받은 값을 환경변수로 설정합니다:
export LABARCHIVES_ELN_API_URL=...,export LABARCHIVES_ACCESS_KEY_ID=...,export LABARCHIVES_ACCESS_PASSWORD=...(필요 시LABARCHIVES_USER_ID,LABARCHIVES_INVENTORY_LAB_ID). 비밀값은 코드나.env에 저장하지 마세요. - 스킬 디렉터리로 이동해
uv run scripts/setup_config.py check --require-user-id로 설정을 점검합니다. - Claude Code를 다시 시작하고 "LabArchives ELN API 연동을 도와줘"처럼 요청하면 스킬이 활성화됩니다.
GitHub에서 원본 보기 ↗라이선스: MIT