n8n

Last updated 2026年11月6日 Markdownとして開くエージェント設定

4つのノードからなるワークフロー：入力は出生データ、途中でAPIから取得したネイタルチャート、出力は太陽、月、アセンダントのサインです。これを n8n 2.39.7 にインポートし、2026-09-17 の本番環境で実行した結果は以下の通り、返されたものと同じです。

AstroWay ノード

手動の HTTP Request の代わりにノード @astroway/n8n-nodes-astroway を使用できます。これには 730 の API 操作が用意されたアクションとして、ネイタルチャート、シナストリー、トランジット、ヴェーダ占星術、Human Design、BaZi、数秘術、タロットなどがあります。

self‑hosted の n8n で Settings → Community Nodes → Install を開き、@astroway/n8n-nodes-astroway と入力して確認します。n8n は 2026-10-23 にこのノードを審査済みにしたため、n8n Cloud では何もインストールせずにノードパネルから追加できます。
AstroWay API のクレデンシャルを作成し、キーを貼り付けます。n8n は GET /v1/auth/keys/me でキーを検証し、これはクレジットを消費しません。キーにエンドポイントのスコープが設定されている場合は auth/keys/me を追加し、そうでなければ検証は Forbidden を返しますが、スコープ内の呼び出しは動作します。
AstroWay ノードを追加し、グループと操作を選択します。例: Core → Natal Chart。必須フィールドはすでにリストにあり、任意フィールドは Add field で追加できます。

ノードはレスポンスの data の一部と、例えば INVALID_INPUT のような API エラーコードを返します。これを AI エージェントのツールとして接続できます。

以下はノードを使わず、通常の HTTP Request で同じ計算を行った例です。これは任意の n8n、特に Cloud でも動作します。

まず、セクション自動化用キーに記載の通り、スコープ chart のキーを作成します。

1. キーをクレデンシャルとして追加

キーは n8n の credentials ストレージに保存され、ノードには保存されないため、エクスポートされたワークフローに含まれません。

n8n で新しいクレデンシャルタイプ Header Auth を作成します。
Name: X-Api-Key.
Value: あなたのキー。
AstroWay API key という名前で保存します。以下のワークフローはこの名前のクレデンシャルを探します。

2. ワークフローをインポート

n8n-natal-chart.json をダウンロードし、空のワークフローを開いてファイルの内容をキャンバスに貼り付けるか、ワークフローメニューからファイルインポートを使用します。

内部には4つのノードがあります：

Start, Manual Trigger ノード: テスト時にワークフローを起動します。
Birth data, Edit Fields (Set) ノード: 1人分の date, time, timezone, latitude, longitude を設定します。
AstroWay chart, HTTP Request ノード: POST /v1/chart を呼び出します。
Big three, Edit Fields (Set) ノード: 経度をサイン名に変換します。

3. 実行

ワークフローを実行します。Big three は次を返します：

{
  "sun": "Taurus",
  "moon": "Capricorn",
  "rising": "Virgo",
  "offset_used": 4
}

offset_used は UTC からのオフセットで、サーバーが Europe/Kyiv の 1990-05-15 に見つけた値は 4 です。手動で書くことが多い 3 ではありません。

HTTP Request ノードの設定方法

Method: POST.
URL:
```
https://api.astroway.info/v1/chart
```
Authentication: Generic Credential Type.
Generic Auth Type: Header Auth, credential AstroWay API key.
Send Body: 有効化。
Body Content Type: JSON.
Specify Body: Using JSON.

ボディは式で設定されているため、前のノードからの値がそのまま渡されます：

{{ JSON.stringify({ date: $json.date, time: $json.time, timezone: $json.timezone, latitude: $json.latitude, longitude: $json.longitude }) }}

サインの計算方法

Big three の各フィールドは式です。サインは経度を 30 で割り、下方向に丸めたインデックスとしてリストから取得します：

{{ ['Aries','Taurus','Gemini','Cancer','Leo','Virgo','Libra','Scorpio','Sagittarius','Capricorn','Aquarius','Pisces'][Math.floor($json.data.houses.ascendant / 30)] }}

太陽と月の場合、経度は $json.data.planets.find(p => p.name === 'Sun').longitude と 'Moon' から同様に取得します。

自分のデータを入力

Start と Birth data を実際に使用するトリガー（フォーム、Webhook、またはテーブルの新しい行）に置き換え、上記の5つの名前にフィールドをマッピングします。確認すべき点が2つあります：

timezone は空にできません。 空の値は 400 で拒否されるため、フィールドをマッピングするか、座標が確実なら auto を設定してください。
座標は必須です。 API は都市名をジオコーディングしません。フォームが場所だけを尋ねる場合は、AstroWay chart の前にジオコーディングステップを追加してください。