문제점 (고통지수: 7/10)

API 스키마를 변경할 때마다 changelog를 수동으로 작성하는 것은 번거롭고 누락되기 쉬운 작업입니다.

실제 사례:

  • 필드 추가/삭제했지만 changelog에 기록 안 함
  • Breaking change를 놓쳐서 클라이언트 앱이 깨짐
  • 버전별 변경사항 추적이 어려워 롤백 판단 불가
  • 여러 API 버전 간 차이점 파악에 시간 낭비

빈도: API 변경 시마다 (주 1-2회)

특히 MSA 환경에서 여러 서비스의 API를 관리할 때, 수동 changelog 관리는 현실적으로 불가능합니다. 결국 changelog가 부실해지고, API 소비자들은 변경사항을 직접 파악해야 합니다.

타겟 시장

주요 타겟:

  • B2B API 제공 회사
  • 마이크로서비스 아키텍처 팀
  • API-first 스타트업
  • 오픈소스 API 프로젝트

시장 규모:

  • TAM(전체 시장): $15B+ (API Management 시장)
  • API 도구 시장: 연 25%+ 성장
  • 개발자 도구 세그먼트: 급성장 중

고객 특성:

  • API 문서화에 관심 높음
  • CI/CD 파이프라인 사용
  • OpenAPI/GraphQL 스키마 사용
  • 자동화 도구 선호

솔루션 제안

핵심 기능:

  1. 스키마 Diff 분석

    • OpenAPI 3.x 스펙 지원
    • GraphQL 스키마 지원
    • 시맨틱 버저닝 자동 추천 (major/minor/patch)
  2. 자동 Changelog 생성

    • Breaking changes 하이라이트
    • 새 엔드포인트/필드 목록
    • Deprecated 항목 경고
    • 마크다운/HTML 출력
  3. CI/CD 통합

    • GitHub Actions 연동
    • PR에 자동 changelog 코멘트
    • 릴리즈 노트 자동 생성
  4. 히스토리 관리

    • 버전별 변경사항 아카이브
    • 두 버전 간 diff 비교
    • 검색 가능한 changelog 대시보드

경쟁 분석

경쟁사포지션가격약점
OpticAPI diff 도구오픈소스changelog 생성 기능 약함
Bump.shAPI 문서 플랫폼$99+/mo플랫폼 종속, 비쌈
StoplightAPI 디자인 플랫폼엔터프라이즈복잡함, 오버킬

차별화 포인트:

  • changelog 생성에만 집중한 가벼운 도구
  • CLI 기반으로 어떤 워크플로우와도 통합
  • 무료 오픈소스 코어 + 유료 클라우드
  • 3분 내 설정 완료

MVP 개발 계획

개발 기간: 3주

Week 1: 스키마 파싱

  • OpenAPI 3.x 파서 구현
  • 스키마 diff 알고리즘
  • 변경사항 분류 로직

Week 2: Changelog 생성

  • 마크다운 템플릿 엔진
  • 시맨틱 버저닝 추천
  • CLI 인터페이스

Week 3: CI/CD 연동

  • GitHub Actions 워크플로우
  • PR 코멘트 봇
  • npm 패키지 배포

기술 스택 제안:

  • Runtime: Node.js (TypeScript)
  • Parser: @apidevtools/swagger-parser
  • 배포: npm 패키지 + GitHub Actions

수익 모델

가격 구조:

플랜가격기능
Open Source무료CLI, 기본 changelog
Pro$29/mo클라우드 히스토리, 대시보드
Team$79/mo멀티 API, 팀 협업, Slack 알림

수익 예상:

  • 첫 해 목표: $2K MRR
  • 80명 유료 고객 (평균 $25/mo)
  • 오픈소스 인지도로 유료 전환 유도

성장 전략:

  • GitHub 스타 마케팅
  • API 컨퍼런스/밋업 발표
  • 유명 API 프로젝트에 기여하며 홍보

리스크와 도전

기술적 리스크:

  • 다양한 OpenAPI 스펙 버전 호환성
  • GraphQL 스키마의 복잡한 diff

시장 리스크:

  • API 플랫폼 회사들이 기능 추가 가능
  • 작은 시장 규모

운영 리스크:

  • 오픈소스 유지보수 부담
  • 다양한 엣지 케이스 대응

완화 전략:

  • 핵심 기능에 집중 (scope creep 방지)
  • 커뮤니티 기여 장려
  • 빠른 릴리즈 사이클

추천 이유

점수: 92/100

  1. 명확한 고통점: API 개발자라면 누구나 겪는 changelog 관리 문제
  2. 빠른 MVP: 3주 내 핵심 기능 완성 가능
  3. 낮은 기술 복잡도: 스키마 파싱은 검증된 라이브러리 활용
  4. 선호 도메인: api_tools, devops 영역
  5. 글로벌 타겟: 언어 장벽 없음
  6. 명확한 ROI: 수동 작업 시간 절약

API 개발 워크플로우의 자동화를 노린 실용적인 사이드 프로젝트입니다.