Changelog what is new

すべてのインテグレーターのコードに影響する変更：新しいエンドポイント、SDKの更新、/openapi.jsonの変更、クレジット価格の修正、非推奨、重大な変更。最新のものが上にあります。サイトの内部変更はここに記録されません。

API契約は/v1/*の範囲内で安定しています。重大な変更はすべて/v2/*でリリースされ、/v1/*は少なくとも12ヶ月間引き続き動作します。

2026-05-16 — Hosted MCPエンドポイントがmcp.astroway.info/mcpで公開

@astroway/mcpは現在、2つのトランスポートモードで利用可能です。stdio（npmパッケージ）は変更なし。hosted Streamable HTTPエンドポイントが追加され、Claude $1（ブラウザのclaude.ai）、Claude $1、Cursor、Cline、その他のMCP対応クライアントでのゼロインストール統合が可能になりました。

Cursorへのワンクリックインストール：/examples/mcp/ページのcursor://anysphere.cursor-deeplink/mcp/install?...ボタン。Claude $1は+ → Add Connector → Custom（JSON編集不要）。

// Cline / Continue / Windsurf用JSON
{
  "mcpServers": {
    "astroway-hosted": {
      "url": "https://mcp.astroway.info/mcp",
      "headers": {
        "Authorization": "Bearer aw_live_..."
      }
    }
  }
}

630のツールカタログ + 12のプロンプト + 14のリソース、同じaw_test_* / aw_live_*認証（hostedモードではenv varではなくAuthorization: Bearer …ヘッダー）、同じクレジットプール。マルチテナント設計 — 各リクエストは自身のキーを含み、クレジットはキー所有者のアカウントから差し引かれます。X-Astroway-Channelはmcp-http（hosted）とmcp（stdio）で採用追跡。

なぜ2つのモードか。 stdio（npx @astroway/mcp）は、Cursor power users / プライバシー重視のインテグレーター向けに残ります — キーはマシンを離れず、ネットワークホップなし。HostedはClaude $1（remote MCPのみサポート）とゼロインストールシナリオをカバー。Stripe / Resend / GitHub MCPと同じパターン。

Healthエンドポイント — 認証不要で公開アクセス可能：

curl https://mcp.astroway.info/health
# {"status":"ok","version":"…","uptime_sec":…,"mcp_protocol_version":"2024-11-05"}

両モードの完全なドキュメント — /examples/mcp/。

2026-05-15 — 新しいエンドポイントGET /v1/auth/keys/me

APIキーのインテロスペクション。X-Api-Keyを送信すると、プラン、クレジット、ステータス、バインドドメイン、作成日時、登録元を含む完全な状態を取得。SDKコンシューマー（TS / Python / PHP / MCP）向けに便利 — ダッシュボードを参照せずに「現在のキーの状態」を確認可能。Stripe /v1/accountやGitHub /userに類似。

curl -H "X-Api-Key: aw_live_..." https://api.astroway.info/v1/auth/keys/me
# →
# {
#   "key_prefix": "aw_live_4ab...",     # 最初の11文字、完全なキーは返さない
#   "plan": "free",
#   "credits_remaining": 9830,
#   "credits_total_this_period": 10000,
#   "period_end": "2026-06-01T00:00:00.000Z",  # カレンダー上の月末
#   "status": "active",                  # active | suspended | revoked
#   "domain": null,                      # キーがバインドされたドメイン（wp-plugin keys）
#   "domain_bound_at": null,
#   "created_at": "2026-04-24T22:03:59.000Z",
#   "referrer_source": "direct"          # direct | wp_plugin | mcp | sdk | dashboard | other
# }

認証なし： 401 MISSING_API_KEY。無効なキー：401 INVALID_API_KEY。

OpenAPI 3.1仕様。 /v1/openapi.jsonが/v1/auth/keys/meを宣言。SDKコードジェネレーターは次回の再生成時にclient.auth.keys.me()を生成。

下位互換性。 古いGET /v1/keys/usage（credits_today + レート制限のみ返す）は引き続き動作 — サーバーのcronチェック用の別エンドポイント。/auth/keys/meはwp-pluginシナリオ向けに完全な状態とドメインバインディングを返す。

2026-05-14 — /horoscope/*および/interpret/*のローカライゼーション（21言語）

POST /v1/horoscope/{daily,weekly,monthly,yearly,compatibility}およびPOST /v1/interpret/{natal,synastry,transits,element,placement} — テキスト解釈を返す10エンドポイント — がクライアントの言語で応答を返すようになりました。

有効化方法：

curl -X POST https://api.astroway.info/v1/horoscope/daily \
  -H "X-Api-Key: aw_live_..." \
  -H "Accept-Language: hi" \
  -H "Content-Type: application/json" \
  -d '{"sign": "leo"}'
# → हिन्दीで応答

リゾルブ優先順位（サーバー側）：

1. body.language="de" — 明示的なper-callパラメータ（最優先）
2. Accept-Language: de, en;q=0.7 — RFC 7231のq-weighted；一致する最初のコードが勝利
3. ?lang=de — ヘッダーを制御できないクライアント向けのクエリパラメータ
4. フォールバック → uk（ソース言語）

サポート言語（21）： uk, en, de, ru, pl, es, pt, fr, it, nl, cs, ro, hu, el, tr, ar, hi, ja, ko, vi, id。不明なコードはエラーなしでukに静かにフォールバック。

OpenAPI 3.1仕様。 /v1/openapi.jsonがAccept-Language（ヘッダー）とlang（クエリ）を、これらの10エンドポイントの21コードのenumパラメータとして宣言。SDKコードジェネレーター（openapi-typescript, openapi-generator-cli）は次回の再生成時に.lang('hi')のような型指定された呼び出しを自動生成。

翻訳対象： 解釈のテキストフィールド（horoscope, interpretation, disclaimerなど）のみ。数値フィールド（longitude, latitude, score, ID-signs, ID-houses）は正規のまま — クライアントがローカルでフォーマット。セグメント標準（Vedika, DivineAPI, AstrologyAPI.com）。

範囲： 現在、解釈グループの10エンドポイントがローカライズ。計算エンドポイント（/chart, /synastry, /transits, /vedic/*, /human-design/*, /tarot/*, /numerology/*, ~690その他）は数値と正規の識別子（name: "Aries", glyph: "♈"）を変更せずに返す — クライアントは独自のlookupテーブルでローカライズ。これがセグメント標準。

下位互換性。 Accept-Language / ?lang= / body.languageなしの既存コードは以前と同様にデフォルトでukを取得。

SDKサポート（@astroway/sdk, astroway, astroway/sdk, @astroway/mcp）がコンストラクタにlangオプションを追加 — 個別のリリースはcron-applierによるstagingリポジトリで今後数週間以内に登場。

2026-05-09 — 3つのSDKリリース：TypeScript、Python、PHP

3つの公式SDKがpublicレジストリで公開 — 700以上のAPIエンドポイントをラップ。1つのOpenAPI 3.1仕様 → 3つの言語に適したクライアント。

インテグレーターにとっての意味：

• raw HTTPの型安全な代替。 IDEでのパス自動補完とリクエスト/レスポンスの型。aw.post('/chart', body=...)（Python/PHP）またはaw.client.POST('/chart', { body })（TS）のようなヘルパーメソッド — 手動のfetch / requests / Guzzleの代わり。
• 言語間で同一のインターフェース。 Astroway({apiKey, baseUrl, authScheme, timeout, retry})コンストラクタがTS / Python / PHPで同じように動作。マルチ言語プロジェクトでは認知的負荷が減少。
• 408/409/429/5xxに対する組み込みリトライ exponential backoff + full jitter。Retry-Afterヘッダーを尊重。デフォルト2回リトライ、retry={maxRetries: 0}で設定可能。
• Stainlessテンプレートのエラー階層 — Stripe / OpenAI / Cloudflare SDKと同じパターン。RateLimitError（retryAfterSeconds付き）、AuthenticationError（キーのローテート）、BadRequestError（バリデーション）、ApiError（汎用）をこの順序でキャッチ。
• 2つの認証方式。 デフォルトはX-Api-Key: aw_live_...（curl/Postmanと同じ）。またはAuthorization: Bearer aw_live_...（Stripe/OpenAI/Anthropic SDKと同じ）— コンストラクタでauth_scheme="bearer"。
• 識別ヘッダー、テレメトリーなし。 各リクエストはUser-Agent: astroway-sdk-<lang>/<version> + X-Astroway-Channel: sdk-<lang>を送信。電話連絡なし、opt-in/opt-outスイッチなし。
• OIDC + SLSA L3 provenance（TS + Python）。Sigstoreで証明された、特定のコミットからビルドされたパッケージの記録。CIに長期的なトークンなし。
• MIT、完全なソースコード公開 github.com/astroway/{astroway-typescript,astroway-python,astroway-php}。

クイックスタート：

// TypeScript / Node 20+
import { Astroway } from '@astroway/sdk';
const aw = new Astroway({ apiKey: process.env.ASTROWAY_API_KEY! });
const { data } = await aw.client.POST('/chart', { body: { date: '1990-07-14', /* ... */ } });

# Python 3.9+
from astroway import Astroway
aw = Astroway(api_key=os.environ['ASTROWAY_API_KEY'])
chart = aw.post('/chart', body={'date': '1990-07-14', ...})

// PHP 8.1+
use Astroway\Astroway;
$aw = new Astroway(['apiKey' => getenv('ASTROWAY_API_KEY')]);
$chart = $aw->post('/chart', body: ['date' => '1990-07-14', /* ... */]);

Pythonのasyncバージョン — AsyncAstrowayでasync/awaitによる同一インターフェース。PHPはsyncのみ（PHPに統一されたasyncストーリーなし）。TSはopenapi-fetchに基づくネイティブPromise。

これはalpha — フィードバックに基づき0.1.0までパブリックAPIが変更される可能性あり。alpha期間中は正確なバージョン（@astroway/sdk@0.1.0-alpha.1）を固定 — またはinstall時の最新alpha。

@astroway/mcp — Claude / Cursor / GPT向けのMCPサーバー — は引き続き別製品として並行して存在。

2026-05-07 — MCPサーバーの更新

@astroway/mcpが更新 — 現在の/openapi.jsonから手動編集なしでツールカタログを自動生成。過去数週間でAPIに追加されたすべて（compat suite、reportsエンドポイント）がClaude / Cursor / GPTに即座に表示。

インテグレーター向け：

• ツールカタログがAPIのリアルタイム状態を反映
• Path-templateエンドポイント（/v1/.../id）は、ディスクリプションパーサーを混乱させないために現時点ではスキップ
• ツールのdescriptionにコスト注釈 — Claudeが実行前に呼び出しコストを認識
• OIDC trusted publishing + SLSA L3 provenance — パッケージはpublicリポastroway/astroway-mcpの特定のコミットに証明

インストール：

npm install -g @astroway/mcp

またはClaude $1 / Cursor MCP設定：

{
  "mcpServers": {
    "astroway": {
      "command": "npx",
      "args": ["-y", "@astroway/mcp"]
    }
  }
}

ソース：public astroway/astroway-mcp（MIT）。

2026-04-11 — クロスシステム互換性（+10エンドポイント）

新しい/v1/compat/*グループ — 西洋、ヴェーディック、中国、数秘術、タロット、ヒューマンデザインの6システムによる統合互換性スコア。マルチ伝統占星術アプリケーションのUXインジケーター向けに統一メトリクス。

各エンドポイントはdisclaimerフィールドを含むJSONを返す — これはAstroWayのスコアリング手法であり、臨床的または法的声明ではない。Tier 4（100クレジット）per call — 重いクロスシステム計算。

/openapi.jsonのマニフェストが更新 — SDK / MCPが自動的に取得。

2026-03-28 — レポート + Webhooks（+17エンドポイント）

2つの新しいグループが本番環境に。

/v1/reports/*（12エンドポイント） — PuppeteerによるHTML / PDFレポート生成。api-calc側でレンダリング、署名付きダウンロードURL（TTL 24時間）。

/v1/webhooks/*（5エンドポイント） — サブスクリプション管理、イベント配信、HMAC署名。credits.low, key.created, usage.threshold, error.spikeのイベントにサブスクライブ。

curl -X POST https://api.astroway.info/v1/webhooks \
  -H "Authorization: Bearer aw_live_..." \
  -d '{"url": "https://...", "events": ["credits.low"], "secret": "wh_secret_..."}'

各配信はX-Astroway-Signature: sha256=<hmac>を含む — secretで検証。リトライポリシー：5xxで指数バックオフ、24時間で最大5回試行。

2026-03-14 — リファレンスエンドポイント：公開、キー不要、クレジット不要

14のエンドポイント/v1/reference/*（signs, planets, houses, aspects, elements, modalities, polarities, dignities, decans, nakshatras, lots, asteroids, zodiac-systems, glyphs）がX-Api-Keyなしで動作し、0クレジットに。これらは正規のlookupテーブル — 課金でゲートすることプロジェクトの見落としでした。

インテグレーターにとっての意味：

• キーなしで呼び出し可能 — 外部MCPエージェント / SDK / プレビューページが認証なしでリファレンスデータを取得可能。IPレート制限は/publicと同じ（1時間30リクエスト）が維持。
• コストマニフェスト更新 — 14パスがTIER_HALF（5クレジット）から0に移行。予算プランナーastroway_cost_estimateがこれらのパスを参照している場合、新しい呼び出しはクォータに影響しない。
• 既存クライアント キー付きでも変更なしで動作。/reference/*ではX-Api-Keyが無視される（余分なヘッダーを気にしない）。

下位互換性：200応答とJSONスキーマは変更なし、認証要件のみ削除。

2026-03-07 — ファウンダーズライフタイムディール：$299 → 一生分のIndieプラン

ファウンダーズライフタイムディールを開始 — 限定リリース。最初の100名のクライアントが**$299一回払い**で、生涯Indieプラン（月50,000クレジット）を取得、再発行なし、価格固定。

インテグレーターにとっての意味：

• 標準Indie = $5/月。ファウンダーズ = 一回$299 → 5年目で回収、以降無限ROI。プロジェクトが占星術 / 数秘術 / タロットで5年以上続く場合、ファウンダーズは回収可能。
• Webhookペイロード checkout SKU astroway-api-indie-lifetime：文字列api_keysがplan='indie', credits_limit=50000, is_lifetime=1, expires_at=NULLを取得。月額引き落とし、リニューアルwebhookなし。
• DBスキーマ： api_keysとshared_user_quotasにis_lifetime TINYINT(1)列を追加。TS型ApiKeyInfoを拡張。既存キー = is_lifetime=0（動作変更なし）。
• WP RESTエンドポイント GET /wp-json/astroway/v1/founders-countが{sold, total: 100, remaining, available}を返す — リアルタイムカウンターに使用site/components/founders/FoundersCounter.astro on /founders/。
• 100/100で自動非アクティブ化：_stock_status商品WCがフックWC woocommerce_order_status_completedで自動的にoutofstockに。その後checkoutリンクは/pricing/#indie（標準Indie $5/月）にリダイレクト。

公開ページ：/founders/（uk）+ /en/founders/（en）。サイドバー項目「Founders’ Lifetime Deal」に🚀 100 onlyバッジ。

WP商品：astroway-api-indie-lifetime、ID 30618、$299（13225 UAH）、在庫=100。チェックアウト：astroway.info/checkout/?add-to-cart=30618。

2026-03-05 — GDPR / EU居住地向けランディングページ + ProカードEUバッジ

**/eu/**を開始 — GDPRに敏感なEU開発者向けの別ページ。インテグレーターが知る必要があること：

• Pro $59 = デフォルトでEU居住地（Hetzner Nuremberg、データフローはEU内のみ、匿名化分析 — Plausible cookie-freeはロードマップ）。
• 標準DPA EnterpriseだけでなくProでも利用可能 — 標準Proで5営業日以内にメールで署名。
• DELETE /v1/me/account — GDPR消去権のエンドポイント（wp_user_idをすべてのテーブルから即座に削除）。
• /pricing/のProカードに現在は🇪🇺 GDPR対応バッジ — クリックでFAQ付きの/eu/に。
• DivineAPI / AstrologyAPI / Prokerala — US/インドホスティング、DPAはEnterpriseのみ。GDPR準拠が重要ならPro $59が最安値。

ページ：/eu/（uk）+ /en/eu/（en）。サイドナビに「GDPR / EU residency」エントリ、🇪🇺バッジ付き。

2026-03-03 — 年間前払い−25% + クレジット繰越 + Proの公開機能

インテグレーターのコードに影響する2つの変更：

• 年間割引17% → 25%（無料3ヶ月、2ヶ月から）。新しいUSD年間価格：Indie $45、Starter $171、Pro $531、Business $1791、HD/Esoteric Pack $81、Vedic Pack $171、Reports Pack $891。既存年間サブスクライバーは影響なし — 新価格は将来のサブスクリプション更新にのみ適用。/wp-json/astroway/v1/api-pricesでUSD価格を解析している場合、更新された値が自動的に返される。
• 年間サブスクライバーのクレジット繰越：未使用クレジットは次の月間サイクルに繰越、プランの月間制限の1×以内。年間プラン購入時に自動アクティブ。新しいレスポンスヘッダーで表示：
  • X-Credits-Limit: <int> — 効果的な月間制限（繰越含む）
  • X-Credits-Remaining: <int> — 以前と同じ、繰越を考慮
  • X-Credits-Rollover: <int> — 現在の繰越クレジット残高（年間のみ）
• Proプラン（$59）が現在公開で宣伝：ストリーミングエンドポイント（リアルタイム）、GDPR対応EU課金、拡張MCP（マルチエージェント / ディベート / RAG）、webhooks（10種類）。これらはProにすでにあった機能 — 以前はドキュメントで隠されていた。

DBスキーマ：api_keysとshared_user_quotasにcredit_rollover_enabled TINYINT(1) + credits_rolled_over INT UNSIGNED列を追加。初期値は既存キーすべてで0。

2026-03-01 — エンドポイントごとのクレジット価格の透明な表

700以上のエンドポイントすべての完全なクレジット内訳を含む公開ページ**/credits/**を開始。競合他社（DivineAPI, AstrologyAPI, Prokerala）はこのような表を公開していない — 固定1クレジット/呼び出しで内部ルーティングを隠している。

インテグレーターにとってこれにより3つの利点：

• 透明な経済単位 — 各エンドポイントの正確な$ / 呼び出しコスト（月額予算/pricing/ × プラン価格 = 実際の呼び出しコスト）。
• コードとの自動同期 — ビルド時にendpoint-costs.tsから表を生成。新しいエンドポイントを追加または価格を変更すると、次のデプロイでページが自動更新。
• Freeプランマーカー — 列がIndie+が必要なエンドポイントを示す（🔒アイコン、現在28エンドポイント）。

利用可能：/credits/（uk）および/en/credits/（en）。/rate-limits-credits/からのクロスリンクとStarlightサイドナビのエントリ（「新着」アイコン）。

2026-02-27 — ヴェーディックチャート、コスモグラム、日食パス、スターマップ（+6エンドポイント）

ロードマップのビジュアライゼーションカテゴリを14/14エンドポイントで完了：

• POST /v1/render/wheel-vedic-north — 北インド（ダイヤモンド）レイアウト。ハウス固定、サインはラグナに従って回転。
• POST /v1/render/wheel-vedic-south — 南インド（4×4グリッド）。サイン固定（魚座左上）、ハウスが浮動。
• POST /v1/render/wheel-vedic-east — 東インド（ベンガル）。対角線付き正方形 + 内部回転正方形。
• POST /v1/render/cosmogram — ハンブルグ学派 / コスモバイオロジー 90°ダイヤル（Ebertin 1940 + Witte 1928）。
• POST /v1/render/eclipse-path — caller提供のlat/lonトラック付き等角図法世界地図；中心線 + 指定幅の帯をレンダリング。
• POST /v1/render/star-map — 星座位置（RA/Dec）リストの立体射影、マグニチュードスケーリング付き。

すべてのレンダリング — pure SVG、headless-Chromeなし。

2026-02-25 — バイ/トリホイール + コンポジット + バイオリズム（+4エンドポイント）

SVGメカニクスを拡張する4つの新しいビジュアライザー：

• POST /v1/render/bi-wheel — 2つの同心円：内側ナタル + 外側トランジット（またはプログレッシブ）の惑星リング。
• POST /v1/render/tri-wheel — 3つの円：ナタル + プログレッシブ + トランジット。
• POST /v1/render/composite — 2つのナタル入力からのコンポジットチャートレンダリング（中点コンポジット）。
• POST /v1/render/biorhythm — 3つのサイクルの正弦波グラフ：身体（23日）、感情（28日）、知性（33日）。

ここでの計算は同じ、レンダリングのみ；バイホイールでは2つのチャートのすべての惑星が並列で計算（Promise.all）。

2026-02-24 — ビジュアライゼーション：SVGレンダリング（+4エンドポイント）

4つの新しいエンドポイントがナタルチャートと関連ビジュアルのSVGレンダリングを返す。純粋なサーバーサイド — Puppeteer/headless-Chromeなし、遅延約10ms、Freeプランで無料。

• POST /v1/render/wheel-western — 西洋ホイール（サインリング + ハウスリング + 惑星 + アスペクトライン）。
• POST /v1/render/aspect-grid — 符号とオーブ付きのアスペクト三角行列。
• POST /v1/render/moon-phase — 照明された月の円盤；SVGとilluminationFraction, phase, waxingを返す。
• POST /v1/render/timeline — 期間内のトランジットイベントのガントスタイル（callerがevents配列を送信）。

オプション：size, theme（light / dark / console）, format（jsonは{ svg, byteLength }を返す、svgは直接image/svg+xmlを返す）。基本tier — 呼び出し1回2クレジット。

2026-02-23 — /v1/openapi.jsonの型指定スキーマ（612エンドポイント、98%）

/v1/openapi.jsonがリクエストボディとレスポンスデータの両方の完全な機械読み取り可能な仕様に。3つの連続する段階で612 / 624 POSTエンドポイントを型指定：

• リクエストボディ — 386エンドポイントを型指定 components.schemas経由（128の再利用可能コンポーネント）。その中には5つの共通（ChartInput, TwoChart, MultiChart, NatalTarget, NatalWrapper）と123のローカル（DashaInput, MuhuratWindow, ChartWithTnp, WheelWesternなど）が含まれ、継承のためallOfによる合成（DashaInput extends ChartInput）。
• レスポンスdata — 612エンドポイントを型指定 マニフェストのep.response例を巡回するインファラーにより：{type: 'object', properties: {...}} 代替 {type: 'object'}。ナタルチャートは現在data.planets[], data.houses.{ascendant, mc, cusps}, data.aspects[]を実際のフィールド型で宣言。
• 残り12エンドポイント — マニフェストの不明瞭なshorthand例によるdasha pratyantar/sookshma — {type: object}のまま。下位互換性あり、次のリリースで追加。

インテグレーターにとっての意味：

• OpenAPIクライアントを再生成 — openapi-typescript, openapi-fetch, swagger-codegenがRecord<string, unknown>の代わりに型指定フィールドを持つインターフェースを作成。リクエストボディとレスポンスdataのコード補完がネイティブに動作。
• /postman/astroway-api.jsonのPostmanコレクションが同じ型で更新 — インポートし、すべての型指定エンドポイントで自動補完を取得。

下位互換性：以前の形式{"type": "object"}は許容的 — すべての既存クライアントは変更なしで動作し続ける。

2026-02-21 — 価格の再計算：レポート統合、Business +500K、Free強化

インテグレーターに影響する3つの価格変更：

• レポートを5,000クレジットに統一 — /v1/reports/transit-yearly, /v1/reports/vedic-kundli, /v1/reports/lal-kitabを10,000クレジットから5,000クレジットに（半額）。すべてのPDFレポートが同じ価格 — パッケージ予算の数学が簡単。
• Businessプラン +500Kクレジット/月 — Businessプランが現在3,500,000クレジット/月（以前3,000,000）に、同じ価格$199。既存サブスクライバーは次の課金サイクルから自動的に増加した制限を取得。
• Freeプラン：/v1/reports/*は有料プランが必要 — 12のPDFエンドポイント（reports/natal, synastry, child, business, career, love, money, transit-yearly, vedic-kundli, lal-kitab, human-design, tarot）がFreeキーで402 PLAN_UPGRADE_REQUIREDを返す。残りの機能 — チャート、シンアストリー、予報、ホロスコープ — Freeで引き続き利用可能。

Freeキーでこれらのエンドポイントの1つを呼び出している場合 — Indie（$5/月）以上にアップグレード、またはPDFレンダリングなしで同様のコンテンツのためのJSON同等（/v1/chart, /v1/synastryなど）に切り替えてください。

2026-02-19 — GoogleおよびGitHubによる認証（+2エンドポイント）

エコシステム全体で1つのアカウント — astroway.infoまたはapp.astroway.infoで登録したユーザーが同じメール/SSOで開発者コンソールにログイン、注文履歴、クレジット、APIキーを表示。

• GET /v1/auth/oauth/google/start?return=<path> — Google OAuthフローを開始。
• GET /v1/auth/oauth/github/start?return=<path> — GitHub OAuthフローを開始。

コールバックは/dashboard/oauth/callback#access_token=&refresh_token=&user=へのリダイレクトで終了 — その後ダッシュボードが/v1/auth/login後と同様にトークンを永続化。メールが通常のフォームで登録済みでプロバイダーからemail_verified=trueの場合 — アカウントがリンクされ、新しいアカウントは作成されない。

2026-02-17 — レポートパック（$99 / 500,000クレジット）+ ホワイトラベル含む

PDFレポート開発者向けプラン — $0.99で100 PDF/月、デフォルトでホワイトラベル：

• reports_packプラン（$99/月または$990/年）は500,000クレジットと200リクエスト/分を提供。
• **アクセスは/reports/*（12種類のPDF：ナタル、シンアストリー、子供、ビジネス、キャリア、恋愛、金銭、トランジット年間、ヴェーディッククンドリ、ラルキタブ、ヒューマンデザイン、タロット）+ /whitelabel/*（カスタムロゴ + 色 + ドメイン）に制限。その他すべて402 PLAN_PACK_MISMATCH（upgrade_to: pro）を返す。
• ホワイトラベルが標準で含まれる — ブランド化PDFのためにEnterpriseにアップグレードする必要なし。
• 超過料金$3 / 10,000クレジット（Proと同じ）、支出制限スイッチが利用可能。
• PDFの21言語ローカライズ、A4フォーマット、署名付きURL CDN経由で配信（TTL 24時間）。

APIプランenum現在：free | indie | starter | pro | business | enterprise | hd_pack | esoteric_pack | vedic_pack | reports_pack。新しいWCスラッグ：astroway-api-reports-pack。

2026-02-15 — クロススクール：Jaiminiヨガ + Lal KitabおよびKPドーシャ（+17エンドポイント）

17エンドポイント — クロススクールのヨガとドーシャの垂直方向を完了。

• Jaimini Yogas (5) — /vedic/yogas/jaimini/{raja, dhana, daridra, viparita, full}。chara karakas（AK / Amk / PK）に基づく。
• Lal Kitab dosha varianti (6) — /vedic/doshas/lal-kitab/{manglik, kalsarpa, pitra, shrapit, rin, full}。LK特有の無効化とupayas。
• KP dosha varianti (6) — /vedic/doshas/kp/{manglik, kalasarpa, pitra, sade-sati, kemadruma, full}。BPHSルール + KPサブロードチェーン。Sade Sati — トランジット認識（targetDate必要）。

ソース：Jaimini Sutras 2.x + Sanjay Rath, K. Ashant + R.D. Mathur, K.S. Krishnamurti Reader I-VI。価格：TIER_3（50クレジット）。

2026-02-13 — Vedic Pack ($19 / 100,000クレジット)

ヴェーディック占星術のための別プラン — 165エンドポイント、Starter価格：

• vedic_packプラン（$19/月または$190/年）は100,000クレジットと100リクエスト/分を提供。
• **アクセスはヴェーディック名前空間（/vedic/*, /nakshatras, /ashtakavarga, /vedic-divisional）に制限。他のすべてのエンドポイントは402 PLAN_PACK_MISMATCHを返す。
• カバレッジ：16 vargas D1-D60、panchang（7）、shadbala（7）、yogas（7）、doshas（7）、compatibility ashtakoot（6）、muhurat（12カテゴリ）、8つのダシャシステム × 5レベル（40）、KP、Lal Kitab、Jaimini。
• 同じ価格で2.5-5倍のチャート Prokerala Ruby（~5K kundlis/月 vs 彼らの1-2K）。

APIプランenum現在：free | indie | starter | pro | business | enterprise | hd_pack | esoteric_pack | vedic_pack。新しいWCスラッグ：astroway-api-vedic-pack。

2026-02-09 — Lal Kitab：完全パッケージ（+12エンドポイント）

1939-1952年の匿名ウルドゥー語MSSに基づく北インドヴェーディック学校。完全な学校 — YELLOW（内在的 — modern著者間の違いがある単一学校）。

• /vedic/lal-kitab/teva — 固定ハウスチャート（house = sign）。
• /vedic/lal-kitab/lal-kundali — 12ハウスグリッドレイアウト。
• /vedic/lal-kitab/kismat + /prosperity — 運とdhana yogaスコア。
• /vedic/lal-kitab/dasha（35y）+ /varshphal + /life-graph — タイミング。
• /vedic/lal-kitab/debts — 6 Rin（Pitri/Stree/Kanya/Atma/Rishi/Daiva）検出 + 改善策。
• /vedic/lal-kitab/remedies — 惑星ごとのupayas（日 / マントラ / 寄付）。
• /vedic/lal-kitab/{planet-house-effect, blind-house, sleeping-house}。

レスポンスに表示される免責事項。ソース：K. Ashant Vol I-VI + R.D. Mathur + U.C. Mahajan。

2026-02-06 — エソテリックパック（$9 / 200,000クレジット）

エソテリック/占い開発者向けの新しい追加プラン — $9/月で180エンドポイント：

• esoteric_packプラン（$9/月または$90/年）は200,000クレジットと60リクエスト/分を提供。
• **アクセスはエソテリック/占い空間（/tarot/*, /numerology/*, /reference/*, /esoteric/*, /geomancy/*, /runes/*, /palmistry/*, /iching*, /sabian-symbols, /destiny-matrix/ladini, /djamaspa）に制限。他のすべてのエンドポイントは402 PLAN_PACK_MISMATCHを返す。
• 他のプランと組み合わせ不可 — 1つのキーで — HDパックに類似した別拡張。

APIプランenum現在：free | indie | starter | pro | business | enterprise | hd_pack | esoteric_pack。新しいWCスラッグ：astroway-api-esoteric-pack（月額 + 年額バージョン）。/v1/keysで明示的なplanなしでキーを作成した場合 — 変更なし。

2026-02-02 — BaZi + Zi Wei Dou Shu（+17エンドポイント）

中国ゾディアック + 風水に続く3番目の中国カテゴリ：

• BaZi (5) — /bazi/{year-pillar, month-pillar, four-pillars, element-balance, year-pillar-decade}。年 + 月の柱は正規、日 + 時の柱は香港天文台とのクロス検証まで延期（異なるソースが異なるJDアンカーを提供）。
• Zi Wei Dou Shu MVP (12) — /ziwei/{twelve-palaces, main-stars, full-chart, palace-destiny, palace-siblings, palace-spouse, palace-children, palace-wealth, palace-health, palace-travel, palace-career, palace-property}。MVP — 宮殿の意味 + 14の主要星リスト。完全チャートは延期（専門的な月のepehemerisが必要）。

APIは現在505エンドポイントを公開 — 広い競合他社（Astrology-API.io）と同等。

2026-01-30 — ワンネス（+9エンドポイント）

9つのワンネスエンドポイント — 医療占星術 + 食事 + ヨガ + 水晶など。教育目的のみ — 医療アドバイスではありません、各レスポンスに免責事項。

• POST /v1/wellness/medical-astrology — 伝統的Melothesiaによる体の支配。
• POST /v1/wellness/diet — 要素ごとの食品（focus / emphasize / avoid）。
• POST /v1/wellness/yoga — サインごとの焦点 + アーサナ + プラナヤマ。
• POST /v1/wellness/exercise — 要素ごとの強度 + 推奨/避ける。
• POST /v1/wellness/mental-health — 鏡の要素プロファイル + dominantElement + 強み/弱み + 対処。
• POST /v1/wellness/sleep-cycles — 月のフェーズによる睡眠アドバイス。
• POST /v1/wellness/herbs — サインの惑星支配者によるハーブ（Culpeper 1653）。
• POST /v1/wellness/crystals — サイン + 意図による水晶。
• POST /v1/wellness/cycle — 年齢ベースのワンネスマイルストーン（土星リターン、天王星オポジションなど）。

ソース：Pelletier 1978 + Culpeper 1653 + Judy Hall Crystal Bible。Tier — 2クレジット（cycle = 1クレジット）。

2026-01-27 — マヤンカレンダー（+8エンドポイント）

マヤンブロック：古典的Tzolkin + Haab + Long Count + Calendar Round + Lord of the Night、プラスDreamspell（現代Argüelles 1990）。

• POST /v1/mayan/tzolkin — 260日神聖カレンダー（数字1-13 + 20の名前）。
• POST /v1/mayan/haab — 365日市民カレンダー（18ヶ月 × 20 + 5日Wayeb）。
• POST /v1/mayan/long-count — 5桁位置表記baktun.katun.tun.uinal.kin。
• POST /v1/mayan/calendar-round — 組み合わせTzolkin+Haab（52年サイクル）。
• POST /v1/mayan/lord-of-night — 9日サイクル（G1-G9）。
• POST /v1/mayan/full — すべての古典を1回の呼び出しで。
• POST /v1/mayan/compatibility — トーン/名前/要素/方向によるペア互換性。
• POST /v1/mayan/dreamspell — 現代Argüelles（kin 1-260、tone × seal）。

ソース：Goodman-Martínez-Thompson相関（Thompson 1935 + Lounsbury 1976）。検証アンカー：2012-12-21 = Long Count 13.0.0.0.0 ✓（Bak’tunロールオーバー）。

2026-01-23 — Sthira + Shoola Dasha（+10エンドポイント）

5段階の完全なカスケード（maha, antar, pratyantar, sookshma, prana）を持つ2つのJaimini学校rasi-dasha：

• Sthira — 種子 = Brahma惑星のサイン、MDは12サイン前進（7y可動 / 8y固定 / 9y二重）。
• Shoola — 種子 = stronger_rasi(asc, asc+6)、MDは12×9y前進、antardasaSeedOption ∈ 3オプション。

10ダシャ学校 × 5レベル = 50エンドポイントのセットを完了。ソース：BPHS Adhyayas 49-50 + Jaimini Sutras 2.x。

2026-01-19 — ペット + ビジネス + 金融（+36エンドポイント）

3カテゴリを1回の出荷：

• ペット（14） — /pet/{birth-chart, sun-sign-meaning, personality, temperament, training-style, diet-by-sign, grooming-by-element, exercise-needs, communication-style, play-style, health-tips, best-names, lucky-day, owner-pet-compatibility}。免責事項：娯楽のみ — 獣医ケアではありません。
• ビジネス（12） — /business/{founder-personality, leadership-style, ideal-industry, founding-chart, electional-day, name-suggestions, team-compatibility, customer-archetype, marketing-style, risk-profile, ideal-partner-sign, expansion-timing}。免責事項：戦略的発想、法的/税務アドバイスではありません。
• 金融（10） — /financial/{investor-archetype, risk-tolerance, spending-style, savings-tips, career-money-style, wealth-house, lucky-numbers, lucky-day, market-timing, wealth-cycle}。⚠️ 投資アドバイスではありません — 各レスポンスに強化された免責事項。

Tier — 2クレジット（金融市場タイミング/富のサイクル = 3クレジット）。

2026-01-16 — Jaimini分析スイート（+10エンドポイント）

10のJaimini分析エンドポイント — chara/naisargika karakas、padas（A1..A12 + S1..S12 + M1..M12 + graha arudhas）、Upapada、rasi/graha drishti、Karakamsa（AK in D9）、実行中のダシャ概要、基本Jaiminiヨガ。

ソース：Jaimini Sutras 1-2 + BPHS Adhyayas 26/47。

2026-01-09 — ステータスページ + AIエージェント + デフォルトbase URL

• 公開ステータスページ：https://api.astroway.info/status — 正常稼働時間、レイテンシp50/p95/p99、60秒キャッシュ。
• AIエージェント用llms.txt：https://api.astroway.info/llms.txt — Claude / ChatGPT / Perplexity Codeエージェント向けの構造化された指示。
• ドキュメント、MCPサーバー、SDK、Postmanコレクションのデフォルトbase URL — api.astroway.info/v1（古いapi-calc.astroway.infoからの301リダイレクト付き）。

2025-12-30 — Tribhagi、Shatabdika、Shodashottari Dashas（+15エンドポイント）

完全なカスケードを持つ3つのnakshatra-dashaシステム：

• Tribhagi — 1/3スケールVimshottari（40年サイクル）。
• Shatabdika — 100年サイクル、7惑星（影なし）。
• Shodashottari — 116年サイクル、8惑星（Rahuなし）。

ソース：BPHS Adhyaya 46。

2025-12-25 — クレジットプラン：5-tier再調整 + Free 5K → 10K

18の競合他社監査後にクレジットtierを再調整。Freeプランは現在月10,000クレジット（以前5,000）。典型的なユースケース（ナタルチャート + 7トランジット）のコスト割合が約22%削減。APIに重大な変更なし — 経済のみ。

2025-12-17 — 中国ゾディアック + 風水Kua（+8エンドポイント）

中国占星術の最初のブロック、基本層（BaZi + Zi Wei Dou Shu — 以降）：

• POST /v1/chinese/zodiac/animal — 年の動物 + 完全な柱（Geng-Wu、Wood-yangなど）。
• POST /v1/chinese/zodiac/element — 固定 + 循環五行要素yin/yang。
• POST /v1/chinese/zodiac/inner-animal — 内部動物（月のブランチ）。
• POST /v1/chinese/zodiac/secret-animal — 秘密の動物（時間のブランチ — time必要）。
• POST /v1/chinese/zodiac/compatibility — San Heトリナ / Liu Chong対立ペアによるペア互換性。
• POST /v1/chinese/feng-shui/kua — 個人Kua番号 + 東/西グループ。
• POST /v1/chinese/feng-shui/lucky-directions — 4つの幸運 + 4つの不運なコンパス方向。
• POST /v1/chinese/feng-shui/bagua — 9つの人生分野のバグアマップ、要素 + 色付き。

ソース：60-jiazi正規 + L. Skinner Living Earth Manual（1976）+ Lillian Too。価格tier — 呼び出し1回2クレジット。Lichunカットオフ = 2月4日（1900–2100で±1日精度）。

2025-12-09 — クオリティパス：Vedicカテゴリで24のバグ修正

6つの並列deep-researchエージェントによる24の計算バグ修正。最も重要な：Mangal doshaキャンセル（BPHSに従い自身/昇格火星がキャンセル）、Pitru doshaトリガー（Sun-Saturn vs Sun-Rahu）、コンポジットDavison ARMCドリフト、ACG子午線精度。スナップショットテスト追加：47。

2025-12-02 — Vedic Compatibility + Muhurat（+18エンドポイント）

• Compatibility (6) — Ashta-Kootaマッチング（Varna/Vasya/Tara/Yoni/Graha-Maitri/Gana/Bhakoot/Nadi）+ Mangal dosha compat + Bhrigu概要。
• Muhurat (12) — 結婚、ビジネス、旅、教育、手術、婚約者、mahurtaタイプ（abhijit, vijaya, amrit, brahma）の選挙。

ソース：BPHS + Muhurta Chintamani。

2025-11-29 — KP（Krishnamurti Paddhati）：完全パッケージ（+10エンドポイント）

K.S. Krishnamurti 1971の正規KP学校の10エンドポイント。

• /vedic/kp/{cusps, sub-lords, planet-cuspal-position} — Placidus cusps + 4レベルサブロードチェーン（sign / star / sub / sub-sub）。
• /vedic/kp/ruling-planets — Day/Hora + Asc + Moonチェーン、重複排除。
• /vedic/kp/horary — KPホラリー番号1..249 → ASC経度ルックアップ。
• /vedic/kp/significators — 惑星ごとの一次 / 二次 / 三次。
• /vedic/kp/sub-sub-lord — 任意の恒星経度でのチェーン。
• /vedic/kp/asc-sub — Ascendantサブロード。
• /vedic/kp/fortuna — Part of Fortune（昼/夜）+ KPチェーン。
• /vedic/kp/transit-kp — 現在の位置 + KPチェーン。

アルゴリズム：Vimshottari比例サブ分割（27星 × 9サブロード）。ソース：K.S. Krishnamurti Reader I-VI（1971-77）。

2025-11-22 — Vimshottari + Yogini + Ashtottari + Kalachakra Dashas（+20エンドポイント）

完全なカスケード（maha, antar, pratyantar, sookshma, prana）を持つ4つの古典的Vedicダシャシステム：

• Vimshottari — 120年サイクル、9惑星。
• Yogini — 36年サイクル、8ヨギニ。
• Ashtottari — 108年サイクル、8惑星（Ketuなし）、Ardradi伝統。
• Kalachakra — サインベースダシャ、paramayuはpadaごとに変化（100/85/83/86）。

ソース：BPHS Adhyaya 46 + Saravali。PyJHora 7.02とクロス検証。

2025-11-08 — Chara Dasha（Jaimini K.N. Rao）（+5エンドポイント）

K.N. Rao（1995）によるJaiminiのrasi-dasha学校。方向 = 可動/二重サインのラグナは前進、固定サインは逆。サソリ座（Mars+Ketu）と水瓶座（Saturn+Rahu）の共同支配ルール。

2025-10-25 — MCPサーバー + AIゲートウェイ

• MCPサーバー @astroway/mcp — Claude $1、Cursor、Cody向けのModel Context Protocol。APIの各エンドポイントがMCPツールとして利用可能。
• AIゲートウェイ — 別のプライベートマイクロサービスai.astroway.infoがプロバイダーチェーン（Gemini Flash → Groq Llama → OpenRouter → Cerebras → SambaNova → Mistral）でLLMリクエストを処理。
• TypeScript SDKは別リリースで予定 — 現在はhttps://api.astroway.info/v1/openapi.jsonのOpenAPIコードジェネレーターを使用（openapi-typescript / openapi-fetchが612の型指定リクエスト/レスポンスペアを持つ型指定クライアントを生成）。

2025-10-08 — Vedic Yogas + Doshas Parashara（+14エンドポイント）

• Yogas (7) — Raja, Dhana, Dharma-Karmadhipati, Pancha-Mahapurusha, Gajakesari, Adhi + コンポジット。
• Doshas (7) — Mangal, Kaal Sarp, Pitru, Shrapit, Grahan, Guru-Chandal + コンポジット。

ソース：BPHS Adhyayas 36-39, Phaladeepika。

2025-08-10 — Vedic Vargas D1-D60 + Panchang + Shadbala（+31エンドポイント）

• 16 Vargas D1-D60 (16) — Rasi (D1)からShashtiamsa (D60)まで、BPHS Adhyaya 7に従う。
• Panchang (8) — tithi, vara, nakshatra, yoga, karana + 日の出/日没, abhijit, rahu kaal。
• Shadbala (7) — 各惑星の6つの強さ源 + コンポジット（Sthana, Dig, Kala, Cheshta, Naisargika, Drig）。

2025-05-18 — エソテリック辞書 + 水晶/天使/夢（+30エンドポイント）

リファレンス辞書の拡張：15のエソテリック概念（チャクラ、コーシャ、タトヴァ、グナ）+ 15の水晶/天使/夢ルックアップテーブル。エッジでキャッシュ（Cloudflare R2）。

2025-03-12 — リファレンス用語集 + タロットレノルマン（+24エンドポイント）

• リファレンス（14） — 辞書 signs, planets, houses, aspects, nakshatras, 固定星, Sabian symbols。
• タロットレノルマン（10） — 36カードシステム：シングル、3カード、9カード、グランドタブロー、質問別。

2024-11-15 — タロットマセレーヌ（+20エンドポイント）

20のエンドポイントマセレーヌデッキ：スプレッド（シングル、3カード、クロス、5カード、ケルト十字、年先）、カードの意味、逆位置モード、質問別。ソース：Camoin / Jodorowsky公開リファレンス。

2024-08-25 — 数秘術 — 完全パッケージ：ピタゴラス + カルデアン + カバラ + ヴェーディック（+40エンドポイント）

4つの数秘術システム × 各10エンドポイント：ライフパス、エクスプレッション、ソウルアージュ、パーソナリティ、誕生日、マチュリティ、現在のパーソナル年/月/日、ネーム互換性。

ソース：ピタゴラス（Cheiro 1908）、カルデアン（Cheiro）、カバラヘブライ語ゲマトリア、ヴェーディックカルデアンインド。

2024-05-08 — タロットライダーウェイトスミス（+35エンドポイント）

35のエンドポイントRWSデッキ：すべての正規スプレッド（シングル、3カード、ケルト十字、年先、関係、5カードホースシュー、7カード楕円、決定、状況、月次）、カードの意味（正位置 + 逆位置）、質問別、デイリーカード、デッキシャッフル。

ソース：2021年以降パブリックドメインのSmith画像、Waite「Pictorial Key」1909年パブリックドメイン。

2024-02-20 — AIホロスコープ生成 + 解釈（+12エンドポイント）

自然言語解釈の生成：

• /horoscope/{daily, weekly, monthly} — テキストホロスコープ。
• /interpret/{natal, transit, synastry, compatibility} — 詳細な解釈。

プロバイダーチェーン：GPT-4 → Anthropic Claude → フォールバックGroq。

2023-11-28 — デスティニーマトリックス（ラディニ）（+1エンドポイント）

/destiny-matrix/ladini — Natalia Ladiniのシステム（ロシア/CIS市場）。明確な免責事項付きの単一著者メソッド。

2023-09-20 — アスペクトタイムライン + ハーモニクス + サイクリックインデックス（+12エンドポイント）

拡張アスペクト分析：

• /aspect-timeline — N日先のアスペクトの正確な瞬間。
• /harmonics/{2..12} — ハーモニックチャート。
• /cyclic-index — アンドレ・バルボの社会的緊張のサイクリックインデックス。
• /sabian-symbols — Marc Edmund Jonesの360シンボル。

2023-05-10 — アストロカルトグラフィー + ローカルスペース + 測地（+18エンドポイント）

ジオ占星術：

• /acg + /acg-zones — 惑星のアストロカルトグラフィーライン。
• /local-space — ローカルスペース地平線。
• /parans — パラーン（Bernadette Brady）。
• /relocation — 引越しチャート。
• /zenith + /horizon + /geodetic — 追加ジオエンジン。
• /ccg-analysis — CCG/CMG詳細ジオ分析。

ソース：Jim Lewis Astro*Carto*Graphy、Sepharial Theory of Geodetic Equivalents、Bernadette Brady。

2023-02-15 — ヒューマンデザインモジュール（+12エンドポイント）

完全なヒューマンデザインエンジン：

• /human-design — ボディグラフ（ゲート、チャネル、センター、タイプ、プロファイル、権限、戦略、環境、視点）。
• /hd/incarnation-cross — 転生クロス + 4ゲート。
• /hd/{channels, gates, profiles, definition, authority, strategy, environment, perspective, mental-projector, etc}。

ソース：Ra Uru Hu The Human Design System + Chetan Parkyn + Lynda Bunnell。

2022-08-20 — サーバー側シンアストリー + コンポジット

関係占星術（シンアストリー、コンポジット、Davison）がサーバー側で実装。最初に/v1/synastry, /v1/composite, /v1/davison経由で利用可能。関係分析への拡張のマーカー。

Solar Fire / Astrodienstと検証 — 平均的な計算でメソッドの誤差範囲内