WeRead Notes

View and manage WeRead notes and highlights

✨ The solution you've been looking for

View WeRead personal notes and highlights, including underlines, thoughts/reviews, and bookmarks. Support exporting highlights and thoughts for individual books.

WeRead Notes Highlights

See It In Action

Interactive preview & real-world examples

Live Demo

AI Conversation Simulator

See how users interact with this skill

User Prompt

Show my notes in "The Three-Body Problem"

Skill Processing

Querying...

Agent Response

You have 23 notes in 'The Three-Body Problem': 15 highlights, 5 thoughts, 3 bookmarks

Quick Start (3 Steps)

Get up and running in minutes

Install

Config

Set WEREAD_API_KEY environment variable

First Trigger

Commands

Command	Description	Required Args
View Notebooks Overview	View all books with notes	None
View Book Notes	View highlights and thoughts for a book	book ID
View Popular Highlights	View popular highlights for a book	book ID

Typical Use Cases

View Notes Overview

View list of books with notes

View Book Notes

View specific notes for a book

Overview

notes — Notes & Highlights

Two counting approaches:

Statistics: Notes = Bookmarks + Highlights + Thoughts/Reviews
Export: Exportable content = Highlights + Thoughts/Reviews (bookmarks not exportable)

API

`/user/notebooks` — Notebooks Overview

Request Parameters:

Parameter	Type	Required	Description
`count`	int	No	Items per page, default 20
`lastSort`	int	No	Pagination cursor

Response:

Field	Description
`totalBookCount`	Total books with notes
`totalNoteCount`	Total notes count
`books[].bookId`	Book ID
`books[].reviewCount`	Thoughts/reviews count
`books[].noteCount`	Highlights count
`books[].bookmarkCount`	Bookmarks count

`/book/bookmarklist` — Book Highlights (excludes bookmarks)

Request Parameters:

Parameter	Type	Required	Description
`bookId`	string	Yes	Book ID

Response:

Field	Description
`updated[]`	Highlights array
`updated[].markText`	Highlighted text
`updated[].createTime`	Creation time
`chapters[]`	Chapter info for location

`/book/bestbookmarks` — Popular Highlights

Request Parameters:

Parameter	Type	Required	Description
`bookId`	string	Yes	Book ID
`chapterUid`	int	No	Chapter UID (0=all chapters)

Response:

Field	Description
`items[]`	Popular highlights array
`items[].markText`	Highlighted text
`items[].totalCount`	Number of readers who highlighted
`chapters[]`	Chapter info

Workflow

Overview: Call /user/notebooks to show all books with notes.
Book notes: Call /book/bookmarklist for highlights and /review/list/mine for thoughts.
Popular highlights: Call /book/bestbookmarks for popular highlights.

Output Format

Notebook overview: numbered list with book title, author, note counts
Book notes: grouped by chapter, highlights in quotes, thoughts below corresponding highlights