# アストロロジカル API で構築 AstroWay

Source: https://astroway.info/ja/developers/
Language: ja
Updated: 2026-05-28

アストロロジカル API · v1

700 以上のエンドポイント、3 つの独自 SDK、Swiss Ephemeris による高精度。匿名の無料プラン - キーなしで始められます。

[無料のキーを取得する](https://api.astroway.info/dashboard/sign-up) クイックスタート 10K クレジット/月 · カード不要

## クイックスタート

APIキーなしで今日のホロスコープを取得：

```
curl "https://api.astroway.info/v1/embed/daily-horoscope?sign=virgo"
```

### 登録して無料のキーを取得

[無料キーの取得 - 1ヶ月あたり10Kクレジット、カード不要](https://api.astroway.info/dashboard/sign-up)

### あなたのキーでの最初のリクエスト

```
curl -G "https://api.astroway.info/v1/chart" \
-H "X-Api-Key: aw_live_…" \
--data-urlencode "datetime=1990-06-15T14:30:00+03:00" \
--data-urlencode "lat=50.45" --data-urlencode "lon=30.52"
```

[料金プラン](https://astroway.info/shop/)を参照してください。料金プランの制限とエンドポイントごとのクレジットのコスト

## 認証

3つの料金プラン。あなたに合ったプランをお選びください。

| 料金プラン | 認証 | 制限 | ウォーターマーク |
| --- | --- | --- | --- |
| **匿名** | 鍵なし | /v1/embed/* のみ · IPあたり30リクエスト/時 | はい |
| **無料鍵** | `X-Api-Key: aw_live_…` | 月10,000クレジット | はい |
| **有料** | `X-Api-Key: aw_live_…` | インディー 50K / スターター 200K / プロ 800K / ビジネス 3.5M | いいえ（Pro+） |

### ドメインへの紐付け

有料キーは最初のリクエスト時に1つのドメインに紐付けられます。変更は自身で管理画面から行え、月3回まで可能です。WordPressプラグインのインストールにより、コードを変更せずにヘッダーX-AstroWay-Site-URLが自動送信されます。

### エラー処理

- `401` — X-Api-Key が欠けているか無効です
- `402` — この料金には、このエンドポイントは含まれていません（例：HDエンドポイントでHD Packを利用していない場合）
- `403` — ドメインの不一致 (ドメイン ≠ Origin ヘッダー)
- `429` — リクエストの制限を超過または月間クレジットを使用した (Retry-After ヘッダーが設定されています)

## 埋め込みウィジェット

直接埋め込み iframe - どの HTML サイトでも動作し、JS ローダーは不要です。匿名プラン、IP 訪問者あたり 1 時間あたり 30 リクエスト。

### 今日のホロスコープ

```
<iframe src="https://api.astroway.info/v1/embed/daily-horoscope?sign=virgo"
width="100%" height="320" loading="lazy" frameborder="0"></iframe>
```

### ホロスコープ ホイール

```
<iframe src="https://api.astroway.info/v1/embed/natal-wheel?datetime=1990-06-15T14:30:00%2B03:00&lat=50.45&lon=30.52"
width="600" height="600" loading="lazy" frameborder="0"></iframe>
```

### タロット ディレイ カード

```
<iframe src="https://api.astroway.info/v1/embed/tarot-daily?deck=rider-waite"
width="400" height="500" loading="lazy" frameborder="0"></iframe>
```

### 月相

```
<iframe src="https://api.astroway.info/v1/embed/moon-phase"
width="320" height="320" loading="lazy" frameborder="0"></iframe>
```

### WordPress へのインストール

[WP 用 AstroWay プラグイン ↗](https://wordpress.org/plugins/astroway/) をインストール - 設定不要の Tier 1 ウィジェット、コピー用ショートコード、Tier 2/3 用オプション API キー。

## Офіційні SDK

3つの独自SDK。完全なタイプセーフ、OpenAPI 3.1から生成。MITライセンス。リトライ機能付き、イデンプォテント

### TypeScript / JavaScript

@astroway/sdk · v1.1.0

```
npm install @astroway/sdk
```

```
import { AstroWayClient } from '@astroway/sdk';
const c = new AstroWayClient({ apiKey: process.env.ASTROWAY_KEY });
const chart = await c.natalChart({
datetime: '1990-06-15T14:30:00+03:00',
lat: 50.45, lon: 30.52
});
```

[GitHub ↗](https://github.com/astroway/astroway-typescript) · [npm ↗](https://www.npmjs.com/package/@astroway/sdk)

Node 22+ · ESM · OpenAPI 3.1 によって生成

### Python

astroway · v1.1.0

```
pip install astroway
```

```
from astroway import AstroWayClient
c = AstroWayClient(api_key="aw_live_…")
chart = c.natal_chart(
datetime="1990-06-15T14:30:00+03:00",
lat=50.45, lon=30.52,
)
```

[GitHub ↗](https://github.com/astroway/astroway-python) · [PyPI ↗](https://pypi.org/project/astroway/)

Python 3.10+ · 同期 + 非同期 · Pydantic モデル · py.typed

### PHP

astroway/sdk · v1.1.0

```
composer require astroway/sdk
```

```
use AstroWay\AstroWayClient;
$c = new AstroWayClient(apiKey: 'aw_live_…');
$chart = $c->natalChart(
datetime: '1990-06-15T14:30:00+03:00',
lat: 50.45, lon: 30.52,
);
```

[GitHub ↗](https://github.com/astroway/astroway-php) · [Packagist ↗](https://packagist.org/packages/astroway/sdk)

PHP 8.2+ · PSR-18 HTTPクライアント · Guzzleプロミス

### WordPress

WordPressサイトですか？ 無料プラグイン「[AstroWay для WordPress ↗](https://wordpress.org/plugins/astroway/)」が、ショートコードやGutenbergブロックを通じて、ナタルチャート、ホロスコープ、タロット、ノウムロジー、ヒューマンデザインを追加します。コーディング不要です。匿名でご利用いただくか、独自のAPIキーで動作します。

```
[astroway_natal date="1990-06-15" time="14:30" lat="50.45" lon="30.52"]
```

### LLM / AI-エージェント

当社は[/llms.txt ↗](https://api.astroway.info/llms.txt)を公開しており、AIエージェントによる検出に対応しています。`/v1/context/*`エンドポイント群は、ChatGPT / Claude / Geminiとの直接統合に最適化されたLLM向けXMLを返します。

### MCPサーバー（Pro+）

ネイティブサーバー Model Context Protocol は mcp.astroway.info で稼働しています。Claude Desktop または任意の MCP クライアントを接続して、ダイアログ形式で API 全体に問い合わせが可能です。Pro および Business プランに含まれています。
