名称： libby-book-monitor
版本： 1.0.0
描述： 追踪 Libby/OverDrive 图书馆的书籍可借状态。可搜索图书馆目录、管理关注列表，并在书籍添加到馆藏时获得通知。适用于 "libby"、"check libby"、"libby watchlist"、"is book on libby"、"book available"、"overdrive"、"library catalogue"、"ספרייה"、"ספרים" 等查询。
作者： Alex Polonsky (https://github.com/alexpolonsky)
主页： https://github.com/alexpolonsky/agent-skill-libby-book-monitor
元数据： {"openclaw": {"emoji": "📚", "os": ["darwin", "linux"], "requires": {"bins": ["python3"]}}}

Libby/OverDrive 图书监控器

追踪 Libby/OverDrive 合作图书馆的书籍可借状态。支持搜索目录、管理关注列表，并在书籍添加到馆藏时获得通知。

免责声明：此为非官方工具，与 OverDrive/Libby 无任何关联或认可。目录数据查询自网站后端 API，可能无法反映实时可借状态。本工具不执行借书或预约操作。按“原样”提供，不提供任何形式的担保。

快速开始

# 搜索图书馆目录
python3 {baseDir}/scripts/libby-book-monitor.py search telaviv "Project Hail Mary"

# 将书籍添加到关注列表
python3 {baseDir}/scripts/libby-book-monitor.py watch "Kafka on the Shore" --author "Haruki Murakami"

# 通过 API 检查关注列表中的书籍状态
python3 {baseDir}/scripts/libby-book-monitor.py check

# 显示您的关注列表
python3 {baseDir}/scripts/libby-book-monitor.py list

命令说明

选项参数

用户配置

使用 --profile 选项为不同用户维护独立的关注列表：

python3 {baseDir}/scripts/libby-book-monitor.py --profile jane watch "Dune"
python3 {baseDir}/scripts/libby-book-monitor.py --profile bob check --notify

配置文件

默认图书馆为 telaviv（以色列数字图书馆）。可通过编辑 ~/.libby-book-monitor/config.json 文件进行修改：

{
  "default_library": "nypl",
  "libraries": {
    "nypl": "New York Public Library"
  }
}

图书馆代码取自您图书馆 OverDrive 站点的子域名（例如：nypl.overdrive.com -> nypl）。

定时任务集成

设置每日检查任务，仅在新发现书籍时输出结果：

python3 {baseDir}/scripts/libby-book-monitor.py --profile jane check --notify

当发现新书籍时，可将结果发送给相应用户。

注意事项

• 支持非拉丁字符（希伯来文、阿拉伯文、中日韩文字等）
• 当 API 响应中 isOwned: true 时，视为书籍“已找到”
• 检查多本书籍时，API 调用间有 1 秒延迟
• 无外部依赖（仅使用 Python 标准库）
• 数据存储在 ~/.libby-book-monitor/ 目录（可通过 --data-dir 或 $LIBBY_BOOK_MONITOR_DATA 环境变量配置）