AstroNest — Vedic Astrology & Ephemeris

AstroNest：アプリとAIエージェント向けのヴェーダ占星術

AstroNestは、REST APIとして呼び出したり、MCP経由でAIエージェントに接続したりできるヴェーダ占星術（Jyotiṣa）エンジンです。独自のJPL DE440天体暦を使って計算し、鑑定結果は決定論的です。同じ出生データには常に同じ回答が返り、それぞれの鑑定の根拠となる理由や古典文献も示されます。

このリポジトリには、AstroNestをAIエージェントに接続する方法と、REST APIを使ったNext.jsクイックスタートの2つが含まれています。

• ドキュメント：https://www.astronest.ai/developers
• OpenAPI 3.1仕様：https://www.astronest.ai/openapi/astronest-v1.json
• Postman：AstroNest Developer APIワークスペース
• キー：https://www.astronest.ai/developer。サンドボックスキーは無料で、固定サンプルを返します。

AIエージェントに接続する（MCP）

エンドポイント（Streamable HTTP）：https://www.astronest.ai/api/developer/mcp

Claude Code

claude mcp add --transport http astronest https://www.astronest.ai/api/developer/mcp \
  --header "Authorization: Bearer YOUR_ASTRONEST_KEY"

mcp.json（Cursor、VS Codeなど、この形式を読み込むクライアント向け）

{
  "mcpServers": {
    "astronest": {
      "url": "https://www.astronest.ai/api/developer/mcp",
      "headers": { "Authorization": "Bearer YOUR_ASTRONEST_KEY" }
    }
  }
}

Smitheryと MCP Registryにもio.github.onedotlinks/astronestとして登録されています。

エージェントが質問できること

各ツールは1つの質問に答えます。解釈を行うツールは、実践者と同じようにホロスコープを読み解き、単に位置を示すだけでなく、その理由も返します。

ツール	回答する質問
get_life_reading	私の人生全体はどのようなものですか。過去と未来において、結婚、子ども、キャリア、お金、不動産など、どの分野にいつ焦点が当たりますか？
get_domain_timeline	結婚、キャリア、その他の分野に焦点が当たるのはいつですか。また、その分野について今後数年間に何が待ち受けていますか？
get_relationship_reading	2人はビジネスパートナー、きょうだい、親子、友人として、どのような関係を築けますか？
get_venture_timing	事業を始める、契約する、借り入れをするのに適した時期はいつですか。また、ホロスコープはどの業種を支持していますか？
assess_gemstone	この宝石（ブルーサファイア、プクラージュ、エメラルドなど）を身につけるべきですか。また、その理由は何ですか？
get_compatibility、get_guna_milan	クンドリー照合：36点満点のアシュタクートスコア、ラグナ・月・金星から見たマンガリク、そして2人の詳しい鑑定
interpret_domain、get_guidance	私のホロスコープは特定の生活分野について何を示していますか。また、現在進行中の時期は私に何を求めていますか？
find_muhurta	指定した日付範囲で、ある行事に適した日はいつで、時間帯はどこですか？
get_chart、get_dasha、天体暦ツール	ホロスコープ（16の分割図を含む）、プラティアンタルまでのヴィムショッタリ・ダシャー、JPL DE440による生の天体位置

鑑定では、ホロスコープが示す内容とその理由を説明します。これは象徴的な解釈であり、予測でも、医療・法律・金融・心理に関する助言でもありません。すべての回答に免責事項が付いています。

Next.jsクイックスタート

AstroNest Developer APIを使った小規模なNext.jsアプリです。出生の日付、時刻、場所を入力すると、以下を取得できます。

• ホロスコープ：ラグナ、星座・ハウス・ナクシャトラ・品位を含む9つのグラハ、進行中のダシャー（1クレジット）
• 現在のガイダンス：進行中のマハーダシャー／アンタルダシャー／プラティアンタルダシャーを平易な言葉で説明するカード（3クレジット）
• 分野別鑑定：キャリア、結婚、金融など、さらに12の分野について、裏付けとなる要因、注意点、時期の目安、合致する手法の数を提示（5クレジット）
• 必要に応じて、独自のLLMを使った**「平易な言葉で説明」**（AstroNestクレジット不要）

AstroNestへの3つの呼び出しのいずれも、言語モデルを使用しません。決定論的なため、数秒で結果が返り、同じ入力には常に同じ回答が返ります。

5 分で実行

1. キーを取得します。 https://www.astronest.ai/developer にサインインして、キーを作成します。各アカウントには、 ライブクレジットが 100 回分、初回のみ無料で付与されます。最初のライブキーを発行してから 60 日間有効です（更新されません）。これで、 ドメインリーディングなら約 20 回、チャートなら 100 回分を利用できます。 サンドボックスキーは時間制限なしで無料で利用でき、固定のサンプルレスポンスを返します。無料クレジットを使い切るか、 60 日が経過すると、クレジットパックを購入するまでライブ呼び出しは 402 credits_exhausted を返します。サンドボックスキーは引き続き利用できます。
2. インストールして設定します。

   npm install
   cp .env.example .env.local
   # put your key in ASTRONEST_API_KEY
   

3. 実行します。

   npm run dev
   

   http://localhost:3000 を開きます。

仕組み

browser ──► /api/astronest/{chart|guidance|interpret} ──► AstroNest API   (your key, server-side)
        └─► /api/explain ──────────────────────────────► your LLM         (optional)

• lib/astronest.ts は型付きクライアントです。自分のアプリにコピーするファイルです。
• app/api/astronest/[op]/route.ts は、この 3 つの操作のみを転送するため、このルートを使ってキーで許可されているすべてのエンドポイントを呼び出すことはできません。
• app/api/explain/route.ts は、AstroNest が計算したリーディングを OpenAI 互換のチャット補完エンドポイント（OpenAI、Vercel AI Gateway、OpenRouter、ローカルの Ollama）に送信し、与えられた事実のみを使うようモデルに指示します。文章を書くのはお使いのモデルで、占星術を扱うのは AstroNest です。

デプロイする前に

• キーは秘密情報です。 サーバー環境変数にのみ保存してください。NEXT_PUBLIC_ を先頭に付けてはいけません。また、ブラウザーから API を呼び出してはいけません。API は CORS ヘッダーを送信しないため、ブラウザーからの呼び出しはどのみち失敗します。
• デモルートを呼び出した人は誰でも、クレジットを消費します。 デフォルトでは、localhost からのリクエストにのみ応答します。ALLOW_PUBLIC_DEMO=true を設定する前に、独自のサインイン（できればレート制限も）を設けてください。localhost のチェックではリクエストのホストを参照するため、Host を書き換えるプロキシの背後では、このチェックに依存しないでください。
• 出生データは個人データです。 このアプリは何も保存せず、API も何も保存しません。保存機能を追加すると、それに伴うデータ保護の責任を負うことになります。
• すべてのレスポンスに付属する免責事項を表示してください。 象徴的な解釈であり、医療、法律、金融、心理に関する助言ではありません。

さらに詳しく

エンドポイント	クレジット	備考
POST /v1/chart	1	アストロカートグラフィーと移転後のチャートには、location を追加します
POST /v1/dasha	1	ヴィムショッタリーの全期間タイムライン
POST /v1/guidance	3	別の任意の時点には referenceDate を指定します
POST /v1/interpret	5	15 の領域
POST /v1/timing/resolve	7	言語モデルによる解説付きです。90 秒お待ちください
POST /v1/forecast	8	言語モデルによる解説付きです。90 秒お待ちください
POST /v1/muhurta	10	日付範囲内の吉祥時間帯
POST /v1/compatibility	12	2 つのチャートを合わせて読み解きます
POST /v1/guna-milan	2	2 人の 36 点満点のアシュタクータ適合度とマンガリク（ラグナ、月、金星）
POST /v1/life-reading	10	人生全体のリーディング：過去と未来にわたる章と 11 のライフエリア（areas で絞り込めます）
POST /v1/domain-timeline	3	人生の 1 つの領域を、任意の日付範囲内で司るすべての期間を通じて読み解きます
POST /v1/relationship	8	ビジネスパートナー、きょうだい、親子、友人：絆を示すハウス、チャート間のコンタクト、絆のメーター
POST /v1/venture-timing	10	いつ取り組み、築き、守り、または維持すべきかを示します。説明した事業をチャートに基づいて順位付けします
POST /v1/gem-assessment	5	このチャートの持ち主がこの宝石を身に着けるべきかを判定します。結論、賛否それぞれの理由、理由が続く期間を示します
POST /v1/ephemeris/positions	0.1	ある時点の生の位置データ（JPL DE440）。出生データは不要です
POST /v1/ephemeris/angles	0.1	ある時点と場所のアセンダント、MC、ハウスカスプ
POST /v1/ephemeris/ayanamsa	0.1	Lahiri、Raman、Krishnamurti、Fagan–Bradley
POST /v1/ephemeris/sunrise	0.1	現地日付の日の出、日の入り、翌日の日の出
POST /v1/ephemeris/series	1	開始した 100 ポイントごと。最大 1,000 ポイント

単一時点のエフェメリス呼び出し 4 種類はそれぞれ 0.1 クレジットです。アカウント全体でこれらの呼び出しを合算し、10 回ごとに 1 クレジット（10 回単位のブロックが始まる呼び出しは units_charged: 1 を返し、続く 9 回は 0 を返します）。 成功した（2xx）呼び出しのみ課金されます。クレジットがなくなると、API は 402 credits_exhausted を返します。開発者ポータルでパックを購入してください。有料クレジットに有効期限はありません。

• OpenAPI 3.1 仕様：https://www.astronest.ai/openapi/astronest-v1.json（Postman にインポートするか、任意の言語でクライアントを生成できます）
• リファレンス：https://www.astronest.ai/developer の開発者ポータル