开放数据端点

字段说明（sky.json）

顶层是一个对象，包含当日的行星、月相、相位与近期事件：

字段	含义
generated_at	生成时刻（UTC，ISO 8601）
planets[]	每颗行星：key / zh / lon（黄经）/ sign_zh / deg / retro
moon	月亮：黄经、星座、度数，以及 phase.name 与 phase.illum（照亮百分比）
aspects[]	主要相位：p1 / p2（行星 key）、type（英文）与 type_zh、orb（误差）、kind（soft/hard/conj）
events[]	近期天象（节气、朔望）的名称与时刻
scores	12 星座当日指数（本站算法，见计算方法页）

实时示例

当前快照里，月亮位于 巨蟹座 1.2°， 月相为 亏凸月（照亮 79.1%）。 直接从 /data/sky.json 取即可：

curl -s https://zodiac.mengstone.com/data/sky.json | jq '.moon'

几条常用查询

# 今天火星在哪个星座
curl -s .../data/sky.json | jq -r '.planets[] | select(.key=="mercury") | "\(.zh) \(.sign_zh) \(.deg)°"'

# 哪些行星在逆行
curl -s .../data/sky.json | jq -r '[.planets[] | select(.retro) | .zh] | join("、")'

# 下一次满月是什么时候
curl -s .../data/calendar.json | jq -r '.[] | select(.kind=="full_moon") | .at' | head -1

# 今年水星逆行有几次（calendar 里数 *_retro_start）
curl -s .../data/calendar.json | jq '[.[] | select(.kind=="mercury_retro_start")] | length'

# 当前所有逆行区间
curl -s .../data/retro.json | jq -r '.[] | select(.end != null) | "\(.zh) \(.start[0:10]) → \(.end[0:10])"'

许可与引用

数据本身（行星位置、月相、节气、逆行区间）属于天文计算的结果，可自由使用， 包括商业用途。我们的要求只有一条：注明来源，因为读者需要能回去核对。

推荐写法：

行星黄经数据来自星轨终端（astronomy-engine, ECT 真黄道）
https://zodiac.mengstone.com/data/

不建议直接转载本站的判读文字（那是人工撰写的），数据可以随便用。

怎么取：稳定端点与传输

每天会变的数据集中在 /data/today.json——固定地址、字段向后兼容， 适合脚本或 AI 工具直接接。完整快照与历史数据用 /data/sky.json、 /data/calendar.json、/data/retro.json。

所有 JSON 端点以 Content-Encoding: gzip 传输（体积约为明文的三分之一）， 请按 HTTP 标准解压；robots.txt、llms.txt 与 IndexNow 校验文件不压缩。

精度与已知限制

行星黄经与 Meeus 算例交叉校验：太阳平均误差 0.0034°、最大 0.0091°；月亮平均 0.0145°、最大 0.0369°。 坐标系统为 ECT（真黄道）。详见计算方法。

注意：scores 是本站算法的相对排序，不是概率，也不适合用来做统计研究。