2026年にアストロロジーアプリを作るつもり?市場はすでに成熟していて、自前でエフェメリスを計算する時代から、わずか数社の商用APIが存在する時代へと移行している。API選びの際に知っておくべきことは以下の通りだ。
これはマーケティングではない。開発者が本当に知りたいこと、つまりエンドポイント数、実際の価格、SDKの品質、精度に関する主張、各APIの強みと弱みについてまとめたものだ。
アストロロジーAPIで本当に重要なこと
Section titled “アストロロジーAPIで本当に重要なこと”APIを統合する際に重要な5つのポイントは以下の通り:
- カバレッジ — どれだけ多くのテクニックがサポートされているか?基本中の基本は Natal Chart(出生図)で、最低限 Synastry(合星図)、Transits(トランジット)、Progressions(プログレッション)が必要だ。Rectification(出生時刻の特定)や Human Design といったプレミアム機能は、差別化要因となる。
- 精度 — ±1秒角は Swiss Ephemeris の標準だ。これより低い精度だと、Astrodienst で検証するユーザーからクレームが来る可能性がある。
- 料金体系 — リクエスト単位、クレジットベース、それとも月額固定?クレジットベースは、負荷が変動する場合にスケーリングしやすい。
- SDKの品質 — TypeScript や Python の型付きSDKは、数時間の節約になる。AIエージェントを構築する場合は、MCPサポートが必須だ。
- ドキュメント — OpenAPI 3.1 spec は最低限必要。インタラクティブな Playground は、時間の大幅な節約になる。
主要プレイヤー
Section titled “主要プレイヤー”商用アストロロジーAPIの競争は激しい。主なプレイヤーは以下の3つのカテゴリーに分類できる:
- 総合西洋占星術 + ベーダ占星術:西洋占星術とベーダ占星術の両方をカバーしようとするAPI。 nakshatras( nakshatra )、dashas(ダシャ)、ベーダ占星術の divisional chart に強みを持つが、現代の西洋占星術テクニックは弱い傾向にある。
- 西洋占星術特化型:西洋占星術に特化しつつ、「差別化要因」として Human Design、Rectification、AI解釈などを提供するAPI。特定のニッチ分野に深く特化している。
- AI-first:基本的な計算をラップして、GPT-4、Claude 3.5、Llama 3.3 といったLLMで包み込み、「ChatGPT for Astrology」と称するAPI。使いやすいが、裏側の計算は表面的で、エフェメリスの実データはなく、AIが±15日程度の誤差で幻覚を起こすこともある。
AstroWay API はどこに位置するのか?西洋占星術特化型 + Human Design + AI解釈。723 のエンドポイント、Swiss Ephemeris による±1秒角の精度、12の Human Design エンドポイント、クレジットベースの料金体系を提供している。
| 機能 | AstroWay | 典型的な Vedic-first | 典型的な AI-first |
|---|---|---|---|
| エンドポイント | 723 | 40–60 | 10–20 |
| 精度 | ±1” (Swiss Ephemeris) | ばらつきあり | ばらつきあり |
| Natal Chart | ✅ | ✅ | ✅ |
| Synastry | ✅ (0–100スコア) | 多くの場合 | 時々 |
| Progressions | ✅ (Secondary + Tertiary + Minor) | まれ | まれ |
| Rectification | ✅ (アルゴリズム + Trutine) | ❌ | ❌ |
| Human Design | 12エンドポイント | 時々基本的なもの | まれ |
| AI解釈 | 10エンドポイント(セーフティガード付き) | 時々 | ✅ |
| MCPサーバー | ✅ (25ツール) | ❌ | 時々 |
| TypeScript SDK | ✅ (型付き) | 時々 | 時々 |
| Python SDK | ✅ (コンテキストマネージャー) | 時々 | 時々 |
| OpenAPI 3.1 spec | ✅ | 時々 | まれ |
| 無料プラン | 10,000クレジット/月 | 制限あり | トライアルのみ |
レアなテクニックが差別化要因に
Section titled “レアなテクニックが差別化要因に”Harmonic Charts、Antiscia、Gauquelin Sectors、Barbault Cyclic Index といったテクニックは、ほとんどのAPIでサポートされていない。これらは研究目的のアプリケーション、伝統的な占星術、学術的な研究にとって非常に価値があるニッチな領域だ。
AstroWay はこのニッチに特化して取り組んでいる:
- Harmonic Charts (H2–H180) — ジョン・アディによる研究手法
- CCG (Cyclo-Carto-Graphy) — プログレッシブ・アストロカルトログラフィー
- Rectification — 出生時刻のアルゴリズム的な特定
- Gauquelin Sectors — 統計占星術
- Antiscia — 古典的なヘレニズム占星術のテクニック
- Disposition Chains — 支配関係のグラフ分析
- 完全な Human Design — 12のエンドポイント(Penta や Dream Rave を含む)
これらのいずれかが必要なアプリケーションの場合、選択肢は一気に狭まる。
実践的な料金体系
Section titled “実践的な料金体系”ほとんどの商用APIは、リクエスト単位か月額クォータで課金される。リクエスト単位の場合、1回の呼び出しが安く見える($0.01–0.05)が、ユーザー数が増加するとコストが急増する。
AstroWay のようなクレジットベースの料金体系では、エンドポイントの複雑さに応じて異なるクレジットが消費される:
- 単純なデータ取得(惑星の位置)は10クレジット
- 完全な Natal Chart は20クレジット
- Synastry は50クレジット
- Rectification は500クレジット
これにより、実際の計算コストをより正確に反映できる。1日1,000件の Natal Chart を処理する小規模なアプリケーションの場合、Starterプラン($19/月)で十分カバーできる(約20,000クレジット)。
SDKの品質は思った以上に重要
Section titled “SDKの品質は思った以上に重要”生のHTTPリクエストでも動作はするが、型付きSDKは以下の点で時間を節約してくれる:
- パラメータ名を思い出すためのドキュメントを読む手間
- ランタイム前に型エラーをキャッチ
- IDEでのレスポンスフィールドのオートコンプリート
AstroWay の TypeScript SDK は、723 すべてのエンドポイントを完全な型推論でカバーしている:
const chart = await client.chart({ date: '1990-07-14', time: '14:30:00', timezoneOffset: 3, latitude: 50.4501, longitude: 30.5234,});
// TypeScriptはchart.planetsがPlanet[]型であることを認識(anyではない)for (const planet of chart.planets) { console.log(`${planet.name} at ${planet.longitude}°`);}AIエージェント向けのMCP
Section titled “AIエージェント向けのMCP”Claude Desktop 用のカスタムツール、コーチングチャットボット、ChatGPT へのアストロロジー統合など、AIエージェントを構築する場合、Model Context Protocol (MCP) が現在のスタンダードだ。MCPサーバーは、APIを直接呼び出せるツールとして提供する。
AstroWay の MCPサーバー は25のツールを提供しており、Natal Chart、Synastry、Transits、Horoscopes、そして12の Human Design エンドポイントが含まれる。設定は以下の通り:
{ "mcpServers": { "astroway": { "command": "npx", "args": ["@astroway/mcp"], "env": { "ASTROWAY_API_KEY": "aw_live_..." } } }}これで、Claude は30秒で25の新しいアストロロジー・ツールを手に入れる。
「最良の」APIは一つに絞れない。重要なのは、何を構築するかによって決まる:
- 標準的な西洋占星術機能のアプリケーション? AstroWay か、それと同等の西洋占星術特化型APIを選ぼう。
- 主な機能がベーダ占星術? Vedic特化型APIを検討しよう。AstroWayにも基本的な Vedic 機能(nakshatras、divisional charts)はあるが、メインではない。
- AIエージェントを構築する? MCPサポートは必須。AstroWayを含む数社のAPIがこれを提供している。
- Rectification、Human Design、Harmonics といったレアなテクニックが必要? AstroWay はまさにそのために存在する。
いくつかのAPIを実際に試してみよう。各APIには無料プランがあるので、同じエンドポイントを3つのAPIに対して呼び出し、精度、レイテンシ、開発体験(DX)を比較しよう。プロジェクトに最適なものを見つける唯一の方法はこれだ。
AstroWay を始めよう
Section titled “AstroWay を始めよう”AstroWay が必要そうなら:
Solar Fireと同じSwiss Ephemeris — 4行のコードで。
無料のキー(カード不要)。最初の支払いまでに月5,000回の呼び出し。