n8n

Last updated 2026년 11월 6일 Markdown으로 보기 에이전트 설정

Workflow із чотирьох вузлів: на вході дані народження, посередині натальна карта з API, на виході знаки Сонця, Місяця й Асцендента. Його імпортовано в n8n 2.39.7 і запущено проти продакшену 2026-09-17, а результат нижче саме той, що він повернув.

AstroWay 노드

수동 HTTP Request 대신에 노드 @astroway/n8n-nodes-astroway를 사용할 수 있다. 이 노드에는 네이털 차트, 시냅스트리, 트랜짓, 베다 점성술, Human Design, BaZi, 수비학, 타로 등 730개의 API 작업이 미리 정의된 액션으로 제공된다.

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 부분만 반환하고, API 오류 코드 예시로 INVALID_INPUT을 반환한다. 이를 AI Agent의 도구로 연결할 수 있다.

아래는 노드 없이 일반 HTTP Request로 수행한 동일한 계산이다. 이는 모든 n8n, 특히 Cloud에서도 동작한다.

먼저 자동화용 키 섹션에 설명된 대로 chart 영역을 가진 키를 만든다.

1. 키를 자격증명으로 추가

키는 노드가 아니라 n8n의 credentials 저장소에 보관되므로 내보낸 워크플로우에 포함되지 않는다.

n8n에서 새로운 Header Auth 타입의 credential을 만든다.
Name: X-Api-Key.
Value: 너의 키.
AstroWay API key라는 이름으로 저장한다. 아래 워크플로우는 바로 이 이름의 credential을 찾는다.

2. 워크플로우 가져오기

n8n-natal-chart.json을 다운로드하고, 빈 워크플로우를 열어 파일 내용을 캔버스에 붙여넣거나 워크플로우 메뉴에서 파일 가져오기를 사용한다.

내부에는 네 개의 노드가 있다:

Start, Manual Trigger 노드: 테스트 시 워크플로우를 시작한다.
Birth data, Edit Fields (Set) 노드: 한 사람의 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, 혹은 테이블의 새 행)로 교체하고, 위의 다섯 개 필드와 매핑한다. 확인해야 할 두 가지:

timezone은 비워둘 수 없다. 빈 값은 400 오류를 반환하므로 필드를 매핑하거나 좌표가 신뢰할 수 있으면 auto를 설정한다.
좌표는 필수이다. API는 도시 이름을 지오코딩하지 않으므로, 폼이 장소만 묻는 경우 AstroWay chart 앞에 지오코딩 단계를 추가한다.