Adaptyv 바이오 파운드리 API
단백질 서열을 클라우드 실험실 Adaptyv에 제출하고 결합·열안정성 결과를 받아오는 API/SDK 사용 가이드 스킬.
웹·API 연동중급★ 33,030⑂ 3,248AI 점수 8/10마지막 업데이트: 2026. 8. 9.
무엇을 해주나
Adaptyv Bio는 아미노산 서열을 넣으면 자동화 실험실이 실제 assay를 돌려 약 21일 안에 데이터를 돌려주는 '클라우드 랩'입니다. 이 스킬은 Claude가 Adaptyv Foundry API와 Python SDK(adaptyv-sdk)를 정확하게 다루도록 다음 지식을 제공합니다.
- 인증 방식(Bearer 토큰,
ADAPTYV_API_KEY환경변수 /.env사용, 하드코딩 금지 원칙) @lab.experiment데코레이터 패턴과FoundryClient클라이언트 패턴 코드- 실험 유형 표(affinity, screening, thermostability, expression, fluorescence)와 필요한 method(BLI/SPR)
- Draft → QuoteSent → InProduction → Done 등 실험 상태 라이프사이클과 각 단계에서 누가 행동해야 하는지
- 서열 표기 형식(단순/리치/다중 사슬), 목록 API의 페이지네이션·s-expression 필터·정렬 문법
- 에러 응답의
request_id활용법, Biscuit 기반 토큰 축소(attenuate)·폐기 방법
이런 분께 추천
- 단백질 설계(de novo binder, 항체/scFv 등) 결과를 실제 실험으로 검증하려는 연구자
- AI 단백질 설계 파이프라인 뒤에 자동 실험 제출 단계를 붙이고 싶은 ML 엔지니어
- Adaptyv Foundry 계정을 이미 보유하고 API로 실험을 대량 관리해야 하는 팀
활용 예시
- "EGFR 타깃으로 내 binder 후보 20개를 BLI 스크리닝으로 제출하고 비용 견적부터 보여줘" → 타깃 검색 →
cost_estimate→create(Draft) →submit흐름을 코드로 생성. - "설계 스크립트에 자동 실험 제출을 붙여줘" →
skip_draft,auto_accept_quote,webhook_url을 사용한 무인 파이프라인 코드 작성. - "올해 완료된 실험만 최신순으로 뽑아줘" →
filter=and(gte(created_at,2026-01-01),eq(status,done))&sort=desc(created_at)형태의 쿼리 작성 및 결과 조회.
· · · 설치 가이드 · · ·
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 K-Dense-AI/scientific-agent-skills 의 skills/adaptyv 폴더를 내 ~/.claude/skills/adaptyv/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/K-Dense-AI/scientific-agent-skills.git /tmp/scientific-agent-skills && mkdir -p ~/.claude/skills && cp -r /tmp/scientific-agent-skills/skills/adaptyv ~/.claude/skills/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 터미널을 열고 저장소를 내려받습니다:
git clone https://github.com/K-Dense-AI/scientific-agent-skills.git - 스킬 폴더를 Claude 스킬 디렉터리로 복사합니다:
mkdir -p ~/.claude/skills && cp -r scientific-agent-skills/skills/adaptyv ~/.claude/skills/ references/api-endpoints.md파일이 함께 복사되었는지 확인합니다(전체 32개 엔드포인트 문서).- foundry.adaptyvbio.com 사이드바에서 API 키를 발급받습니다.
- 프로젝트 루트에
.env파일을 만들고ADAPTYV_API_KEY=발급받은키를 넣습니다..gitignore에.env를 추가하세요. - Python 3.10 이상 환경에서 SDK를 설치합니다:
uv pip install "git+https://github.com/adaptyvbio/adaptyv-sdk.git" - Claude Code를 재시작하고 "Adaptyv로 EGFR 결합 스크리닝 실험을 만들어줘"처럼 요청하면 스킬이 자동으로 활성화됩니다.
GitHub에서 원본 보기 ↗라이선스: MIT