search_poems
Find poems by searching titles, content, and notes with filters for states, forms, and tags to locate specific poetry matching your criteria.
Instructions
Search for poems matching criteria.
Args: query: Text to search for in titles, content, and notes states: Filter by states (e.g., ["completed", "fledgeling"]) forms: Filter by forms (e.g., ["free_verse", "prose_poem"]) tags: Filter by tags (poems must have all specified tags) limit: Maximum number of results to return include_content: Whether to include full poem text in results
Returns: SearchResult with matched poems and query metadata
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | ||
| states | No | ||
| forms | No | ||
| tags | No | ||
| limit | No | ||
| include_content | No |
Input Schema (JSON Schema)
{
"properties": {
"forms": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null
},
"include_content": {
"default": false,
"type": "boolean"
},
"limit": {
"default": 20,
"type": "integer"
},
"query": {
"type": "string"
},
"states": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null
},
"tags": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null
}
},
"required": [
"query"
],
"type": "object"
}