Get passages near the reader's position
get_passages_near_reading_positionReturns passages of text from a book the reader is reading, taken from the pages just before their current position in ReadingRate, with their progress in the book. It finds the book and the page itself, so the reader does not have to name the chapter. With a topic, it returns the passages near their position that are closest to that topic.
Use when the reader asks for help with what they just read: the last chapter, a passage they did not understand, or what the author meant in the part they have reached. To search a whole book for a topic, use search_book_content.
Text is available only for books the reader uploaded their own copy of in the ReadingRate app. For other books the result says the text is not available; the book's scores and analysis are in get_book_details.
Examples:
{}
{"book_id": "", "topic": "the argument about metempsychosis"}
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| topic | No | What the reader wants help with, e.g. "narrative voice"; focuses the passages returned | |
| book_id | No | The book: its ReadingRate id or library entry id (default: the book the reader read most recently) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| book | Yes | The book and the user's reading position | |
| note | Yes | Guidance on how to use the passages (or why none were found) | |
| passages | Yes | Text passages from near the user's reading position | |
| passages_found | Yes | Number of passages returned |