Search poems
search_poemsSearches the words of every poem in the ReadingRate collection and returns the matching lines, the lines around each, and each poem's anchor, which get_poem, save_poem_line and annotate_poem_line accept.
Use when the user half-remembers a line, or wants poems that mention an image or a subject, such as "the poem about the shattered statue in the desert". It returns only poems already in the collection; it does not write, continue or translate poems.
It matches words, so a remembered phrase works better than a paraphrase. The poems are in English: for a reader writing in another language, search with the English words a poem would use, explain in the reader's language, and quote the poem's lines in the original English rather than in a translation of your own.
Example: {"query": "the woods are lovely dark and deep"}
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of results (default 10, max 25) | |
| query | Yes | A line, a phrase, or the words remembered | |
| poem_id | No | Search one poem only: its anchor or slug, as for get_poem |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | Guidance when the query could not match (e.g. written in a non-English script) | |
| results | Yes | Matching passages, most similar first. Empty when nothing matched. |