nanami-astro — API

星図計算を
あなたのアプリに。

AI占い・鑑定サービスを作りたい方向け

占いロジックをゼロから作る必要はありません。
ホロスコープ・四柱推命・トランジットの計算結果をJSON形式で取得し、ChatGPT・Claude などのLLMに直接組み込めます。

Swiss Ephemeris準拠 REST API / JSON 認証: X-API-Key LLM対応設計

すぐに組み込める形で返却されます

POST /api/calc/combined
# レスポンス(抜粋)
interpreted_tags:
  - saturn_pressure
  - aries_drive
writing_hints:
  tone:
    warmth: 80
    mystical: 30
handoff_yaml: "..."
raw_data:
  western: { ... }
  shichu: { ... }
  transit: { ... }

LLMに渡すための計算層として設計されています

3システムを統合取得

西洋占星術・四柱推命・トランジットを1リクエストで取得。combined APIならクレジット3消費で全データを一括取得できます。

{}

LLM向け構造データ

生データに加え、AIが解釈しやすい interpreted_tagshandoff_yaml を同梱。ハルシネーションを抑制します。

日別トランジット付き

最大31日分の日別トランジットを朝・昼・夜のタイムポイント付きで取得。「今日の星の動き」をそのままAIに渡せます。

海外出生地対応

timezoneパラメータでタイムゾーンを指定。lat/lonと整合性を保てば世界中の出生地に対応できます。

DB保存なし

APIはJSONを返すだけで、ユーザーデータの保存は行いません。プライバシーに敏感なサービスにも組み込めます。

デモAPIで即確認

APIキー不要のデモエンドポイント(/api/demo/*)で、購入前にレスポンス構造を確認できます。

用途に合わせて4つのAPIを選択できます

POST /api/calc/western 西洋占星術(ネイタル・小惑星) 1 credit
POST /api/calc/shichu 四柱推命(命式・十神・大運) 1 credit
POST /api/calc/transit トランジット(日別・朝昼夜) 1 credit
curl -X POST https://chart.nanami-astro.com/api/calc/combined \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_api_key" \
  -d '{"birth_date":"1990-01-01","birth_time":"12:00",
     "birth_place":"東京都","lat":35.6812,"lon":139.7671,
     "gender":"female","target_date":"2026-05-01",
     "timezone":"Asia/Tokyo","period":"day"}'

AIに渡すための3つのレイヤー

interpreted_tags AI解釈レイヤー
- id: saturn_pressure
  label: 責任・制限・継続課題
  strength: 2
  basis: [Saturn sq orb=1.2]
  writing_hint: 焦らず整える...

# AIが直接使える形で構造化
# ハルシネーション抑制済み
handoff_yaml そのままAIに渡せるYAML
# プロンプトに貼るだけで使える
# YAML文字列として返却

natal:
  sun: Capricorn 10°24'
  moon: Aquarius 18°02'
  asc: Aries 04°51'
transit: [ 31 days... ]
raw_data 生計算データ
# 天体位置・アスペクト・ハウス
# 独自処理・分析に活用

western.natal.bodies.Sun:
  sign: Cap
  degree: 10.24
  house: 10
  retrograde: false
ai_prompt_context AI向け指示セット
role: 構造分析型の占星術鑑定
instruction: interpreted_tags
            を主軸に...
caution:
  - 運命断定を避ける
  - 不安を煽らない

# プロンプト設計不要で使える

用途に合わせて2つのプラン

⚠️ クレジットは購入単位ごとに独立しています。複数回の購入分を合算することはできません。使い切りを想定してご購入ください。