AstroWay API 출시: 스위스 에페메리스의 정확도로 아스트로로지 계산을 위한 전체 스택

오늘 우리는 AstroWay API를 발표합니다 — 개발자를 위한 계산 백엔드로, 점성술 앱, 호로스코프 제품, 데이팅 호환성 기능, 출생 차트 분석을 위한 AI 에이전트까지 만들 수 있습니다.

이 글에서는 API의 내부 구조, 우리가 내린 비정상적인 결정, 의도적으로 배제한 부분, 그리고 어떻게 이 지점에 도달했는지에 대해 설명합니다. 수다 없이.

🕓 작성일: 2026-04-22, 최종 수정: 2026-05-09. 일부 수치는 오래되었습니다. 현재 상태: 723개의 엔드포인트(런칭 당시 87개가 아님), 818개의 CI 스냅샷 테스트(183개가 아님), MCP 서버 @astroway/mcp + TypeScript SDK @astroway/sdk + Python SDK astroway + PHP SDK astroway/sdk가 이제 퍼블릭 레지스트리에서 관리됩니다. 최신 상태는 /faq와 changelog에서 확인하세요.

##这是什么？

Swiss Ephemeris 기반의 REST API(라이선스: LGPL)로, WASM으로 컴파일되어 Node.js 서비스 형태로 배포됩니다. 이제 AI 해석(GPT-4 / Claude / Llama 3.3 / Gemini / DeepSeek / Mistral의 failover 체인)을 기본 계산 위에 추가했습니다. 이 엔진은 30년 이상 프로 점성술사들이 Solar Fire, Kepler, Astro Gold, Janus에서 사용해온 것과 동일한 것으로, NASA JPL의 에페메리드와 Astrodienst(astro.com)의 공식 swetest 레퍼런스와 교차 검증된 정확도를 자랑합니다.

주요 수치:

• 723개의 엔드포인트 — 서양 natal 점성술, 시너스트리, 트랜짓, 프로그레션, 디렉션, 리턴, 하모닉,Fixed Stars, 아랍 포인트, AstroCartography, Human Design 전체 스택 포함
• CI에서 실제 swetest CGI 출력 및 NASA 일식 카탈로그와 비교하는 183개의 스냅샷 테스트 — 모든 PR에서 실행
• p50 < 100ms, p95 < 500ms — 일반적인 계산 엔드포인트 기준
• MCP 서버 @astroway/mcp + 퍼블릭 레지스트리의 세 가지 SDK: @astroway/sdk(npm), astroway(PyPI), astroway/sdk(Packagist) — 세 언어로 제공되는 동일한 API
• MCP 서버 @astroway/mcp — Claude, GPT, Cursor 등 LLM 에이전트를 위한 API 툴 제공
• 크레딧 기반 요금제: 무료 플랜(월 10,000 크레딧, 카드 필요 없음), 유료 플랜은 월 $5부터

전체 문서: api.astroway.info/docs/api/. 실시간 상태: api.astroway.info/status.

##왜 만들었나요?

3년 전 우리는 소비자용 점성술 앱을 개발하기 시작했습니다. 계산 레이어가 UI나 콘텐츠보다 훨씬 복잡하다는 사실을 깨달았죠. 기존 서비스들은:

1. 커버리지가 얕음(10~30개의 엔드포인트, 대부분 natal에 국한)
2. 규모에 따라 비용이 급격히 증가($0.02~$0.10/요청, 대량 할인 없음)
3. 폐쇄형 엔진을 사용해 정확도를 검증할 수 없음
4. 베다 점성술을 우선시하고 서양 점성술을 부차적으로 다룸

그래서 Swiss Ephemeris를 자체 벤더링하고 계산 레이어를 직접 개발했습니다. 처음에는 소비자용 제품 app.astroway.info에서, 이후 마케팅 사이트 astroway.info에서 사용했는데, 이곳은 매달 수백만 명의 방문자에게 일일 호로스코프를 제공합니다.

3년간 프로덕션에서 이 코드를 운영하면서 두 가지 결론에 도달했습니다:

1. 동일한 계산 엔진을 다른 개발자들에게도 제공해야 합니다. 그들이 자체적으로 엔진을 개발할 수 없다고 해서가 아니라, 라이브러리 + WASM + 캐싱 + 정확도 테스트 CI 스택을 구축하는 데 약 6개월이 소요되기 때문입니다.
2. Human Design 커버리지가 정말 독보적입니다(12개의 엔드포인트 — 차트, 타입, 권한, 프로필, 게이트, 채널, контур, 행성 활성화, Incarnation Cross, Definition). 경쟁사는 API를 통한 완전한 HD 스택을 제공하지 않습니다.

이것이 바로 AstroWay API의 시작입니다.

##우리가 내린 타협점

###서양 점성술 우선, 베다 점성술은 차후

/nakshatras, /ashtakavarga, 디비전 차트를 위한 엔드포인트는 있지만 Dasha, Panchang, Ashtakoota, KP는 없습니다. 이유는 베다 점성술 내 학교 간 unresolved한 논쟁(ayanamsa 전쟁, KP Cuspid 논쟁, Dasa 학교 선택)이 있기 때문입니다. 서둘러 만든 베다 기능은 Prokerala나 VedicAstroAPI처럼 비판을 받을 수밖에 없습니다.

결정 사항: 베다 패키지는 Phase 3로 미루며, 서양 점성술에 대한 안정적인 수요가 확인된 후에 Jagannatha Hora와 Parashara’s Light를 검증할 시간을 가질 계획입니다. 차라리 아예 출시하지 않는 것이 잘못된 출시를 하는 것보다 낫습니다.

###Per-request가 아닌 크레딧 기반 요금제

하나의 /chart 호출은 약 365일 /forecast-calendar 호출의 50배에 달하는 계산량을 소모합니다. 요청당 고정 요금은 가벼운 사용자에게는 문턱이 높고, 무거운 사용자에게는 보조금을 지급하는 꼴이 됩니다. 크레딧은 실제 작업량에 맞춰 비용을 매핑합니다 — 요금제 페이지에서 엔드포인트별 테이블을 확인하세요.

###무료 플랜의 워터마크

무료 플랜 응답에는 _footer 필드가 포함됩니다:

{
  "data": { ... },
  "_footer": "Powered by astroway.api — get your own key at api.astroway.info"
}

우리에겐 아무런 비용이 들지 않지만, 무료 사용자에게는 업그레이드 동기를 제공합니다. Hobby+ 플랜에서는 API 키 설정을 통해 제거할 수 있습니다. 이 패턴은 Zapier와 RevenueCat에서 영감을 받았습니다.

###Rectification — 유료 플랜에서만

/rectification(생애 사건으로 출생 시간 추정 — likelihood-grid 검색)은 계산 비용이 매우 큽니다: 하나의 호출에 10~60초가 소요되며 Swiss Ephemeris의 수만 번의 중간 계산이 필요합니다. 이 기능은 Pro 플랜($59/월)에서만 제공되며, 과도한 사용을 방지하기 위해 높은 크레딧 비용을 책정했습니다.

###폐쇄형 AI 해석 없음

/interpret/* 엔드포인트는 시장 최고의 모델(Gemini → Groq → OpenRouter → Cerebras → SambaNova → Mistral)을 자동 failover하는 자체 AI 게이트웨이를 통해 라우팅됩니다. 우리는 특정 프롬프트에 당신을 가두지 않습니다 — 각 해석 응답에는 원본 계산 결과가 포함되어 있으므로, 우리의 스타일이 마음에 들지 않으면 직접 LLM을 재프롬프트할 수 있습니다. 전체 프롬프트와 출력은 B2B 컴플라이언스를 위한 감사 테이블에 90일간 로깅됩니다.

##이번 릴리스에서 빠진 것

• 베다 패키지 — Phase 3(위 참조)
• 임계치 알림 Webhook — 구현은 되었지만 UI가 미완성 상태입니다. 개선 중
• 퍼블릭 위젯 (<script src="api.astroway.info/widget/natal.js">) — Phase 7
• 메인 마케팅 사이트 플러그인 — 별도 프로젝트로 astroway.info 에코시스템에서 계획 중

##시작하기

1. “왜?”를 이해하고 싶다면 문서를 읽어보세요: api.astroway.info/overview
2. 5분만에 시작하는 빠른 가이드와 코드: Astrology API Quick Start
3. 엔드포인트별 크레딧 테이블 포함 요금제: api.astroway.info/pricing
4. 무료로 가입 — 카드 필요 없음: api.astroway.info/dashboard/sign-up

##기대하는 바

API로 무언가를 만들거나 버그를 발견했거나, 아직 없는 엔드포인트가 필요하다면 알려주세요. 우리가 듣고 싶은 건 사용하지 않는 기능을 개발하는 것보다 100명의 개발자가 무언가를 요청하는 소리입니다.

문의, 요청, 엣지 케이스: hello@astroway.info.

로드맵은 공개되어 있습니다 — PRODUCT-PLAN.md에서 어떤 기능이 완료되었는지, 다음은 무엇이며, 무엇이 연기되었는지 확인하세요.

환영합니다.