mcpField
B
book-research

book-research

github.com/crawlora-org其他139 次安装2 天前更新
代码仓库

关于 book-research

通过 Crawlora API 从 Goodreads、Apple Books 和 Audible 获取规范化的图书、作者、评论及有声书资料。该技能支持目录研究、榜单浏览，以及纸质版与有声版本的对照。

主要功能

  1. 01Goodreads 图书与作者资料
  2. 02Apple Books 作品与榜单
  3. 03Audible 作品、朗读者与系列
  4. 04评论、推荐与书单查询
  5. 05通过 Crawlora API 获取规范化 JSON

适用场景

  1. 01查看图书评分与评论
  2. 02整理作者的作品目录
  3. 03浏览排行榜与精选书单
  4. 04查找有声书版本及朗读者

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/crawlora-org/crawlora-skills --skill book-research

安装后在 Claude Code 中输入/book-research确认已加载。

附带文件reference/endpoints.mdscripts/crawlora.sh

详细介绍

图书与有声书研究

通过 Crawlora API 跨 Goodreads、Apple Books 和 Audible 查找图书、作者、评论和有声书，并以规范化 JSON 返回——无需抓取 图书目录页面。

何时使用此技能

  • “这本书的评分／评论如何？”
  • “这位作者写过哪些作品？”（书目、引言）
  • “给我一份精选书单”（Goodreads 类型／书单页面）。
  • “在 Apple Books 上查找这本书／有有声书吗？”
  • “Apple Books／Audible 现在有哪些热门榜单？”
  • “这本有声书由谁朗读？它还属于哪个系列？”（Audible）

设置（一次性）

  • 在 https://crawlora.net 获取免费的 Crawlora API 密钥（每月 2,000 点数，无需银行卡）。
  • 运行辅助脚本前，在环境中设置 CRAWLORA_API_KEY。
  • 辅助脚本会从环境中读取 CRAWLORA_API_KEY，并向 https://api.crawlora.net/api/v1 发送请求。密钥缺失或无效时会返回 401。

工作原理

  1. Goodreads — 使用 /goodreads/search（q）查找图书／作者 ID，然后调用 /goodreads/book/{id}（以及 /reviews、/editions）或 /goodreads/author/{id}（以及 /books、/quotes）。/goodreads/genre/{name} 和 /goodreads/list/{id}（通过 /goodreads/lists 浏览）可用于精选内容浏览。
  2. Apple Books — 使用 /apple-books/search（term）查找图书 ID，然后调用 /apple-books/book/{id}（以及 /reviews、/similar）或 /apple-books/author/{id}。有声书的接口结构相同： /apple-books/audiobook/search → /apple-books/audiobook/{id}（以及 /reviews、/similar），系列可通过 /apple-books/audiobook-series/{id} 和 /apple-books/series/{id} 查询。/apple-books/charts 可按国家／类型查看 热门内容。
  3. Audible — 使用 /audible/search（keywords）查找书名的 asin， 然后调用 /audible/product/{asin} 获取详情（朗读者、时长、系列）， 以及 /audible/product/{asin}/reviews 和 /audible/product/{asin}/related。 /audible/series/{asin} 可浏览系列；/audible/categories 和 /audible/category/{id} 可按类型浏览；/audible/charts 和 /audible/list/{list} 可查看畅销榜／编辑精选书单。

完整的端点列表、方法和参数：reference/endpoints.md。

调用 API

# Goodreads:
scripts/crawlora.sh /goodreads/search q="Project Hail Mary" | jq '.'
scripts/crawlora.sh /goodreads/book/54493401 | jq '.'

# Apple Books:
scripts/crawlora.sh /apple-books/search term="Project Hail Mary" | jq '.'
scripts/crawlora.sh /apple-books/charts | jq '.'

# Audible:
scripts/crawlora.sh /audible/search q="Project Hail Mary" | jq '.'

所有请求都使用 scripts/crawlora.sh；它会避免将 API 密钥暴露在命令行参数中。

端点参考

请参阅 reference/endpoints.md，了解此技能使用的所有 Goodreads、 Apple Books 和 Audible 端点。

示例

  • 作者书目： 使用 /goodreads/author/{id}/books（或 /apple-books/author/{id}）获取完整的已出版作品列表，并与 /goodreads/book/{id}/reviews 交叉核对读者评价。
  • “接下来读什么？” — 使用 /apple-books/book/{id}/similar，或浏览 Goodreads 类型／书单页面，查找特定类别的推荐。
  • 有声书与纸质书对照： 查看 /apple-books/book/{id}，并针对同一书名调用 /apple-books/audiobook/search 或 /audible/search，确认是否有朗读版以及朗读者是谁。

注意事项与限制

  • 点数／成功后计费： 仅对 2xx 响应计费；免费套餐每月 2,000 点数。 可在 https://crawlora.net 获取密钥。
  • 仅限公开数据 — 公开的目录／评论页面。
  • 安全性： 密钥仅保存在 CRAWLORA_API_KEY 中——切勿将其硬编码、放入查询参数或提交到代码库。
  • 详情端点需要平台自身的 ID——如果只有书名／作者姓名，请先通过 .../search 查询。
  • 评论和书单采用分页（page／limit）——遍历所有页面以获取完整数据。

评论

支持 Markdown