無料の占星術API・埋め込みウィジェット

月星座・太陽星座・金星・火星・水星の星座をブログやサイトに埋め込めるウィジェットと、生年月日・時刻・場所から各天体の星座（西洋・インド）とアセンダントを返すJSON APIです。登録・APIキー不要。

生年月日を入れると星座が表示され、その星座の解説ページへのリンクが出ます。出生時刻がわからず、その日に星座が変わっている場合は両方を表示します。下は実物です。

iframe で貼る（おすすめ）

<iframe src="https://genesis-astro-guide-r2owtywexa-an.a.run.app/widget/sign.html?planet=moon&lang=ja" title="月星座を調べる" loading="lazy" style="width:100%;max-width:440px;height:340px;border:0;border-radius:12px"></iframe>
<p><a href="https://genesis-astro-guide-r2owtywexa-an.a.run.app/ja/guides/moon">月星座の意味（GenesisCore 占星術ガイド）</a></p>

script で貼る

<script src="https://genesis-astro-guide-r2owtywexa-an.a.run.app/widget/embed.js" data-planet="moon" data-lang="ja" async></script>
<p><a href="https://genesis-astro-guide-r2owtywexa-an.a.run.app/ja/guides/moon">月星座の意味（GenesisCore 占星術ガイド）</a></p>

planet= は moon（月）・sun（太陽）・venus（金星）・mars（火星）・mercury（水星）、lang= は ja / en、theme=light で白背景になります。

2. JSON API

GET https://genesis-astro-guide-r2owtywexa-an.a.run.app/api/v1/chart?date=YYYY-MM-DD&time=HH:MM&offset=9[&lat=..&lon=..][&lang=ja|en]

date：必須。1900〜2100年
time：省略時は 12:00
offset：UTCからの時差（時間）。日本は 9。省略時は 0（UTC）
lat / lon：指定するとアセンダント・MC・ラグナ（ラヒリ）も返します（東経がプラス）

返す内容：太陽〜冥王星の黄経と星座（西洋トロピカル・インド式サイデリアル／ラヒリ）、逆行かどうか、アヤナーンシャ、各星座の解説ページURL。CORS対応・APIキー不要です。

例：1990年5月1日 12:30 東京 →

3. まとめてダウンロードできるデータ

月（西洋・インド式）と金星・火星・水星の星座入れ替わり日時（1940〜2030年）を CSV・JSON で配布しています。データのページへ →

4. AIアシスタント用 MCP サーバー

Claude・ChatGPT・Cursor などの AI アシスタントから「私の月星座は？」「次の水星逆行はいつ？」に答えられる、無料のリモート MCP サーバーです。認証不要・Streamable HTTP（JSON 応答）。

https://genesis-astro-guide-r2owtywexa-an.a.run.app/mcp

claude mcp add --transport http genesis-astro https://genesis-astro-guide-r2owtywexa-an.a.run.app/mcp

{
  "mcpServers": {
    "genesis-astro": { "type": "http", "url": "https://genesis-astro-guide-r2owtywexa-an.a.run.app/mcp" }
  }
}

calculate_birth_chart_signs：西洋（トロピカル）とインド式（サイデリアル・ラヒリ）の太陽〜冥王星の星座、月のナクシャトラ、アセンダント／ラグナ
get_retrograde_periods：水星・金星・火星・木星・土星の逆行期間（2025〜2027年）
get_sign_ingresses：水星・金星・火星の星座入り日時（1940〜2030年）
get_current_sky：いまの天体位置

OpenAPI 仕様：/openapi.json · /llms.txt · GitHub ↗

5. 使い方の条件

無料・登録不要で、商用サイトにも貼れます。計算結果を表示するときは「GenesisCore 占星術ガイド」へのリンクを残してください。短時間に大量のリクエストを送るのは控えてください。計算は天文計算ライブラリ Astronomy Engine 2.1.19 によるもので、コードは GitHub で公開しています。 GitHub ↗