SDK · あらゆる言語向け AstroWay

リリース済み

// maintained by AstroWay · same-day OpenAPI sync

ホステッドMCP - Claude Web / Desktop / Cursor向けゼロインストール

mcp.astroway.info/mcpでホストされたストリーミングHTTPエンドポイント - npmパッケージと同じ700+ツールカタログで、ローカルインストール不要。1つのURL、1つのBearerヘッダーで、AIクライアントがAstroWayエコシステム全体を利用可能。マルチテナント：Bearerキーを所有するアカウントからクレジットが差し引かれます。

https://mcp.astroway.info/mcp SDK ガイドを読む →

mcp released

Claude / Cursor / GPT向けMCPサーバー (stdio)

公式 @astroway/mcp: AstroWay APIの700以上のエンドポイントをAIエージェント向けツールとして公開。Claude Desktop、Cursor、GPT MCPクライアントと互換。stdioモード - 鍵はローカルに保持され、ネットワークホップなし。ゼロインストールシナリオではホスト型エンドポイントを使用してください。

npx -y @astroway/mcp SDK ガイドを読む →

typescript released

AstroWay API用TypeScript SDK

公式 @astroway/sdk - openapi-fetch (~6 KBランタイム)の薄いラッパー。全ての771+エンドポイントに対しIDEでパス自動補完+リクエスト/レスポンス型を提供。Stainlessスタイルのエラー階層、408/409/429/5xx時の組み込みリトライ、OIDC + SLSA L3 provenance。

npm install @astroway/sdk SDK ガイドを読む →

python released

AstroWay API 用 Python SDK

公式 astroway on PyPI - Astroway (同期) + AsyncAstroway (非同期) on httpx。同一のサーフェス - 両クライアントに同じ API。ステンレススタイルのエラーハイアラキー、408/409/429/5xx におけるリトライ、PEP 561 型付きパッケージ。Python 3.9+、トラステッドパブリッシャー OIDC。

pip install astroway SDK ガイドを読む →

php released

AstroWay API 用 PHP SDK

公式 astroway/sdk Packagist に - Guzzle 7 + PSR-18 で構築。PHP 8.1+ (読み取り専用プロパティ、コンストラクタープロモーション)。ステンレススタイルのエラーハイアラキー、408/409/429/5xx に対する組み込みリトライミドルウェア、2 つの認証スキーム (X-Api-Key デフォルトまたは Bearer)。

composer require astroway/sdk SDK ガイドを読む →

react released

公式の @astroway/react が npm にあります - @astroway/sdk 上の薄い Stripe スタイルのラッパーです。AstrowayProvider はクライアントを React コンテキストに持ち上げます。useAstroway、useAstrowayQuery、useNatalChart フックは、外部依存関係がゼロの SWR スタイルの { data, error, loading } トリプルを返します。React 18+、Next.js App Router (「use client」経由で)、Vite、CRA で動作します。

npm install @astroway/react @astroway/sdk react SDK ガイドを読む →

ui released

AstroWay Webコンポーネント (alpha)

Natalホイール、月相、相性、タロット、星座占いを、どのサイトでも使えるシンプルなHTML要素として提供するよ。CDNからの<script>タグ1つかnpm installでOK。チャートはAPIと同じコードで描画するから、ページ上のホイールは/v1/renderの結果と一致する。Alpha: 属性名は1.0までに変わるかも。

npm install @astroway/ui@alpha SDK ガイドを読む →

symfony released

AstroWay API 用 Symfony バンドル

公式 astroway/sdk-symfony on Packagist - astroway/sdk 上のバンドル。Symfony Flex を介して自動登録、標準の config/packages/astroway.yaml を介して構成、任意のコントローラーまたはサービスに注入可能な Astroway\Astroway サービスを公開。Symfony 6.4 LTS および 7.x、PHP 8.1+ と互換性がある。

composer require astroway/sdk-symfony:^0.1.0-alpha SDK ガイドを読む →

laravel released

AstroWay API 用 Laravel ServiceProvider

公式 astroway/sdk-laravel on Packagist - astroway/sdk 上の ServiceProvider + ファサード。composer.json extra.laravel.providers 経由で自動検出、Astroway\Astroway をコンテナシングルトンとして登録、config を php artisan vendor:publish 経由で公開。コントローラーに注入するか、ファサード Astroway::post("/chart", ...) を使用。Laravel 10/11/12、PHP 8.1+ で動作。

composer require astroway/sdk-laravel:^0.1.0-alpha SDK ガイドを読む →

go released

AstroWay API 用の Go SDK

公式の AstroWay Go モジュールだよ。すべての API エンドポイントがメソッドとして提供され、例えば aw.Chart.Compute のように、呼び出しごとにコンテキストが付く。408/409/429/5xx のリトライは Retry-After を尊重し、POST では Idempotency-Key を保持するから、リトライしても二重課金されない。エラーは errors.Is でテストでき、レスポンスは自分の型にデコードできる。標準ライブラリだけで、Go 1.22+ に対応。

go get github.com/astroway/astroway-go SDK ガイドを読む →

csharp released

AstroWay API の C# SDKだよ

パッケージ Astroway.Sdk: すべての API エンドポイントが async メソッドとして提供され、例えば aw.Chart.ComputeAsync のように、CancellationToken でキャンセルできるよ。408/409/429/5xx のリトライは Retry-After を尊重し、失敗の種類ごとに固有の例外が出るし、レスポンスは自分のレコードにデシリアライズできるんだ。.NET Standard 2.0 と .NET 8: .NET Framework 4.7.2+、.NET 6/8/9、Unity もサポートしてるよ。

dotnet add package Astroway.Sdk SDK ガイドを読む →

4 行で最初のリクエスト

// TypeScript · Python、PHP、Laravel、Symfony、React でも同じパターン

npm install @astroway/sdk 完全な例 →

import { Astroway } from '@astroway/sdk';

const aw = new Astroway({ apiKey: process.env.ASTROWAY_API_KEY! });

const { data: chart } = await aw.client.POST('/chart', {
  body: {
    date: '1990-07-14',
    time: '14:30:00',
    timezoneOffset: 3,
    latitude: 50.4501,
    longitude: 30.5234,
    houseSystem: 'P',
  },
});

// aw.client.POST is the raw typed fetch, so `chart` is the { ok, data } envelope
console.log(chart.data.houses.ascendant);  // 212.0952574979425