Connect WeRead to Your AI Agent

Find your next book, organize highlights alongside your own thoughts, and turn your reading history into a clear review of your progress and interests.

16 tools API key

Try a WeRead Task

Copy a prompt into your agent with the oo Skill installed. Add your page links and source notes before running it.

oo Skill WeRead

Organize a Book’s Notes

Collect your highlights and personal thoughts, then arrange them by chapter.

/oo WeRead: Find my notes for The Three-Body Problem and organize the highlights and my thoughts by chapter.

Review Your Reading Progress

See what is on your shelf and how far you have read.

/oo WeRead: Show my bookshelf, including audiobooks, and summarize progress on the books I am currently reading.

Choose Your Next Book

Compare book details, reader opinions and related recommendations.

/oo WeRead: Find The Three-Body Problem, summarize its public reviews, and suggest similar books with their available reading links.

Understand Your Reading Habits

Review time spent reading, favorite categories and the books you read most.

/oo WeRead: Summarize my reading this month: total time, active days, most-read books and preferences.

Explore Popular Passages

Read popular highlights and the thoughts readers shared about them.

/oo WeRead: Show popular highlights from this book and summarize the discussion around the passage I choose.

Start Working with WeRead

  1. Install OOMOL

    Set up oo CLI and the oo Skill in your agent.

    Install OOMOL →
  2. Connect WeRead

    Get a WeRead API key at https://weread.qq.com/r/weread-skills and connect it to your assistant.

    Connect WeRead →
  3. Give Your Agent a Task

    Use /oo with the pages to read, the changes to make, and where to save the result.

    Connection Guide →

Choose Your Agent

  • A WeRead account and its API key.
  • The connection can read data available to your account. It does not edit your shelf or publish notes.

WeRead Tools

Search the WeRead catalog, inspect your bookshelf and progress, collect notes by chapter, compare public reviews, and explore personalized or similar-book recommendations. Reading statistics help you review time spent and changing preferences.

Books and Discovery

Search books and other catalog content, inspect details and chapters, and explore recommendations.

Shelf and Reading History

Read your shelf, progress and periodic reading statistics.

Notes and Reader Discussions

Collect personal notes and explore public reviews, popular passages and reader thoughts.

16 tools

Search

Search WeRead. Choose scope explicitly; use the last searchIdx as maxIdx for the next page. Response group scope may differ from request scope.

weread.search

Get Book

Get book details by ID.

weread.get_book

List Chapters

List a book's chapter table of contents.

weread.list_chapters

Get Reading Progress

Get reading progress. Progress 1 means 1%; completion requires progress 100 and finishTime.

weread.get_reading_progress

Get Shelf

Read the shelf. Visible entries equal books.length + albums.length + 1 when mp is nonempty; bookCount excludes audio and mp.

weread.get_shelf

List Notebooks

List notebook summaries. Next lastSort is the final book's sort. Total notes include reviewCount + noteCount + bookmarkCount.

weread.list_notebooks

List Highlights

List personal highlights in a book, excluding reading-position bookmarks. Query list_my_reviews as well to retrieve all exportable note content.

weread.list_highlights

List My Reviews

List personal thoughts, chapter comments and book reviews. Continue with the returned synckey while hasMore is 1.

weread.list_my_reviews

Get Underline Stats

Get chapter highlight popularity statistics without source text.

weread.get_underline_stats

List Popular Highlights

Get up to 20 popular highlights with source text. The upstream result is fixed-size and does not support pagination.

weread.list_popular_highlights

List Highlight Reviews

List thoughts on specified highlight ranges, preserving per-range pagination.

weread.list_highlight_reviews

Get Review

Get a single thought or review with optional comments and likes.

weread.get_review

Get Reading Stats

Get reading statistics for one period. Durations are seconds; annual mode covers only the selected calendar year.

weread.get_reading_stats

List Book Reviews

List public book reviews. Continue with the last idx and returned synckey. Content is nested at reviews[].review.review.

weread.list_book_reviews

List Recommendations

List personalized book recommendations. Continue with the last book's searchIdx as maxIdx.

weread.list_recommendations

List Similar Books

List similar books. Defaults to count 12 and maxIdx 0; continue with the last idx and returned sessionId.

weread.list_similar_books

Frequently Asked Questions

Can the assistant change my bookshelf or publish notes?

This integration reads information. It does not change your bookshelf, edit highlights or publish reviews.

Can I export all of my notes?

You can retrieve personal highlights and thoughts. Reading-position bookmarks are included in counts, but their contents are not available for export.

Does the shelf include audiobooks?

Yes. Audio albums are returned separately and count toward the visible shelf total, together with books and the article-collection entry when present.

Connect WeRead

About WeRead ↗