https://github.com/acdzh/douban-book-api
第三方豆瓣读书 api 接口
https://github.com/acdzh/douban-book-api
calibre douban douban-book koa node
Last synced: 5 months ago
JSON representation
第三方豆瓣读书 api 接口
- Host: GitHub
- URL: https://github.com/acdzh/douban-book-api
- Owner: acdzh
- License: mit
- Created: 2021-08-22T11:31:05.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2023-01-30T06:08:06.000Z (over 3 years ago)
- Last Synced: 2023-04-04T18:54:43.808Z (about 3 years ago)
- Topics: calibre, douban, douban-book, koa, node
- Language: HTML
- Homepage:
- Size: 833 KB
- Stars: 77
- Watchers: 3
- Forks: 20
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Douban Book Api for Calibre
## 简介
这是一个使用爬虫实现的第三方豆瓣读书 api 接口. 本项目中没有任何数据, 请自行搭建. 鉴于豆瓣关闭 api 接口并封禁 apiKey, 爬虫有被风控的风险, 请控制好抓取频次.
## Demo
[https://acdzh-douban-book-api.herokuapp.com/](https://acdzh-douban-book-api.herokuapp.com/)
服务部署在 Heroku, 访问量较大可能会被屏蔽, 请不要在正式环境使用该地址的服务.
## 安装
### 一键部署
**请注意: 一键部署使用 Heroku 环境, 项目不对任何在第三方平台行为造成的后果负责**
[](https://heroku.com/deploy)
### Using Docker
```bash
sudo docker run -d \
--name douban-book-api-1 \
-p 3000:3000 \
-v /CACHE_DIR:/cache \
acdzh/douban-book-api
```
### Using node
```bash
npm install
npm start
```
之后访问 `http://localhost:3000/` 即可.
## API 接口说明
### 图书搜索接口
#### 请求地址
`{HOST}/search?text=`
#### 请求方式
**GET**
#### 请求参数
##### Header 参数
| 参数名 | 必选 | 类型/参数值 | 说明 |
|--------------|-----|------------------|--------|
| Content-Type | 是 | application/json | 请求参数类型 |
#### 返回示例
`[{HOST}/search?text=刘慈欣`: [DEMO](https://acdzh-douban-book-api.herokuapp.com/search?text=刘慈欣)
```json
{
"success": true,
"data": [
{
"title": "刘慈欣 Cixin Liu",
"abstract_2": "作者 / 1963-06-01 / 三体 / 三体Ⅱ / 三体Ⅲ",
"labels": [],
"url": "https://book.douban.com/author/4561353/",
"id": 4561353,
"abstract": "8693 人收藏",
"cover_url": "https://img9.doubanio.com/view/celebrity/raw/public/p1543395922.04.jpg",
"more_url": "",
"tpl_name": "search_common"
},
{
"id": 33146,
"labels": [],
"tpl_name": "search_simple",
"abstract": "中国工人出版社 / 共3册",
"title": "[丛书] 刘慈欣作品",
"url": "https://book.douban.com/series/33146"
},
{
"more_url": "onclick=\"moreurl(this,{i:'0',query:'%E5%88%98%E6%85%88%E6%AC%A3',subject_id:'2567698',from:'book_subject_search',cat_id:'1001'})\"",
"url": "https://book.douban.com/subject/2567698/",
"extra_actions": [
{
"url": "https://book.douban.com/subject/2567698/?channel=subject_list&platform=web",
"color": "#CF5B40",
"text": "豆瓣书店有售"
}
],
"labels": [],
"label_actions": [],
"rating": {
"rating_info": "",
"star_count": 4.5,
"count": 410716,
"value": 8.8
},
"cover_url": "https://img1.doubanio.com/view/subject/m/public/s2768378.jpg",
"interest": null,
"topics": [],
"tpl_name": "search_subject",
"title": "三体 : “地球往事”三部曲之一",
"id": 2567698,
"abstract": "刘慈欣 / 重庆出版社 / 2008-1 / 23.00",
"abstract_2": ""
}
],
"is_cache": false
}
```
这个返回的结果对应 [https://search.douban.com/book/subject_search?search_text=刘慈欣](https://search.douban.com/book/subject_search?search_text=%E5%88%98%E6%85%88%E6%AC%A3), 见下图:
#### 备注
考虑到大部分的预期结果都出现在第一页, 所以搜索暂未设计翻页. 如果后续发现此需求确有必要, 会考虑升级.
### 根据豆瓣 id 或 isbn 获取图书详情
#### 请求地址
`{HOST}/subject/`
`{HOST}/isbn/`
#### 请求方式
**GET**
#### 请求参数
##### Header 参数
| 参数名 | 必选 | 类型/参数值 | 说明 |
|--------------|-----|------------------|--------|
| Content-Type | 是 | application/json | 请求参数类型 |
#### 返回示例
`{HOST}/subject/27012117`: [DEMO](https://acdzh-douban-book-api.herokuapp.com/subject/27012117)
`{HOST}/isbn/9787208140400`: [DEMO](https://acdzh-douban-book-api.herokuapp.com/isbn/9787208140400)
```json
{
"success": true,
"data": {
"title": "政治的逻辑",
"subtitle": "马克思主义政治原理",
"original_title": "",
"id": "27012117",
"isbn": "9787208140400",
"author": ["王沪宁", "林尚立","孙关宏"],
"translator": [],
"publish": "上海人民出版社",
"producer": "",
"publishDate": "2016-10",
"pages": "650",
"price": "98.00元",
"binding": "精装",
"series": "",
"book_intro": "《政治的逻辑》是高校社会科学....",
"author_intro": "王沪宁，复旦大学政治学教授...",
"catalog": ["序言", "......", "后记"],
"original_texts": ["阶级消亡...", "国家是..."],
"labels": ["政治学", "马克思主义", "王沪宁", "政治", "政治经济学", "马克思", "中国", "社会学"],
"cover_url": "https://img2.doubanio.com/view/subject/l/public/s29602841.jpg",
"url": "https://book.douban.com/subject/27012117/",
"rating": {
"count": 176,
"info": "",
"value": 8.7,
"five_star_per": 53.4,
"four_star_per": 33,
"three_star_per": 8,
"two_star_per": 2.8,
"one_star_per": 2.8
},
"comments": [{
"vote": 1,
"user_name": "乔治 ♘",
"user_page": "https://www.douban.com/people/165208204/",
"rating": 4,
"date": "2021-04-07",
"content": "中国马克思主义的集大成..."
}],
"reviews": [{
"user_avatar": "https://img1.doubanio.com/icon/u1566359-9.jpg",
"user_name": "月之仙者",
"user_page": "https://www.douban.com/people/yuezhixianzhe/",
"rating": 3,
"time": "2008-08-06 09:53:30",
"publisher": "上海人民出版社2004版",
"publisher_page": "https://book.douban.com/subject/1003659/",
"title": "政治的逻辑：马克思主义政治学原理",
"url": "https://book.douban.com/review/1463309/",
"short_content": "经过十天左右的时间终于看完了...",
"useful_count": 53,
"useless_count": 2,
"reply_count": 8
}],
"notes": []
},
"is_cache": false
}
```
这个返回的结果对应 [https://book.douban.com/subject/27012117/](https://book.douban.com/subject/27012117/) 或者 [https://book.douban.com/isbn/9787208140400/](https://book.douban.com/isbn/9787208140400/), 见下图:
#### 数据格式
| 首级标签 | 次级标签 | 三级标签 | 名称 | 类型 | 示例 | 备注 |
|----------------|--------|----------|-----------------------------------------------------------------|--------------------------------------------------------------------|-----|-----|
| title ||| 标题 | string | "政治的逻辑" ||
| subtitle ||| 副标题 | string | "马克思主义政治原理" ||
| original_title ||| 原标题 | string || 适用于译著 |
| id ||| 豆瓣 id | string | "27012117" ||
| author ||| 作者 | string[] | ["王沪宁", "林尚立", "孙关宏"] | 顺序与豆瓣页面一致, 不进行排序 |
| translator ||| 译者 | string[] | [] | 顺序与豆瓣页面一致, 不进行排序 |
| publish ||| 出版社 | string | "上海人民出版社" ||
| producer ||| 出品方 | string | "" ||
| publishDate ||| 出版年 | string | "2016-10" ||
| pages ||| 页数 | string | "650" ||
| price ||| 定价 | string | "98.00元" ||
| binding ||| 装帧 | string | "精装" ||
| series ||| 丛书 | string | "" ||
| book_intro ||| 内容简介 | string | "《政治的逻辑》是.." ||
| author_intro ||| 作者简介 | string | "王沪宁，复旦大学..." ||
| catalog ||| 目录 | string[] | ["序言", "..."] ||
| original_texts ||| 原文摘录 | string[] | ["阶级消亡..."] ||
| labels ||| 标签 | string[] | ["政治学","马克思主义"] ||
| cover_url ||| 封面地址 | string | "https://img2.doubanio.com/view/subject/l/public/s29602841.jpg" |  |
| url ||| 豆瓣页面地址 | string | "https://book.douban.com/subject/27012117/" | [政治的逻辑 (豆瓣)](https://book.douban.com/subject/27012117/) |
| rating ||| 豆瓣评分 | object |||
|| count || 评分人数 | number | 176 ||
|| info || 评分信息 | "" \ | "目前无人评价" \ | "评价人数不足" |""|当评分不足时, 此项不为空|
|| value || 分数 | number | 8.7 ||
|| five_star_per || 五星占比 | number | 53.4 | 百分数 |
|| four_star_per || 四星占比 | number | 33 | 百分数 |
|| three_star_per || 三星占比 | number | 8 | 百分数 |
|| two_star_per || 二星占比 | number | 2.8 | 百分数 |
|| one_star_per || 一行占比 | number | 2.8 | 百分数 |
| comments ||| 短评 | object[] || 该项为数组, 包括最新短评与热门短评, 短评有字数限制 |
|| vote || 有用数 | number | 1 ||
|| user_name || 用户昵称 | string | "乔治 ♘" ||
|| user_page || 用户主页 | string | "https://www.douban.com/people/165208204/" | [乔治 ♘](https://www.douban.com/people/165208204/) |
|| rating || 评分 | number | 4 ||
|| date || 日期 | string | "2021-04-07" ||
|| content || 内容 | string | "中国马克思主义..." ||
| reviews ||| 书评 | object[] || 此项为数组, 包含热门书评与最新书评 |
|| user_avatar || 用户头像 | string | "https://img2.doubanio.com/icon/u176380444-1.jpg" |  |
|| user_name || 用户昵称 | string | "东风一号" ||
|| user_page || 用户主页 | string | "https://www.douban.com/people/176380444/" | [东风一号](https://www.douban.com/people/176380444/) |
|| rating || 评分 | number | 4 ||
|| time || 日期 | string | "2018-04-27 00:35:23" ||
|| publisher || 版本 | string | "上海人民出版社2004版" | 同一本书不同版本下的书评, 如果该项为空, 则说明用户所读的是当前版本 |
|| publisher_page || 对应版本页面 | string | "https://book.douban.com/subject/1003659/" | [政治的逻辑 (豆瓣)](https://book.douban.com/subject/1003659/) |
|| title || 标题 | string | "王沪宁《政治的逻辑》读后感" ||
|| url || 书评链接 | string | "https://book.douban.com/review/9320713/" | [王沪宁《政治的逻辑》读后感（政治的逻辑）书评](https://book.douban.com/review/9320713/) |
|| short_content || 书评摘要 | string | "花了十几天的时间终于..." ||
|| useful_count || 有用数 | number | 16 ||
|| useless_count || 没用数 | number | 1 ||
|| reply_count || 回应数 | number | 2 ||
| notes ||| 读书笔记 | object[] || 开发中... |
| discussion ||| 论坛 | object[] || 开发中... |
## 缓存
查询会强制写缓存. 缓存文件夹路径由环境变量 `CACHE_DIR` 决定, 缺省情况下是 `./.cache`, docker 中该路径为 `/cache`. 缓存存于这个文件夹下的 `books.sqlite` 中.
默认会先从缓存中查询, 如果需要最新数据可以指定 api 参数 `update=1`.
## Calibre 插件
打包 `calibre` 目录为 zip, 拖入 Calibre 安装即可. 注意需要在设置里更改为自己的 api 地址.
## 油猴脚本
[自动刷新豆瓣图书 api 缓存 @Greasy Fork](https://greasyfork.org/zh-CN/scripts/431582)
这个脚本可以在浏览豆瓣时自动提交图书信息. 第一次使用需要先设置 api 服务器地址.
## 其他
因为是通过抓取 html 页面来获取数据, 因此抓取较慢且有一定概率遭到反爬测率限制或数据解析失败. 如果解析规则失效或解析数据有误, 请提 issure 或 pr, 谢谢茄子🍆.
请确保 issure 中包含以下信息:
- 你遇到的问题.
- 测试用例. 最好是豆瓣图书链接.
如果要提 pr, 请在提供上述信息的同时, 另外确保所有测试用例没有问题. 可以使用 `npm run test` 来运行测试.