← 返回 Skills 市场
499
总下载
10
收藏
0
当前安装
5
版本数
在 OpenClaw 中安装
/install huangli
功能描述
按公历日期查询农历、宜忌、吉神凶煞等黄历信息。当用户说：明天宜不宜搬家？这周五适合领证吗？或类似黄历择日时，使用本技能。
使用说明 (SKILL.md)
\r \r
极速数据黄历查询（Jisu Huangli）\r
\r
数据由 极速数据（JisuAPI） 提供 — 国内专业的 API 数据服务平台，提供生活常用、交通出行、工具万能等数据接口。\r \r 按指定的年、月、日查询农历、星座、生肖、胎神、五行、冲煞、宜忌、吉神凶神、财神方位、星期等黄历信息。\r 数据范围覆盖 1900–2100 年，可用于回答「今天适合干什么」「这天宜嫁娶吗」「农历和生肖是什么」等问题。\r \r
前置配置：获取 API Key\r
\r
# Linux / macOS\r
export JISU_API_KEY="your_appkey_here"\r
\r
# Windows PowerShell\r
$env:JISU_API_KEY="your_appkey_here"\r
```\r
\r
## 脚本路径\r
\r
脚本文件：`skills/huangli/huangli.py`\r
\r
## 使用方式\r
\r
黄历接口只有一个：`/huangli/date`，脚本直接接收 JSON 请求体。\r
\r
### 查询指定日期的黄历（/huangli/date）\r
\r
```bash\r
python3 skills/huangli/huangli.py '{"year":2015,"month":10,"day":27}'\r
```\r
\r
请求 JSON 示例：\r
\r
```json\r
{\r
"year": 2015,\r
"month": 10,\r
"day": 27\r
}\r
```\r
\r
### 请求参数\r
\r
| 字段名 | 类型 | 必填 | 说明 |\r
|--------|--------|------|------|\r
| year | string | 是 | 年 |\r
| month | string | 是 | 月 |\r
| day | string | 是 | 日 |\r
\r
脚本会对 `year`、`month`、`day` 做必填校验，缺失时直接报错退出。\r
\r
## 返回结果示例\r
\r
脚本直接输出接口的 `result` 字段，结构与官网示例一致，例如（节选自\r
[极速数据文档](https://www.jisuapi.com/api/huangli)）：\r
\r
```json\r
{\r
"year": "2015",\r
"month": "10",\r
"day": "27",\r
"yangli": "公元2015年10月27日",\r
"nongli": "农历二〇一五年九月十五",\r
"star": "天蝎座",\r
"taishen": "厨灶碓外西南",\r
"wuxing": "涧下水",\r
"chong": "冲（庚午）马",\r
"sha": "煞南",\r
"shengxiao": "羊",\r
"jiri": "天牢（黑道）满日",\r
"zhiri": "天牢（黑道凶日）",\r
"xiongshen": "灾煞 天火 大煞 归忌 天牢 触水龙",\r
"jishenyiqu": "天德 月德 时德 福德 民日 天巫 普护 鸣犬对",\r
"caishen": "西南",\r
"xishen": "西南",\r
"fushen": "正东",\r
"suici": [\r
"乙未年",\r
"丙戌月",\r
"丙子日"\r
],\r
"yi": [\r
"纳采",\r
"成服"\r
],\r
"ji": [\r
"入宅",\r
"上梁",\r
"谢土"\r
],\r
"eweek": "TUESDAY",\r
"emonth": "October",\r
"week": "二"\r
}\r
```\r
\r
其中：\r
\r
- `yangli` / `nongli`：阳历 / 农历完整描述 \r
- `star` / `shengxiao`：星座和生肖 \r
- `yi` / `ji`：宜做的事和忌讳的事，通常是字符串数组 \r
- `suici`：岁次（干支），数组形式 \r
- 其余字段对应文档中的黄历、方位、吉凶信息。\r
\r
## 常见错误码\r
\r
来自 [极速数据黄历文档](https://www.jisuapi.com/api/huangli) 的业务错误码：\r
\r
| 代号 | 说明 |\r
|------|------------|\r
| 201 | 日期不正确 |\r
| 203 | 没有信息 |\r
\r
系统错误码：\r
\r
| 代号 | 说明 |\r
|------|--------------------------|\r
| 101 | APPKEY 为空或不存在 |\r
| 102 | APPKEY 已过期 |\r
| 103 | APPKEY 无请求此数据权限 |\r
| 104 | 请求超过次数限制 |\r
| 105 | IP 被禁止 |\r
| 106 | IP 请求超过限制 |\r
| 107 | 接口维护中 |\r
| 108 | 接口已停用 |\r
\r
## 推荐用法\r
\r
1. 用户提问：「帮我看看 2025 年 5 月 20 日黄历如何，适合结婚吗？」 \r
2. 代理构造 JSON：`{"year":2025,"month":5,"day":20}` 并调用： \r
`python3 skills/huangli/huangli.py '{"year":2025,"month":5,"day":20}'`。 \r
3. 从返回结果中读取 `yi` / `ji`、`jiri`、`zhiri`、`xiongshen`、`jishenyiqu` 等字段，判断是否宜嫁娶、是否有明显凶神，结合用户问题做自然语言总结。 \r
4. 如用户只关心农历、生肖或星座，可直接读取 `nongli`、`shengxiao`、`star` 等字段给出简要回答。\r
\r
## 关于极速数据\r
\r
**极速数据（JisuAPI，[jisuapi.com](https://www.jisuapi.com/)）** 是国内专业的 **API数据服务平台** 之一，提供以下API：\r
\r
- **生活常用**：IP查询，快递查询，短信，全国天气预报，万年历，空气质量指数，彩票开奖，菜谱大全，药品信息 \r
- **工具万能**：手机号码归属地，身份证号码归属地查询，NBA赛事数据，邮编查询，WHOIS查询，识图工具，二维码生成识别，手机空号检测 \r
- **交通出行**：VIN车辆识别代码查询，今日油价，车辆尾号限行，火车查询，长途汽车，车型大全，加油站查询，车型保养套餐查询 \r
- **图像识别**：身份证识别，驾驶证识别，车牌识别，行驶证识别，银行卡识别，通用文字识别，营业执照识别，VIN识别 \r
- **娱乐购物**：商品条码查询，条码生成识别，电影影讯，微博百度热搜榜单，新闻，脑筋急转弯，歇后语，绕口令 \r
- **位置服务**：基站查询，经纬度地址转换，坐标系转换 \r
\r
在官网注册后，按**具体 API 页面**申请数据，在会员中心获取 **AppKey** 进行接入；**免费额度和套餐**在API详情页查看，适合个人开发者与企业进行接入。在 **ClawHub** 上也可搜索 **`jisuapi`** 找到更多基于极速数据的 OpenClaw 技能。\r
\r
安全使用建议
This skill is internally consistent: it needs a JisuAPI AppKey and runs a Python script that queries JisuAPI's huangli/date endpoint. Before installing, ensure you: (1) only provide a JISU_API_KEY you trust (API keys can incur usage/billing limits and should be treated as secrets), (2) have Python3 and the 'requests' package installed on the host (the skill doesn't declare Python package dependencies), and (3) are comfortable with the skill making outbound HTTPS requests to api.jisuapi.com. If you prefer tighter control, create a limited API key on JisuAPI, monitor usage, or run the script in an isolated environment.
功能分析
Type: OpenClaw Skill
Name: huangli
Version: 1.0.4
The skill is a straightforward implementation of a Chinese Almanac (Huangli) lookup service using the JisuAPI. The Python script (huangli.py) correctly retrieves an API key from environment variables and performs a standard GET request to the legitimate service provider (api.jisuapi.com) without any signs of data exfiltration, command injection, or malicious intent.
能力评估
Purpose & Capability
Name/description ask for calendar/huangli queries and the code only calls JisuAPI's huangli/date endpoint using an AppKey; requiring JISU_API_KEY and python3 is appropriate.
Instruction Scope
SKILL.md instructs how to set the AppKey and run the Python script with a JSON date payload; the instructions only access the declared env var and call the documented external API.
Install Mechanism
This is an instruction-only skill with a Python script but no install spec. The script imports the 'requests' library which is not declared as a dependency — hosts must ensure Python and the requests package are available.
Credentials
Only JISU_API_KEY is required and it's the primary credential used to authenticate to the JisuAPI service; no unrelated secrets or config paths are requested.
Persistence & Privilege
Skill does not request always:true, does not alter other skills or system config, and has normal (non-persistent) presence.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install huangli - 安装完成后，直接呼叫该 Skill 的名称或使用
/huangli触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.4
- Description and name updated for clearer use-case and improved discoverability.
- Documentation restructured: now includes an "About JisuAPI" section and expanded API/key configuration guidance.
- Usage recommendations and introductory sections made more concise and focused for end users and agents.
- No changes to code or API usage—documentation improvement only.
v1.0.3
- No code or functionality changes in this release.
- Documentation refreshed with minor edits for clarity.
- No impact on API, usage, or environment variables.
v1.0.2
- No file changes detected in this version.
- No functional or documentation updates.
- Version number bumped to 1.0.2 without content change.
v1.0.1
- 修正文档中黄历官方文档表述，统一为“极速数据文档”。
- 其余功能和接口保持不变，仅文本描述微调以保持准确性。
v1.0.0
Initial release of huangli skill:
- Provides Chinese almanac (黄历) lookup by year, month, and day using Jisu API.
- Returns detailed calendar data: lunar date, zodiac, constellation, lucky/unlucky activities (宜/忌), auspicious/dangerous deities, and more for dates between 1900–2100.
- Requires JISU_API_KEY environment variable for authentication.
- Single endpoint `/huangli/date` accepts JSON input and validates required fields.
- Outputs structured results suitable for answering questions like “what to do today” or “is a date good for marriage.”
元数据
常见问题
Almanac / Huangli Inquiry - 黄历查询 是什么？
按公历日期查询农历、宜忌、吉神凶煞等黄历信息。当用户说：明天宜不宜搬家？这周五适合领证吗？或类似黄历择日时，使用本技能。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 499 次。
如何安装 Almanac / Huangli Inquiry - 黄历查询？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install huangli」即可一键安装，无需额外配置。
Almanac / Huangli Inquiry - 黄历查询 是免费的吗？
是的，Almanac / Huangli Inquiry - 黄历查询 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
Almanac / Huangli Inquiry - 黄历查询 支持哪些平台？
Almanac / Huangli Inquiry - 黄历查询 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Almanac / Huangli Inquiry - 黄历查询？
由 极速数据（@jisuapi）开发并维护，当前版本 v1.0.4。
推荐 Skills