用途:通过 Crawlora API 查询图书、作者、评论与有声书信息,数据来自 Goodreads、Apple Books 和 Audible,返回规范化 JSON,无需自行抓取书库页面。适合回答图书评分与评论、作者著作目录与语录、分类书单、Apple Books 或 Audible 有声书查找、排行榜与系列信息等问题。
主要能力:Goodreads 支持按关键词搜索图书/作者后再查详情、评论、版本、作者书目与语录,并提供分类与书单浏览;Apple Books 支持图书与有声书搜索、详情、评论、相似推荐、作者、系列及按国家/地区的排行榜;Audible 支持按关键词搜索获取 asin,再查详情(朗读者、时长、系列)、评论、相关推荐、系列、分类、排行榜与编辑书单。
使用方式:先在 https://crawlora.net 获取免费 API key,并在运行辅助脚本前设置环境变量 CRAWLORA_API_KEY;脚本从环境变量读取密钥并请求 https://api.crawlora.net/api/v1,缺少或无效密钥会返回 401。所有请求建议统一走 scripts/crawlora.sh,避免密钥出现在命令行参数中。例如:scripts/crawlora.sh /goodreads/search q="Project Hail Mary" | jq '.'、scripts/crawlora.sh /apple-books/search term="Project Hail Mary" | jq '.'、scripts/crawlora.sh /audible/search q="Project Hail Mary" | jq '.'。完整端点、方法与参数见 reference/endpoints.md。
限制:仅限公开目录与评论页面数据;详情端点需要各平台自身 id,只有标题或作者名时须先用对应 search 端点解析;评论与书单分页,需按 page/limit 逐页获取;按成功计费,仅 2xx 计费,免费额度 2,000 credits/月;密钥只应放在 CRAWLORA_API_KEY 环境中,禁止硬编码、作为查询参数或提交到仓库。