Skip to main content
Migration Agent

명령어 한 번으로
모든 API 마이그레이션.

에이전트를 설치해 주세요. 코드베이스를 스캔하고, API 인프라를 진단하고, 어댑터를 생성하고, 모든 호출을 검증합니다 — 전부 자동으로.

코드는 절대 수정되지 않습니다. Shadow 모드가 트래픽을 옮기기 전에 100% 검증하고, 명령어 한 번으로 롤백할 수 있습니다.

npx @apitree/migrate-agent analyze .

읽기 전용 스캔. 코드 변경 없음. 신용카드 불필요. 모든 언어 지원.

동작 방식

01

Audit

무료 인프라 진단

에이전트를 설치해 주세요. 코드베이스를 스캔해 완전한 API 인프라 리포트를 만들어 줍니다 — 어떤 API를 쓰는지, 키가 어디에 하드코딩돼 있는지, 어떤 호출에 에러 처리가 없는지, 무엇이 위험한지.

Output: Score: 42/100 Grade: F — 3 security issues, 8 reliability risks
소요 시간: 2분
위험 없음 (읽기 전용 스캔)
02

Plan

API별 마이그레이션 전략

에이전트가 탐지된 모든 API를 apitree 대응 API에 매핑하고, 신뢰도 점수를 매긴 뒤 마이그레이션 계획을 생성합니다. 아직 apitree에 없는 API는 우선 추가 대상으로 자동 보고됩니다.

Output: 5 providers detected, 4 migratable (100% confidence), 1 pending
소요 시간: 30초
위험 없음 (읽기 전용 분석)
03

Shadow

전환 전 검증

생성된 어댑터가 기존 API와 apitree를 동시에 호출합니다. 앱은 기존 응답을 사용하므로 비즈니스 영향은 0입니다. 백그라운드에서 두 응답의 구조적 동일성을 비교합니다.

Output: 247 requests verified, 100% match rate, +23ms avg latency
소요 시간: 정상 운영 중 실행
위험 없음 (항상 기존 API 사용)
04

Promote

점진적 트래픽 전환

Shadow 모드가 100회 이상의 요청에서 100% 일치율에 도달하면 카나리로 승격합니다 — 트래픽 10%는 apitree로, 90%는 기존 API로. 점진적으로 100%까지 올리고, 오류가 나면 자동으로 되돌립니다.

Output: Canary 10% → 25% → 50% → 100%. Zero errors. Migration complete.
소요 시간: 며칠~몇 주 (원하는 속도로)
오류 시 기존 API로 자동 폴백

안전성 보장

API 장애가 곧 매출 손실인 회사를 위해 만들었습니다. 모든 안전 장치는 반드시 필요해서 존재합니다.

기존 코드는 절대 수정하지 않습니다

에이전트는 새 어댑터 파일만 생성합니다. 소스 코드는 그대로 유지됩니다. 어댑터를 제거하면 즉시 원래 상태로 돌아갑니다.

명령어 한 번으로 롤백

apitree-migrate rollback 으로 생성된 모든 파일을 제거합니다. git 없이도 동작하고, 버전 관리도 필요 없습니다. 에이전트가 만든 모든 것을 추적합니다.

Shadow 모드가 먼저 검증합니다

모든 API 호출을 기존 제공자와 apitree 양쪽에서 테스트합니다. 응답이 100% 구조적으로 일치할 때만 승격을 권장합니다.

어떤 언어, 어떤 프레임워크든

TypeScript, Python, Java, Go, Ruby, PHP, C#, Rust. 에이전트가 모든 언어에서 SDK import, URL 패턴, 환경 변수를 탐지합니다.

코드는 서버를 벗어나지 않습니다

에이전트는 로컬에서 실행됩니다. apitree로는 제공자 이름과 발생 횟수만 전송됩니다(미지원 API 보고용). 소스 코드, 키, 비즈니스 로직은 모두 사용자 인프라에 남습니다.

오류마다 자동 폴백

카나리 및 전체 모드에서 apitree가 오류를 반환하면 어댑터가 자동으로 기존 API로 폴백합니다. 사용자는 장애를 전혀 보지 않습니다.

실제 동작 보기

API 제공자 6곳이 포함된 샘플 프로젝트를 스캔한 실제 출력입니다.

npx @apitree/migrate-agent analyze .
  Found 12 source files | Language: typescript

  ━━ SCAN REPORT ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  openai                3 refs  Tier 1   -> apitree: openai-gpt4o
    SDK: openai  |  Files: 3  |  Env: OPENAI_API_KEY

  stripe                2 refs  Tier 1   -> apitree: stripe-payments
    SDK: stripe  |  Files: 2  |  Env: STRIPE_SECRET_KEY

  resend                2 refs  Tier 2   -> apitree: resend-email
    SDK: direct URL  |  Files: 1  |  Env: RESEND_API_KEY

  coingecko             1 refs  Tier 3   -> apitree: coingecko-public
  open-meteo            1 refs  Tier 3   -> apitree: open-meteo-forecast
  github                1 refs  Tier 2   -> apitree: github-api

  ━━ AUDIT ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  Score: 58/100  Grade: D

  [!!] Hardcoded Stripe key in src/payments.ts:8
  [ !] API call without error handling (3 locations)
  [ !] API call without timeout (2 locations)
  [  ] Same URL hardcoded in 4 files

  ━━ PLAN ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  [ADAPTER] openai      conf: 100%  -> shadow adapter
  [ADAPTER] stripe      conf: 100%  -> shadow adapter
  [URL SWAP] resend     conf:  90%  -> URL replacement
  [URL SWAP] coingecko  conf:  90%  -> URL replacement
  [URL SWAP] open-meteo conf:  90%  -> URL replacement
  [URL SWAP] github     conf:  90%  -> URL replacement

  Estimated effort: < 5 minutes
  Risk: Zero (shadow mode default)
  Rollback: apitree-migrate rollback

진단이 잡아내는 것

보안

  • -소스 코드에 하드코딩된 API 키
  • -버전 관리에 커밋된 시크릿
  • -환경 변수를 쓰지 않는 API 자격 증명
  • -키 교체 패턴 부재

안정성

  • -에러 처리 없는 API 호출
  • -타임아웃 설정 누락
  • -일시적 실패에 대한 재시도 로직 부재
  • -서킷 브레이커 패턴 부재

아키텍처

  • -동일한 URL이 여러 파일에 하드코딩
  • -API 추상화 레이어 부재
  • -혼재된 인증 패턴
  • -중앙화된 설정 부재

비용

  • -중복 API 호출 (캐싱 없음)
  • -서비스 간 중복 요청
  • -과다 조회 (쓰지 않는 데이터 요청)
  • -사용량 모니터링·알림 부재

내 점수 확인하기

무료 진단을 실행해 보세요. 스캔에는 가입이 필요 없습니다. 점수가 80점 미만이면, 저희가 도와드립니다.

npx @apitree/migrate-agent analyze .
Migration Agent — Zero-Risk API Migration · apitree