calibre-library

name	calibre-library
description	Use when browsing, searching, or downloading books from a Calibre library through its read-only AJAX API. Covers search, category browsing, book details, downloads, and the explicit no-write boundary.

Calibre 书库（只读）

通过 Calibre Content Server AJAX API 搜索、浏览和下载书籍。

严禁任何写入、修改、删除操作。仅允许搜索、浏览和下载。

适用场景

• 按关键词搜索书籍（标题、作者、标签、ISBN）
• 按作者、出版社、标签、丛书分类浏览
• 获取书籍详情和元数据
• 下载书籍文件（epub、mobi、pdf 等）
• 查看最新入库书籍

不适用

• 添加、删除、修改书籍或元数据
• 管理书库设置或用户权限
• 上传文件到书库

配置

配置文件路径：~/.config/calibre-library/config.json

首次使用前，检查配置文件是否存在：

cat ~/.config/calibre-library/config.json

若不存在，提示用户创建：

mkdir -p ~/.config/calibre-library
cat > ~/.config/calibre-library/config.json << 'EOF'
{
  "base_url": "https://lib.pve.icu",
  "library_id": "library",
  "username": "",
  "password": ""
}
EOF

字段	说明
base_url	Calibre Content Server 地址，不带尾部斜杠
library_id	书库 ID，通常为