문제점 (고통지수: 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 스키마 사용
- 자동화 도구 선호
솔루션 제안
핵심 기능:
스키마 Diff 분석
- OpenAPI 3.x 스펙 지원
- GraphQL 스키마 지원
- 시맨틱 버저닝 자동 추천 (major/minor/patch)
자동 Changelog 생성
- Breaking changes 하이라이트
- 새 엔드포인트/필드 목록
- Deprecated 항목 경고
- 마크다운/HTML 출력
CI/CD 통합
- GitHub Actions 연동
- PR에 자동 changelog 코멘트
- 릴리즈 노트 자동 생성
히스토리 관리
- 버전별 변경사항 아카이브
- 두 버전 간 diff 비교
- 검색 가능한 changelog 대시보드
경쟁 분석
| 경쟁사 | 포지션 | 가격 | 약점 |
|---|---|---|---|
| Optic | API diff 도구 | 오픈소스 | changelog 생성 기능 약함 |
| Bump.sh | API 문서 플랫폼 | $99+/mo | 플랫폼 종속, 비쌈 |
| Stoplight | API 디자인 플랫폼 | 엔터프라이즈 | 복잡함, 오버킬 |
차별화 포인트:
- 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
- 명확한 고통점: API 개발자라면 누구나 겪는 changelog 관리 문제
- 빠른 MVP: 3주 내 핵심 기능 완성 가능
- 낮은 기술 복잡도: 스키마 파싱은 검증된 라이브러리 활용
- 선호 도메인: api_tools, devops 영역
- 글로벌 타겟: 언어 장벽 없음
- 명확한 ROI: 수동 작업 시간 절약
API 개발 워크플로우의 자동화를 노린 실용적인 사이드 프로젝트입니다.