jisu-astro

极速数据星座运势（Jisu Astro）

基于 星座运势 API 的 OpenClaw 技能，支持：

使用技能前需要申请数据，申请地址：https://www.jisuapi.com/api/astro/

• 星座列表（/astro/all）：获取 12 星座的 ID、名称、日期范围和图标。
• 星座运势查询（/astro/fortune）：按星座 ID 和日期查询今日、明日、本周、本月、本年星座运势。

可用于对话中回答「我是什么座」「今天白羊座运势怎样」「帮我看看这个月的感情/工作运」等问题。

环境变量配置

# Linux / macOS
export JISU_API_KEY="your_appkey_here"

# Windows PowerShell
$env:JISU_API_KEY="your_appkey_here"

脚本路径

脚本文件：skills/astro/astro.py

使用方式与请求参数

1. 获取星座列表（/astro/all）

python3 skills/astro/astro.py all

返回结果示例（节选自 极速数据文档）：

[
  {
    "astroid": "1",
    "astroname": "白羊座",
    "date": "3-21~4-19",
    "pic": "http://api.jisuapi.com/astro/static/images/baiyang.png"
  },
  {
    "astroid": "2",
    "astroname": "金牛座",
    "date": "4-20~5-20",
    "pic": "http://api.jisuapi.com/astro/static/images/jinniu.png"
  }
]

字段说明：

• astroid：星座 ID（1–12）
• astroname：星座名称（如 白羊座、金牛座）
• date：星座日期范围
• pic：星座图标地址

2. 星座运势查询（/astro/fortune）

python3 skills/astro/astro.py fortune '{"astroid":1,"date":"2016-01-19"}'

请求 JSON 示例：

{
  "astroid": 1,
  "date": "2016-01-19"
}

返回结果示例（节选自 极速数据文档）：

{
  "astroid": "1",
  "astroname": "白羊座",
  "year": {
    "date": "2016",
    "summary": "未来一年将是白羊座历经艰辛终于寻得新的突破的一年。",
    "money": "上半年收入还算稳定，但也不太会有意料之外的收入，需要花钱的地方倒是不少。",
    "career": "十月之前，都相对还是白羊座的蛰伏期。",
    "love": "与事业运类似，今年的桃花运也主要集中在下半年爆发。"
  },
  "week": {
    "date": "2016-01-17~01-23",
    "money": "偏财机会继续受重视。本职工作收入受压。",
    "career": "太阳本周转入朋友宫，对事业的执着感下调，会寻觅新的圈子。",
    "love": "一夜情几率高……",
    "health": "性能量高强，小心纵欲伤身。",
    "job": "方向有变，高新行业值得你更多关注。"
  },
  "today": {
    "date": "2016-01-19",
    "presummary": "你需要思考自身价值观是否符合当下环境。",
    "star": "处女座",
    "color": "黄色",
    "number": "5",
    "summary": "4",
    "money": "4",
    "career": "4",
    "love": "3",
    "health": "80%"
  },
  "tomorrow": {
    "date": "2016-01-20",
    "presummary": "今天你有些悲观哦。",
    "star": "巨蟹座",
    "color": "青绿色",
    "number": "4",
    "summary": "3",
    "money": "3",
    "career": "3",
    "love": "3",
    "health": "77%"
  },
  "month": {
    "date": "2016-1",
    "summary": "本月，事业对你而言是非常重要的。",
    "money": "火星入资源宫，热烈关注偏财。",
    "career": "木星上旬开启在工作宫的逆行……",
    "love": "心灵刹那的触动和性的爆发，高度吻合。"
  }
}

常见字段：

• 顶层：astroid, astroname
• today / tomorrow：date, presummary, star（贵人星座）, color, number, summary, money, career, love, health
• week / month / year：date, summary, money, career, love, 以及本周的 job、health 等。

脚本不会对内容做拆分或转换，而是原样返回 result，方便代理按需挑选段落进行摘要或重写。

常见错误码

来自 极速数据星座运势文档 的业务错误码：

系统错误码：

在 OpenClaw 中的推荐用法

1. 用户提供生日或星座问题：「1995-04-10 是什么座？今天和本周运势如何？」
2. 代理先调用：astro all 获取 12 星座的日期范围，基于生日确定用户星座对应的 astroid。
3. 然后调用：astro fortune '{"astroid":1,"date":"2025-03-02"}' 获取白羊座的今日/本周/本月/本年运势。
4. 从返回结构中选择合适粒度（例如今日 + 本周 + 本月），对 summary、money、career、love、health 等字段进行整理和摘要，用自然语言给出贴合用户问题的解读。