AstroWay APIの立ち上げ: Swiss Ephemerisの精度でアストロロジー計算の完全なスタック

本日、我々は AstroWay API を公開します。これは、アストロロジーアプリ、ホロスコープ製品、デーティング向けの互換性機能、あるいは出生図を考慮した意思決定を行う AI エージェントを開発する開発者向けの計算バックエンドです。

この記事では、API の内部構造、我々が採用した特殊なソリューション、意図的に除外した機能、そしてその経緯について、余計な話を一切交えずに紹介します。

🕓 2026年4月22日時点、2026年5月9日更新。 一部の数値は古くなっています。最新の状況: 723 エンドポイント（リリース時は 87 ではなく）、818 件の CI スナップショットテスト（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 サービスとしてデプロイされています。さらに、GPT-4 / Claude / Llama 3.3 / Gemini / DeepSeek / Mistral などの最新 LLM による AI 解釈（フェイルオーバーチェーン）を、実計算の上に重ねています。この計算エンジンは、30 年以上にわたり、Solar Fire、Kepler、Astro Gold、Janus といったプロフェッショナルなアストロロジーアプリで使用されてきたものです。精度は NASA JPL のエフェメリデと Astrodienst（Astro.com）公式の swetest リファレンスと照合されており、角度の 1 秒未満の精度を実現しています。

数値:

• 723 エンドポイント — 西洋占星術の Natal、シナストリー、トランジット、プログレッション、ディレクション、リターン、ハーモニクス、固定星、アラビア点、アストロカルトログラフィーに加え、Human Design の完全なセットを網羅
• CI では 183 件のスナップショットテスト が実行され、リアルな swetest CGI の出力と NASA の日食カタログと照合。各 PR で実行されています
• p50 < 100ms、p95 < 500ms （典型的な計算エンドポイントの場合）
• MCP サーバー @astroway/mcp + 3 つの SDK がパブリックレジストリで公開: @astroway/sdk（npm）、astroway（PyPI）、astroway/sdk（Packagist）。同一の API を 3 つの言語で提供
• 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. スケールすると高額（割引なしで 1 リクエストあたり $0.02～$0.10）
3. 閉鎖的なエンジンを使用しており、精度を検証できない
4. ベーダアストロロジーに特化しており、西洋占星術は二次的な扱い

そこで、我々は Swiss Ephemeris を自前でベンダリングし、独自の計算レイヤーを開発しました。当初は消費者向け製品 app.astroway.info 用に、その後はマーケティングサイト astroway.info 用に（同サイトは月間数十万の訪問者に対し、毎日ホロスコープを配信しています）。

このコードを 3 年間プロダクションで運用してきた結果、2 つの結論に至りました。

1. この計算エンジンは他の開発者にも提供すべきです。彼らが独自に実装できないからではなく、ライブラリ + WASM + キャッシュ + 精度検証のための CI は、誰もが再実装すべきではない半年分の作業だからです。
2. 我々の Human Design のカバレッジ（12 エンドポイント — マップ、タイプ、オーソリティ、プロファイル、ゲート、チャンネル、コンター、惑星アクティベーション、インカーネーションクロス、ディフィニション）は本当にユニークです。競合他社で、Human Design の完全なスタックを API 経由で提供しているところはありません。

こうして、本日公開に至りました。

/nakshatras、/ashtakavarga、ディビジョナルチャート用エンドポイントはありますが、Dasha、Panchang、Ashtakoota、KP はありません。理由は、ベーダ占星術には学校間で未解決の論争があるためです（ayanaamsa の戦い、KP のクスピド論争、ダシャの学校選択など）。急ごしらえのベーダ機能は Prokerala や VedicAstroAPI のような既存サービスと同様、批判を浴びるだけでしょう。

方針は固定されています。ベーダパッケージはフェーズ 3 に回し、西洋占星術で安定した需要が見込め、Jagannatha Hora や Parashara’s Light との検証が可能になった段階でリリースします。不完全な状態でリリースするくらいなら、まったくリリースしない方がましです。

/chart 1 回の呼び出しは、/forecast-calendar（365 日分）の約 50 分の 1 の計算コストです。リクエスト単位の固定料金では、ライトユーザーを切り捨てるか、ヘビーユーザーに補助することになります。クレジットは実際の計算コストにマッピングされています。エンドポイントごとのクレジット表は 料金ページ をご覧ください。

無料プランのレスポンスには _footer フィールドが含まれています。

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

我々にとってはコストがかかりませんが、無料ユーザーにとってはアップグレードのきっかけになります。Hobby+ プラン以上では、ダッシュボードから非表示にできます。このパターンは Zapier や RevenueCat から拝借しました。

/rectification（ライフイベントから出生時刻を推定する likelihood-grid 検索）は計算コストが高く、1 回の呼び出しに 10～60 秒かかり、Swiss Ephemeris の中間計算を数万回実行します。このため、Pro プラン（月額 $59）に制限し、クレジット単価も高く設定しています。悪用されると、他のユーザーと共有するインフラに負荷がかかるためです。

/interpret/* エンドポイントは、当社のプライベート AI ゲートウェイを経由します。これは市場のベストなモデル（Google Gemini → Groq → OpenRouter → Cerebras → SambaNova → Mistral）を自動フェイルオーバーで利用しています。我々は特定のプロンプトに固定せず、各レスポンスには元の計算結果が含まれています。そのため、我々の解釈が気に入らない場合は、独自の LLM に切り替えることができます。プロンプトと出力は B2B コンプライアンスのために 90 日間監査ログとして保存されます。

• ベーダパッケージ — フェーズ 3。西洋占星術で需要が確認された後に、Jagannatha Hora や Parashara’s Light との検証を行う予定（詳細は上記）
• しきい値到達時の 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. 料金 — エンドポイントごとのクレジット表を含む: api.astroway.info/pricing
4. 登録する — 無料、カード不要: api.astroway.info/dashboard/sign-up

もし API を使って何かを構築した場合、あるいはバグを見つけた、あるいはまだ実装されていないエンドポイントが必要な場合は、ぜひご連絡ください。使われない機能を開発するよりも、100 人の開発者からの要望を聞く方がましです。

質問、リクエスト、エッジケース: hello@astroway.info。

ロードマップは公開されています — PRODUCT-PLAN.md — 何が完了し、次に何を計画し、何が延期されているのか、そしてその理由が記載されています。

ようこそ。