Douban Books (No Login Required): Sync Personal Reading Lists to CSV/JSON

前言

维护自己的阅读清单时,豆瓣读书的网页端只提供浏览,没有导出入口。想拿已读、想读、在读做统计,或者把数据迁到别的工具里,只能手动复制粘贴,条目一多就容易错漏,也难以定期更新。下面介绍的这个 Skill 把这件事自动化:直接抓取个人读书列表,输出成结构化文件,并且支持三种同步方式。

这是什么

豆瓣读书助手,坐标 @user_79b4210b/douban-fbfl,版本 1.0.0,社区来源,由 user_79b4210b 发布,SkillHub 分类为 data-analysis。它解决的问题是:把豆瓣账号里的已读、想读、在读列表抓下来,落成 CSV 或 JSON,供本地脚本、表格工具或后续分析使用。

标签为 requires_api_key=false,也就是不需要 API Key,启用后即可直接调用。

核心功能

下面这些能力来自官方简介,逐条列出:

  1. 抓取个人已读、想读、在读三类列表。
  2. 输出格式支持 CSV 和 JSON,方便直接进表格或进程序。
  3. 同步方式有三种:全量同步、增量更新、RSS 轻量同步。

全量同步适合首次拉取或数据需要重建的场景;增量更新适合定期把新加的条目补进来,不必每次重跑;RSS 轻量同步面向只想要轻量触发、不想反复全量抓取的场景。具体参数与字段格式,官方简介未展开,启用后以 Skill 内说明为准。

安装与启用

已抓取资料中没有提供安装命令、目录路径或配置字段,因此这里不写未经核实的命令。可核实的入口如下:

官方地址:https://api.skillhub.cn/user_79b4210b/douban-fbfl
SkillHub 页面:https://www.skillhub.cn/skills/user_79b4210b/douban-fbfl
坐标:@user_79b4210b/douban-fbfl

在支持 SkillHub 的客户端里,按上述坐标或页面链接启用即可。该 Skill 基于通用 SKILL.md 格式,Cursor、Codex CLI、Claude Code 的具体启用方式资料中未分别说明,需要时以官方页面为准。

典型用法

资料中没有给出可直接复现的命令行示例,下面按简介描述的流程说明:

  1. 首次使用时跑一次全量同步,把已读、想读、在读三类列表导出成 CSV 或 JSON。
  2. 之后定期跑增量更新,只把新加入的条目合并进已有文件。
  3. 如果只需要轻量触发,用 RSS 轻量同步代替全量抓取。

具体调用方式在启用后按 Skill 内说明执行。

适用场景与注意

适合需要把豆瓣读书清单落到本地、再做统计或迁移的开发者。不需要 API Key,接入门槛低。

需要注意的几点:

  1. 数据来源是豆瓣页面抓取,豆瓣前端结构变化时抓取结果可能失效,出问题先跑一次全量同步校验。
  2. SkillHub 页面显示下载 1008、安装 0,使用量还不大,采用前建议先在小范围数据上验证。
  3. 只覆盖已读、想读、在读三类列表,读书笔记、标记等其他数据不在简介范围内。

结尾

这个 Skill 的价值在于把豆瓣读书的浏览页面变成可程序化读取的结构化数据,三种同步方式对应了首次拉取和日常维护两种需求,且不需要 API Key。官方地址:https://api.skillhub.cn/user_79b4210b/douban-fbfl

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye