极速数据历史上的今天（Jisu TodayHistory）

基于 历史上的今天 API 的 OpenClaw 技能，按指定的月、日查询历史上当天发生的重要事件，包括重大事件、诞辰、逝世等图文内容。

适合在对话中回答「今天在历史上发生了什么」「1 月 2 日有哪些大事」「帮我找几个今天相关的历史故事」等问题。

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

环境变量配置

# Linux / macOS
export JISU_API_KEY="your_appkey_here"

# Windows PowerShell
$env:JISU_API_KEY="your_appkey_here"

脚本路径

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

使用方式与请求参数

当前脚本提供一个子命令：query，对应 /todayhistory/query 接口。

历史上的今天查询（/todayhistory/query）

python3 skills/todayhistory/todayhistory.py query '{"month":1,"day":2}'

请求 JSON：

{
  "month": 1,
  "day": 2
}

返回结果示例（节选）

[
  {
    "title": "日俄战争：驻守旅顺的俄军向日军投降。",
    "year": "1905",
    "month": "1",
    "day": "2",
    "content": "……"
  },
  {
    "title": "意大利墨西拿发生地震，20万人丧生。",
    "year": "1909",
    "month": "1",
    "day": "2",
    "content": "……"
  }
]

常见字段说明：

常见错误码

业务错误码（参考官网错误码参照）：

系统错误码：

在 OpenClaw 中的推荐用法

1. 用户提问：「今天在历史上发生了什么？」代理先确定当前日期，例如 1 月 2 日。
2. 调用：python3 skills/todayhistory/todayhistory.py query '{"month":1,"day":2}'。
3. 从返回列表中选取 3–5 条代表性事件，将 year、title 与 content 整理成时间线式的自然语言描述，作为回答给用户。