Adaptyv Bio Foundry API 연동

Adaptyv 클라우드 실험실 API로 단백질 실험을 설계·견적·제출하고 결과까지 안전하게 회수하도록 돕는 스킬입니다.

웹·API 연동고급★ 56,496⑂ 4,969AI 점수 8/10마지막 업데이트: 2026. 11. 2.

무엇을 해주나

Adaptyv Foundry REST API와 Python SDK(adaptyv, FoundryClient) 사용법을 실제 검증된 스키마 기준으로 안내합니다.
타깃 카탈로그 조회 → 비용 견적 → 드래프트 생성 → 제출 → 견적 확정 → 결과 수집까지 전체 흐름을 코드와 함께 제시합니다.
실험 유형별(친화도, 스크리닝, 열안정성, 발현, 형광, 에피토프 비닝, 효소 활성) 필수/금지 필드와 반복 수 제한을 표로 정리합니다.
상태 전이(draft → ... → done), results_status 확인, 페이지네이션, 필터/정렬 문법, 오류 처리와 x-request-id 기록 방법을 다룹니다.
웹훅 서명(HMAC-SHA256) 검증, 중복 제거, 재시도 정책, 토큰 권한 범위와 revoke 주의사항을 설명합니다.

이런 분께 추천

Adaptyv Foundry로 단백질 바인더·효소를 실제 측정 데이터로 검증하는 연구자·바이오 엔지니어
단백질 설계 파이프라인을 자동화하려는 컴퓨테이셔널 바이올로지스트 / MLE
실험 제출과 과금이 걸린 API를 안전하게 래핑해야 하는 개발자

활용 예시

"EGFR 타깃으로 후보 서열 24개를 BLI 스크리닝 견적 내줘" → 카탈로그 검색 후 cost_estimate로 총액(센트, VAT 제외) 확인.
"드래프트를 제출하고 견적서 URL 받아줘" → submit → 비동기 get_quote 폴링 → confirm_quote로 인보이스 URL 획득.
"완료된 실험 결과를 필드 누락 없이 JSON으로 저장해줘" → SDK 모델 대신 REST로 전체 페이지를 순회해 foundry-results.json 아카이브.

· · · 설치 가이드 · · ·

설치 없이 지금 한 번 써보기

아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.

이 파일의 지시를 읽고 그대로 따라서 나를 도와줘:
https://raw.githubusercontent.com/K-Dense-AI/scientific-agent-skills/HEAD/skills/adaptyv/SKILL.md

내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)

Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.

↓ 쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.

Claude 앱에 설치 (터미널 필요 없음)

아래 버튼으로 ZIP 파일을 받으세요.
Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.

↓ ZIP 내려받기

Claude Code에 설치

Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요

AI 스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 K-Dense-AI/scientific-agent-skills 의 skills/adaptyv 폴더를 내 ~/.claude/skills/adaptyv/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.

직접 명령으로 설치하기

git clone https://github.com/K-Dense-AI/scientific-agent-skills.git && mkdir -p ~/.claude/skills && cp -r scientific-agent-skills/skills/adaptyv ~/.claude/skills/

⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.

터미널을 열고 작업 폴더로 이동합니다.
저장소를 내려받습니다: git clone https://github.com/K-Dense-AI/scientific-agent-skills.git
스킬 폴더를 복사합니다: mkdir -p ~/.claude/skills && cp -r scientific-agent-skills/skills/adaptyv ~/.claude/skills/
Python 3.11 이상 환경을 준비하고 SDK를 설치합니다: uv pip install "git+https://github.com/adaptyvbio/adaptyv-sdk.git@cdf207819ed5a58e0c127453626d2bce125c8064"
Adaptyv Foundry(https://foundry.adaptyvbio.com)에서 Organization → Settings → Tokens로 토큰을 만들고(읽기는 Viewer, 쓰기는 Member) export ADAPTYV_API_KEY=발급받은값 으로 등록합니다. 토큰은 절대 코드에 커밋하지 마세요.
curl --fail-with-body 'https://devs.adaptyvbio.com/api/v1/targets?limit=3' -H "Authorization: Bearer $ADAPTYV_API_KEY" 로 연결을 확인합니다.
Claude Code를 재시작한 뒤 "Adaptyv로 스크리닝 실험 견적 내줘"처럼 요청하면 스킬이 발동합니다.

GitHub에서 원본 보기 ↗라이선스: MIT