AstroWay APIのリリース: スイスエフェメリスの精度を備えた完全な天体計算のスタック

本日、AstroWay APIを発表します。これは、占星術アプリケーション、ホロスコープ製品、デーティングの相性機能、出生図について推論するAIエージェントを構築する開発者向けの計算バックエンドです。

この記事では、APIの内部が実際にどうなっているのか、私たちがどのような珍しい決定を下したのか、意図的に何を省いたのか、そしてどのようにしてここにたどり着いたのかを説明します。無駄な話は一切ありません。

🕓 2026-04-22の記録、2026-05-09更新。 一部の数値は古くなっています。現在の状況：758個のendpoint（ローンチ時の87個ではなく）、873個のCI snapshotテスト（183個ではなく）、MCP-サーバー @astroway/mcp + TypeScript SDK @astroway/sdk + Python SDK astroway + PHP SDK astroway/sdk はすべてパブリックレジストリで公開されています。最新のステータスは/faqとchangelogで確認してください。

Swiss Ephemeris (LGPL)をベースにしたREST APIで、WASMにコンパイルされ、Node.jsサービスとしてデプロイされています。現在は、実際の計算の上にAI解釈（GPT-4 / Claude / Llama 3.3 / Gemini / DeepSeek / Mistralのフェイルオーバーチェーン）も追加されています。これは、プロの占星術師がSolar Fire、Kepler、Astro Gold、Janusで30年以上にわたって使用しているのと同じエンジンです。NASA JPLのエフェメリスとAstrodienst (Astro.com) の公式swetestリファレンスで検証された、角度の秒単位の精度を誇ります。

数値データ：

• 758個のendpoint：西洋占星術の出生図、シナストリー、トランジット、プログレッション、ディレクション、リターン、ハーモニクス、恒星、アラビックパーツ、アストロカーグラフィー、さらにHuman Designの全セット
• CIにおける183個のsnapshotテスト。実際のswetest CGI出力とNASAの食カタログに対して実行され、すべてのPRでテストされます。
• 一般的な計算endpointでp50 < 100ms、p95 < 500ms
• MCPサーバー @astroway/mcp + 3つのSDKがパブリックレジストリで公開中：@astroway/sdk (npm)、astroway (PyPI)、astroway/sdk (Packagist) - 3つの言語で同じ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個のendpoint、主にネイタルのみ）
2. 大規模になると高価（卸売割引なしでリクエストあたり$0.02～$0.10）
3. 精度を検証できないクローズドなエンジンを使用している
4. ヴェーダ占星術に焦点を当て、西洋占星術は二次的なものとして提供している

そこで私たちはSwiss Ephemerisを独自にベンダー化し、独自の計算レイヤーを開発しました。最初は消費者向け製品app.astroway.infoのため、次に月間数十万人の訪問者に日々のホロスコープを提供するマーケティングサイトastroway.infoのために。

このコードを3年間本番環境で運用した結果、私たちは2つの結論に達しました。

1. 同じ計算エンジンを他の開発者も利用できるようにすべきだ。彼らが自分で書けないからではなく、ライブラリ + WASM + キャッシング + 精度CIというスタックは、誰も繰り返すべきではない半年間の作業だからだ。
2. 私たちのHuman Designのカバー範囲（12個のendpoint：チャート、タイプ、権威、プロファイル、ゲート、チャネル、回路、惑星の活性化、インカネーションクロス、定義）は本当にユニークだ。競合他社でAPIを通じて完全なHDスタックを提供しているところはない。

これが今回のローンチだ。

/nakshatras、/ashtakavarga、および分割チャート用のendpointはあるが、Dasha、Panchang、Ashtakoota、KPはない。理由：ヴェーダ占星術には、学派間の未解決の意見の相違（アヤナムシャの論争、KPカスプに関する議論、ダシャの学派の選択）があるためだ。ProkeralaやVedicAstroAPIに対して急いでヴェーダ占星術の部分を作っても、批判を受けるだけだろう。

決定は確定している：ヴェーダ占星術パッケージはフェーズ3として、西洋占星術への安定した需要が確認され、Jagannatha HoraやParashara’s Lightに対して検証する時間ができてから提供する。中途半端にリリースするよりも、まったくリリースしない方が良い。

/chartの1回の呼び出しは、365日間の/forecast-calendarよりも約50倍少ない計算コストで済む。リクエストごとの一律料金では、ライトユーザーを排除するか、ヘビーユーザーを補助することになるだろう。クレジットは実際の作業コストにマッピングされる。各endpointのクレジット表は料金ページを参照してほしい。

無料プランのレスポンスには_footerフィールドが含まれる：

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

これは私たちにとってコストがかからず、無料ユーザーにはアップグレードする小さな動機を与える。Hobby+プランでは、キー設定で削除できる。このパターンはZapierとRevenueCatから借用した。

/rectification（人生の出来事から尤度グリッド検索を通じて出生時間を特定する機能）は計算コストが高い。1回の呼び出しで10～60秒かかり、数万回の中間Swiss Ephemeris計算を実行する。悪用されると他のすべての共有インフラストラクチャに負担がかかるため、Proプラン（月額$59）に限定し、高額なクレジット料金を設定した。

/interpret/* endpointは、自動フェイルオーバーを備えた市場の最高峰モデル（Google Gemini → Groq → OpenRouter → Cerebras → SambaNova → Mistral）の上に構築された、私たちのプライベートAIゲートウェイを通じてルーティングされる。私たちは君を独自のプロンプトに閉じ込めることはしない。解釈を含む各レスポンスには元の計算が含まれているため、私たちのトーンが合わない場合は、独自のLLMで再プロンプトすることができる。完全なプロンプトと出力は、B2Bコンプライアンスのために監査テーブルにログ記録される（90日間保存）。

• ヴェーダ占星術パッケージ：フェーズ3、最初の需要確認後（上記参照）
• しきい値到達時のWebhook：実装済みだが、UIは未熟。改善中
• 公開ウィジェット (<script src="api.astroway.info/widget/natal.js">) - フェーズ7
• 主要マーケティングサイト用プラグイン：別のプロジェクトで、astroway.infoエコシステムの一環として計画中

1. 「なぜ」を理解したいならドキュメントを読んでほしい：api.astroway.info/overview
2. コード付きの5分でクイックスタート：Astrology API Quick Start
3. 料金プラン、endpointごとのクレジット表を含む：api.astroway.info/pricing
4. 登録：無料、カード不要：api.astroway.info/dashboard/sign-up

もしAPIを使って何かを構築したり、バグを見つけたり、まだ提供していないendpointが必要になったりしたら、私たちに連絡してほしい。誰も使わない機能をリリースするよりも、100人の開発者から要望を聞く方が良い。

質問、リクエスト、珍しいエッジケース：hello@astroway.info。

ロードマップは公開されている - PRODUCT-PLAN.md - 何が完了し、次は何で、何が延期され、なぜなのか。

ようこそ。