Skip to content

acdzh/douban-book-api

Repository files navigation

Douban Book Api for Calibre

简介

这是一个使用爬虫实现的第三方豆瓣读书 api 接口. 本项目中没有任何数据, 请自行搭建. 鉴于豆瓣关闭 api 接口并封禁 apiKey, 爬虫有被风控的风险, 请控制好抓取频次.

Demo

https://acdzh-douban-book-api.herokuapp.com/

服务部署在 Heroku, 访问量较大可能会被屏蔽, 请不要在正式环境使用该地址的服务.

安装

一键部署

请注意: 一键部署使用 Heroku 环境, 项目不对任何在第三方平台行为造成的后果负责

Deploy

Using Docker

sudo docker run -d \
--name douban-book-api-1 \
-p 3000:3000 \
-v /CACHE_DIR:/cache \
acdzh/douban-book-api

Using node

npm install
npm start

之后访问 http://localhost:3000/ 即可.

API 接口说明

图书搜索接口

请求地址

{HOST}/search?text=<text>

请求方式

GET

请求参数

Header 参数
参数名 必选 类型/参数值 说明
Content-Type application/json 请求参数类型

返回示例

[{HOST}/search?text=刘慈欣: DEMO

{
  "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=刘慈欣, 见下图:

备注

考虑到大部分的预期结果都出现在第一页, 所以搜索暂未设计翻页. 如果后续发现此需求确有必要, 会考虑升级.

根据豆瓣 id 或 isbn 获取图书详情

请求地址

{HOST}/subject/<id>
{HOST}/isbn/<isbn>

请求方式

GET

请求参数

Header 参数
参数名 必选 类型/参数值 说明
Content-Type application/json 请求参数类型

返回示例

{HOST}/subject/27012117: DEMO
{HOST}/isbn/9787208140400: DEMO

{
  "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/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/" 政治的逻辑 (豆瓣)
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/" 乔治 ♘
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/" 东风一号
rating 评分 number 4
time 日期 string "2018-04-27 00:35:23"
publisher 版本 string "上海人民出版社2004版" 同一本书不同版本下的书评, 如果该项为空, 则说明用户所读的是当前版本
publisher_page 对应版本页面 string "https://book.douban.com/subject/1003659/" 政治的逻辑 (豆瓣)
title 标题 string "王沪宁《政治的逻辑》读后感"
url 书评链接 string "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

这个脚本可以在浏览豆瓣时自动提交图书信息. 第一次使用需要先设置 api 服务器地址.

其他

因为是通过抓取 html 页面来获取数据, 因此抓取较慢且有一定概率遭到反爬测率限制或数据解析失败. 如果解析规则失效或解析数据有误, 请提 issure 或 pr, 谢谢茄子🍆.

请确保 issure 中包含以下信息:

  • 你遇到的问题.
  • 测试用例. 最好是豆瓣图书链接.

如果要提 pr, 请在提供上述信息的同时, 另外确保所有测试用例没有问题. 可以使用 npm run test 来运行测试.