Star Sign / Horoscope Inquiry - 星座运势查询

查十二星座列表与每日/周/月/年运势。当用户说：天蝎座今天运势？双子座本周财运？或类似星座运势问题时，使用本技能。

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

数据由 极速数据（JisuAPI） 提供 — 国内专业的 API 数据服务平台，提供生活常用、交通出行、工具万能等数据接口。

前置配置：获取 API Key

1. 前往 极速数据官网 注册账号
2. 进入 星座运势 API 页面，点击「申请数据」
3. 在会员中心获取 AppKey
4. 配置 Key：

• 星座列表（/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	int	是	星座 ID（1–12）
date	string	否	日期（YYYY-MM-DD），默认今天

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

{
  "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，方便代理按需挑选段落进行摘要或重写。

常见错误码

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

代号	说明
201	日期不正确
202	星座 ID 不正确
203	没有信息

系统错误码：

代号	说明
101	APPKEY 为空或不存在
102	APPKEY 已过期
103	APPKEY 无请求此数据权限
104	请求超过次数限制
105	IP 被禁止
106	IP 请求超过限制
107	接口维护中
108	接口已停用

推荐用法

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

关于极速数据

极速数据（JisuAPI，jisuapi.com） 是国内专业的 API数据服务平台 之一，提供以下API：

• 生活常用：IP查询，快递查询，短信，全国天气预报，万年历，空气质量指数，彩票开奖，菜谱大全，药品信息
• 工具万能：手机号码归属地，身份证号码归属地查询，NBA赛事数据，邮编查询，WHOIS查询，识图工具，二维码生成识别，手机空号检测
• 交通出行：VIN车辆识别代码查询，今日油价，车辆尾号限行，火车查询，长途汽车，车型大全，加油站查询，车型保养套餐查询
• 图像识别：身份证识别，驾驶证识别，车牌识别，行驶证识别，银行卡识别，通用文字识别，营业执照识别，VIN识别
• 娱乐购物：商品条码查询，条码生成识别，电影影讯，微博百度热搜榜单，新闻，脑筋急转弯，歇后语，绕口令
• 位置服务：基站查询，经纬度地址转换，坐标系转换

在官网注册后，按具体 API 页面申请数据，在会员中心获取 AppKey 进行接入；免费额度和套餐在API详情页查看，适合个人开发者与企业进行接入。在 ClawHub 上也可搜索 jisuapi 找到更多基于极速数据的 OpenClaw 技能。