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

오늘 우리는 점성술 애플리케이션, 운세 제품, 데이팅 호환성 기능 및 출생 차트에 대해 추론해야 하는 AI 에이전트를 구축하는 개발자를 위한 계산 백엔드인 AstroWay API를 발표합니다.

이 글에서는 API 내부에 실제로 무엇이 있는지, 우리가 어떤 비전형적인 결정을 내렸는지, 의도적으로 무엇을 제외했는지, 그리고 여기까지 어떻게 오게 되었는지에 대해 설명합니다. 불필요한 내용은 없습니다.

🕓 2026년 4월 22일 기록, 2026년 5월 9일 업데이트. 일부 수치는 오래되었습니다. 현재 상태: 758개 엔드포인트 (출시 당시 87개가 아님), 873개 CI 스냅샷 테스트 (183개가 아님), MCP 서버 @astroway/mcp + TypeScript SDK @astroway/sdk + Python SDK astroway + PHP SDK astroway/sdk는 이제 모두 공개 레지스트리에 있습니다. 최신 상태는 /faq 및 changelog에서 확인하세요.

Swiss Ephemeris (LGPL)를 기반으로 WASM으로 컴파일되어 Node.js 서비스로 배포된 REST API입니다. 이제 실제 계산 위에 AI 해석 (GPT-4 / Claude / Llama 3.3 / Gemini / DeepSeek / Mistral의 페일오버 체인) 기능도 추가되었습니다. 30년 이상 전문 점성가들이 Solar Fire, Kepler, Astro Gold, Janus에서 사용해 온 것과 동일한 엔진으로, NASA JPL 천문력 및 Astrodienst (Astro.com)의 공식 swetest 레퍼런스와 대조하여 각초 단위까지 정확합니다.

수치:

• 758개 엔드포인트: 서양 점성술 (출생 차트, 시나스트리, 트랜짓, 프로그레션, 디렉션, 리턴, 하모닉, 고정성, 아랍 포인트, 아스트로카르토그래피) 및 휴먼 디자인 전체 세트
• 183개 스냅샷 테스트가 실제 swetest CGI 출력 및 NASA 일식 카탈로그에 대해 CI에서 모든 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개 엔드포인트, 주로 출생 차트만)
2. 대규모에서 비쌈 (대량 할인 없이 요청당 $0.02~$0.10)
3. 정확성을 확인할 수 없는 비공개 엔진 사용
4. 베다 점성술에 중점을 두고 서양 점성술은 부차적으로 제공

그래서 우리는 Swiss Ephemeris를 자체적으로 벤더링하고 우리만의 계산 레이어를 작성했습니다. 처음에는 소비자 제품인 app.astroway.info를 위해, 그 다음에는 매월 수십만 명의 방문자에게 일일 운세를 제공하는 마케팅 웹사이트 astroway.info를 위해 만들었습니다.

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

1. 동일한 계산 엔진은 다른 개발자들도 사용할 수 있어야 합니다. 그들이 직접 작성할 수 없어서가 아니라, 라이브러리 + WASM + 캐싱 + 정확성을 위한 CI 스택은 아무도 반복할 필요가 없는 6개월의 작업이기 때문입니다.
2. 우리의 휴먼 디자인 범위 (12개 엔드포인트: 차트, 유형, 권위, 프로필, 게이트, 채널, 회로, 행성 활성화, 인카네이션 크로스, 정의)는 정말 독특합니다. 어떤 경쟁자도 API를 통해 완전한 HD 스택을 제공하지 않습니다.

이것이 바로 출시입니다.

우리는 /nakshatras, /ashtakavarga 및 분할 차트용 엔드포인트는 있지만, Dasha, Panchang, Ashtakoota, KP는 없습니다. 이유는 베다 점성술에는 학파 간의 미해결된 불일치 (아야남샤 전쟁, KP 커스프 논쟁, 다샤 학파 선택)가 있기 때문입니다. Prokerala 및 VedicAstroAPI에 대항하여 서둘러 만든 베다 부분은 비판을 받을 수밖에 없었을 것입니다.

결정은 확고합니다: 베다 패키지는 서양 점성술에 대한 안정적인 수요가 있고 Jagannatha Hora 및 Parashara’s Light에 대해 검증할 시간이 생긴 후의 별도 3단계입니다. 제대로 출시하지 못할 바에는 아예 출시하지 않는 것이 낫습니다.

/chart 호출 한 번은 365일 /forecast-calendar보다 약 50배 적은 계산 비용이 듭니다. 요청당 고정 가격은 가벼운 사용자를 배제하거나 무거운 사용자에게 보조금을 지급하게 될 것입니다. 크레딧은 비용을 실제 작업에 매핑합니다. 요금제 페이지의 엔드포인트별 크레딧 표를 참조하세요.

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

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

이것은 우리에게 비용이 들지 않으며, 무료 사용자에게는 업그레이드할 작은 동기를 제공합니다. Hobby+ 플랜에서는 키 설정에서 제거할 수 있습니다. Zapier와 RevenueCat에서 이 패턴을 빌려왔습니다.

/rectification (삶의 사건을 통해 가능성 그리드 검색으로 출생 시간 선택)은 계산 비용이 많이 듭니다. 한 번의 호출은 10~60초가 걸리고 수만 번의 중간 Swiss Ephemeris 계산을 수행합니다. 우리는 이를 Pro 플랜 (월 $59)으로 제한하고 높은 크레딧 가격을 책정했습니다. 남용하면 다른 모든 사람을 위한 공유 인프라가 마비될 수 있기 때문입니다.

/interpret/* 엔드포인트는 시장 최고의 모델 (Google Gemini → Groq → OpenRouter → Cerebras → SambaNova → Mistral) 위에 자동 페일오버가 있는 우리의 비공개 AI 게이트웨이를 통해 라우팅됩니다. 우리는 당신을 우리의 프롬프트에 가두지 않습니다. 해석이 포함된 모든 응답에는 원본 계산이 포함되어 있으므로, 우리의 목소리가 마음에 들지 않으면 당신만의 LLM으로 다시 프롬프트할 수 있습니다. 우리는 B2B 규정 준수를 위해 전체 프롬프트와 출력을 감사 테이블에 기록합니다 (90일 보관).

• 베다 패키지: 3단계, 초기 수요 확인 후 (위 참조)
• 임계값 도달 시 웹훅: 구현되었지만 UI가 미완성입니다. 개선 중입니다.
• 공개 위젯 (<script src="api.astroway.info/widget/natal.js">) - 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를 사용하여 무언가를 만들거나, 버그를 발견하거나, 아직 없는 엔드포인트를 원한다면 우리에게 알려주세요. 아무도 사용하지 않는 기능을 출시하는 것보다 무언가를 요청하는 백 명의 개발자로부터 듣는 것이 우리에게는 더 좋습니다.

질문, 요청, 특이한 엣지 케이스: hello@astroway.info.

로드맵은 공개되어 있습니다 - PRODUCT-PLAN.md - 무엇이 완료되었고, 다음은 무엇이며, 무엇이 보류되었고 그 이유는 무엇인지.

환영합니다.