2024년부터 2030년까지 수성, 금성, 화성, 목성, 토성, 천왕성, 해왕성, 명왕성의 역행 정지(유, retrograde station) 및 순행 정지(direct station), 사전 그림자(pre-shadow)와 사후 그림자(post-shadow) 경계, 그리고 태양과의 합 또는 충(카지미, cazimi)의 분 단위 정밀 협정세계시(UTC) 시각과 더불어 1900년부터 2050년까지의 모든 수성 역행(476주기) 데이터다. 미 항공우주국(NASA) 제트추진연구소(JPL)의 DE421 천체력(ephemeris)으로부터 스카이필드(Skyfield)를 사용해 계산되었으며, 파일을 재생성하는 스크립트가 포함되어 있다.

실시간 달력 및 JSON API: cazimi.live. 방법론: cazimi.live/methodology.

역행 천체력

모든 행성의 역행 정지, 그림자 경계 및 태양과의 합에 대한 정확한 시각을 NASA JPL의 DE421 천체력으로부터 계산하여 UTC 기준 분 단위까지 나타냈다.

- 8개 행성, 2024~2030년: 수성, 금성, 화성, 목성, 토성, 천왕성, 해왕성, 명왕성: data/retrogrades.json

- 수성, 1900~2050년: 전체 476개 역행 주기: data/mercury-1900-2050.json

- 이를 생성하는 스크립트: tools/retrogrades.py (파이썬, Skyfield https://rhodesmill.org/skyfield/)

이는 cazimi.live(https://cazimi.live), 해당 사이트의 JSON API(https://cazimi.live/methodology#api), MCP 서버 및 아이폰 앱 'Mercury Retrograde: Cazimi'(https://apps.apple.com/us/app/cazimi-mercury-retrograde/id6760207689)의 기반이 되는 데이터세트다. 저자는 이것이 운세(horoscope)가 아니라 천문학적 시간 데이터라고 밝힌다.

각 시점이 의미하는 바

모든 위치는 지구 중심에서 본 해당 날짜의 겉보기 지심 황경(apparent geocentric ecliptic longitude of date)이다. 전체 방법론은 cazimi.live/methodology(https://cazimi.live/methodology)에 있다.

필드별 의미는 다음과 같다.

- retro: 역행 정지(Station retrograde)로, 행성의 황경 변화율이 음수로 전환되는 분 단위 시각이다.

- direct: 순행 정지(Station direct)로, 황경 변화율이 다시 양수로 전환되는 분 단위 시각이다.

- pre: 사전 그림자(Pre-shadow) 시작 시점으로, retro 이전에 아직 순행 중인 행성이 순행 정지 시점의 도수에 마지막으로 도달하는 시각이다.

- post: 사후 그림자(Post-shadow) 종료 시점으로, direct 이후에 행성이 역행 정지 시점의 도수를 처음으로 통과하는 시각이다.

- cazimi: 수성과 금성이 역행 기간 중 태양과 합을 이루는 시각(내합, inferior conjunction)이다.

- cazimiWindow: 전통적인 17분(17′) 카지미 구간의 시작과 끝 시각이다.

- opposition: 화성부터 명왕성까지가 역행 기간 중 태양으로부터 180° 위치에 놓이는 분 단위 시각이다.

- *Degree: 해당 시점의 위치를 회귀황도대(tropical sign) 별자리의 도(degree)와 분(arcminute)으로 나타낸 값이다.

- sign: 역행 정지 시점의 별자리다.

시각은 가장 가까운 분 단위로 반올림한 ISO 8601 UTC 형식이며, 예를 들어 2027-02-09T17:36Z와 같이 표기한다.

예시, 2027년 2월 수성 역행:

{ "sign": "Pisces", "pre": "2027-01-25T18:58Z", "retro": "2027-02-09T17:36Z", "retroDegree": "5°59′ Pisces", "cazimi": "2027-02-18T16:39Z", "cazimiDegree": "29°48′ Aquarius", "cazimiWindow": ["2027-02-18T13:28Z", "2027-02-18T19:50Z"], "direct": "2027-03-03T12:32Z", "directDegree": "20°55′ Aquarius", "post": "2027-03-23T14:58Z" }

실시간 API 및 MCP 서버

동일한 수치 데이터가 인증 키 없이 CORS 개방 상태로 제공되며, 매일 00:05 UTC에 재구축된다.

curl https://cazimi.live/v1/planets/today.json # 오늘 어떤 행성이 역행 중인지 조회 curl https://cazimi.live/v1/mercury/next.json # 다음 수성 역행 조회 curl https://cazimi.live/v1/mars/cycles.json # 모든 화성 주기 조회

AI 어시스턴트는 https://cazimi.live/api/mcp에 있는 읽기 전용 MCP 서버(Streamable HTTP, 인증 없음, 8개 도구)를 사용할 수 있다. 이 서버는 공식 MCP 레지스트리에 live.cazimi/retrogrades(server.json)로 게시되어 있다. Claude에서는 설정 → 커넥터 → 사용자 지정 커넥터 추가(Settings → Connectors → Add custom connector)로 이동해 해당 URL을 붙여넣으면 된다.

재생성

pip install -r requirements.txt 명령어로 패키지를 설치한다. 시작 연도, 종료 연도, 행성 목록, 출력 파일 순으로 인자를 지정하며, 첫 실행 시 de421.bsp(17MB)를 다운로드한다. 실행 명령어는 python tools/retrogrades.py 2025 2030 mercury,venus,mars,jupiter,saturn,uranus,neptune,pluto out.json이다.

DE421은 1900년부터 2050년까지를 포괄하며, 이것이 수성 표의 범위를 결정한다. 8개 행성 전체를 실행하는 데는 몇 분이 걸린다.

라이선스 및 인용

데이터(data/)는 CC BY 4.0(LICENSE-DATA) 라이선스를 따르며, 코드(tools/)는 MIT(LICENSE) 라이선스를 따른다. 이 시각 데이터를 게시할 경우 https://cazimi.live 링크와 함께 Cazimi의 출처를 밝혀야 한다. 인용 메타데이터는 CITATION.cff 파일에 있다.

자체 소프트웨어와 일치하지 않는 시각을 발견했다면 해당 행성, 시각, 출처를 포함해 이슈를 등록해 달라.