エンジニアリングノート
エフェメリッドの精度、計算アーキテクチャ、MCPプロトコル、その他のドキュメントに収まらない細かいことについて。
AIエージェント向けに作成されたドキュメント、ヒトだけのためではない
従来のドキュメントは人間向けに作られ、見栄えの良いHTML、コードハイライト、ナビゲーションが特徴です。しかし、現在docsへのトラフィックの半分はエージェントやアシスタントで、レンダリングではなくplain-textが必要です。追加した機能は、各ページの.mdコピー、llms.txt、機械可読仕様、dropdown「ChatGPT / Claudeで開く」、inline try-itです。
→APIの数秘術: 1つのルートで5つの計算システム
ほとんどのAPIは数秘術を持たないか、ピタゴラス式のシステムだけを提供します。当社は5つの完全なシステム（ピタゴラス式、ハルデア式、2つのカバラ式、ヴェーダ式）それぞれ10件の計算を、1つのパラメータ化されたルートで提供します。プラス、22アルカナの運命マトリックス。
→型付けされたMCP出力: 600以上のツールがoutputSchemaを持つ理由
ほとんどのMCPサーバーはエージェントに型付けされていないJSONを返します - モデルは応答の形式を推測する必要があります。私たちは600以上のツールのための厳密なoutputSchemaを公開しています。これがどのように機能し、どのようなバグをstrict-modeクライアントで開き、どのように公開スキーマを通じて修正したかを解説します。
→カタログマップ: AstroWay の 700+ エンドポイントの構成
API は 57 グループにわたる 700 以上のエンドポイントに成長しました - ネイタルチャートから BaZi、ジオマンティー、SVG マップのレンダリングまで。カタログがドメインに分割され、すべての呼び出しが単一パターンで行われる方法と、必要なエンドポイントを素早く見つける方法を解説します。
→精度をどう管理しているか: swetest と NASA に対する CI
占星術 API の精度は、天体暦まわりのリファクタリング 1 回で簡単に劣化します。その防御策を解説します: アプリと API で共有する単一の Swiss Ephemeris コア、基準チャートに対する数百の固定スナップショット、そして PR ごとの swetest CGI、Kerykeion、Prokerala、NASA 日食カタログとの三角測量。
→3つの公式SDK: TypeScript、Python、PHP - 生のcurlの代わりに
生のHTTPは動作しますが、型付けされたクライアントは時間を節約します: パスの自動補完、リクエストとレスポンスの型、408/409/429/5xx用の組み込みリトライ、Stainlessスタイルのエラーヒエラルキー。3つの公式SDK - @astroway/sdk (npm)、astroway (PyPI)、astroway/sdk (Packagist) - と、それらが1つのOpenAPI契約から生成される方法を解説します。
→Free Astrology API: Which One Has the Best Free Tier in 2026?
A side-by-side of free tiers across the major astrology APIs - credits, request caps, card requirements - and how much you can actually build for free.
→Horoscope API Tutorial: Build a Daily Horoscope Feature
Add daily, weekly and monthly horoscopes to your app via API - sign-based text vs transit-based personalization - with TypeScript and Python code.
→