WeRead Book Info

View book details, table of contents and reading progress

✨ The solution you've been looking for

View WeRead book details, table of contents, and reading progress. Get book basic info, publication info, ratings, and personal reading progress.

WeRead Book Info Reading Progress

See It In Action

Interactive preview & real-world examples

Live Demo
Skill Demo Animation

AI Conversation Simulator

See how users interact with this skill

User Prompt

How many chapters in "The Three-Body Problem"?

Skill Processing

Querying...

Agent Response

'The Three-Body Problem' has 24 chapters, ~890K words. You're at chapter 8, 45% complete

Quick Start (3 Steps)

Get up and running in minutes

1

Install

2

Config

Set WEREAD_API_KEY environment variable
3

First Trigger

Commands

CommandDescriptionRequired Args
View Book InfoGet book basic informationbook ID or title
View Table of ContentsGet book chaptersbook ID
View Reading ProgressGet personal reading progressbook ID

Typical Use Cases

View Book Details

Get basic book information

View Table of Contents

Get chapter structure

Overview

book — Book Info & Reading Progress

View book details, table of contents, and reading progress.

API

/book/info — Book Basic Info

Request Parameters:

ParameterTypeRequiredDescription
bookIdstringYesBook ID

Response:

FieldDescription
bookIdBook ID
titleBook title
authorAuthor
translatorTranslator
coverCover URL
introDescription
categoryCategory
publisherPublisher
publishTimePublication time
isbnISBN
wordCountTotal word count
newRatingRating (0-100)
newRatingCountRating count

/book/chapterinfo — Table of Contents

Request Parameters:

ParameterTypeRequiredDescription
bookIdstringYesBook ID

Response:

FieldDescription
chaptersChapters array
chapters[].chapterUidChapter UID
chapters[].chapterIdxChapter index
chapters[].titleChapter title
chapters[].wordCountChapter word count
chapters[].levelHierarchy level (1=first level)
chapters[].priceChapter price (0=free)
chapters[].paidPurchased status (1=purchased)

/book/getprogress — Reading Progress

Request Parameters:

ParameterTypeRequiredDescription
bookIdstringYesBook ID

Response:

FieldDescription
book.progressReading progress percentage (0-100). Note: 1 means 1%, not 100%. Only 100 means finished
book.recordReadingTimeAccumulated reading duration (seconds)
book.finishTimeFinish time (only when progress=100)
book.updateTimeLast reading time

Workflow

  1. View book details: Call /book/info with bookId or search first with /store/search.
  2. View table of contents: Call /book/chapterinfo, display indented by level.
  3. View reading progress: Call /book/getprogress, display percentage and duration.
  4. Use chapterUid for subsequent APIs like /book/underlines and /book/bestbookmarks.

Output Format

  • Book details: title, author, rating, description
  • Table of contents: indented by level, show word count and paid status
  • Progress: display percentage and duration converted to hours/minutes

Environment Matrix

Dependencies

WEREAD_API_KEY environment variable

Author
weread
1.0.3
2026-05-17
reading