Readarr Skill
Readarr is the *arr-suite manager for ebooks and audiobooks. It monitors authors, finds releases via indexers (Prowlarr), sends them to a download client, and drops them into the Calibre library.
Connection
Readarr runs as /Applications/Readarr.app on Dozo. Already configured and running.
CODEBLOCK0
See references/api.md for all endpoints.
Core Workflows
Find and add a book
CODEBLOCK1
Monitor an author
CODEBLOCK2
Check wanted/missing
CODEBLOCK3
Trigger a search
CODEBLOCK4
Check download queue
CODEBLOCK5
Calibre Integration
Readarr drops completed books into Calibre's watch folder. Lucien then runs:
calibredb add /path/to/new/book.epub --with-library /Volumes/Bull/calibre-library
Or configure Readarr's "Book Import" post-processing to point directly at the Calibre library path.
Credentials
Store API key at
~/clawd/credentials/readarr_api_key (single line, no newline).
Load with: INLINECODE3
Readarr 技能
Readarr 是电子书和有声读物的 *arr 系列管理器。它监控作者，通过索引器（Prowlarr）查找发布内容，发送到下载客户端，并放入 Calibre 库。
连接
Readarr 在 Dozo 上以 /Applications/Readarr.app 运行。已配置并运行中。
bash
READARR_URL=http://localhost:8787
READARRKEY=$(cat /path/to/readarrapi_key)
所有端点请参阅 references/api.md。
核心工作流
查找并添加书籍
bash
1. 按标题或 ISBN 查找
curl -s $READARR_URL/api/v1/book/lookup?term=<标题> \
-H X-Api-Key: $READARR_KEY | python3 -c
import sys,json
books = json.load(sys.stdin)
for b in books[:5]:
print(b.get(title), —, b.get(author,{}).get(authorName), | foreignBookId:, b.get(foreignBookId))
2. 添加书籍（需要从 /api/v1/qualityprofile 和 /api/v1/metadataprofile 获取 qualityProfileId 和 metadataProfileId）
curl -s -X POST $READARR_URL/api/v1/book \
-H X-Api-Key: $READARR_KEY \
-H Content-Type: application/json \
-d {foreignBookId:
,monitored:true,author:{...},qualityProfileId:1,metadataProfileId:1,rootFolderPath:/path/to/books,addOptions:{searchForNewBook:true}}
监控作者
bash
先查找作者
curl -s $READARR_URL/api/v1/author/lookup?term=Iain+Banks \
-H X-Api-Key: $READARR_KEY
添加作者（监控所有未来发布）
curl -s -X POST $READARR_URL/api/v1/author \
-H X-Api-Key: $READARR_KEY \
-H Content-Type: application/json \
-d {foreignAuthorId:,monitored:true,qualityProfileId:1,metadataProfileId:1,rootFolderPath:/path/to/books,addOptions:{monitor:all,searchForMissingBooks:true}}
检查想要/缺失的书籍
bash
curl -s $READARR_URL/api/v1/wanted/missing?pageSize=20 \
-H X-Api-Key: $READARR_KEY | python3 -c
import sys,json
d = json.load(sys.stdin)
for b in d.get(records,[]):
print(b[title], —, b.get(author,{}).get(authorName))
触发搜索
bash
curl -s -X POST $READARR_URL/api/v1/command \
-H X-Api-Key: $READARR_KEY \
-H Content-Type: application/json \
-d {name:MissingBookSearch}
检查下载队列
bash
curl -s $READARRURL/api/v1/queue -H X-Api-Key: $READARRKEY | python3 -c
import sys,json
q = json.load(sys.stdin)
for item in q.get(records,[]):
print(item.get(title), |, item.get(status), |, item.get(timeleft,?))
Calibre 集成
Readarr 将完成的书籍放入 Calibre 的监控文件夹。Lucien 随后运行：
bash
calibredb add /path/to/new/book.epub --with-library /Volumes/Bull/calibre-library
或者配置 Readarr 的书籍导入后处理，直接指向 Calibre 库路径。
凭据
将 API 密钥存储在 ~/clawd/credentials/readarrapikey（单行，无换行）。
加载方式：READARRKEY=$(cat ~/clawd/credentials/readarrapi_key)
