Search Ganjoor Recitations
ganjoor_search_recitationsSearch published Ganjoor audio recitations by reciter, poet, or category to find performances of specific poems.
Instructions
Search the published audio recitations (روایت) of Ganjoor poems, optionally by reciter or poem.
Each recitation is a sung or spoken performance of one poem by a named artist, published on ganjoor.net.
Args:
search_term (string): Optional text to match against the reciter's (artist's) name
poet_id (number): Restrict to a poet id. 0 = all poets (default: 0)
cat_id (number): Restrict to a category id. 0 = all categories (default: 0)
page (number): Page number, starting from 1 (default: 1)
page_size (number): Items per page, 1-100 (default: 20)
response_format ('markdown' | 'json'): Output format (default: 'markdown')
Returns: For JSON: { count, page, page_size, has_more, next_page, recitations: [{ id, poem_id, poem_title, poem_url, artist, title, publish_date, duration_seconds }] }
Examples:
"Any recitations by محمدرضا ضیاء?" -> search_term='محمدرضا ضیاء'
"Recitations of Hafez's ghazals" -> poet_id=2
Notes:
When scoped to a poet or category, results are ordered by poem id; otherwise by publish date, newest first.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "ganjoor_search_recitations"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number, starting from 1. | |
| cat_id | No | Restrict to a category id. 0 = all categories. | |
| poet_id | No | Restrict to a poet id. 0 = all poets. | |
| page_size | No | Maximum items to return per page (1-100, default 20). | |
| search_term | No | Text to match against the reciter's name. Empty matches all artists. | |
| response_format | No | Output format: 'markdown' for human-readable text (default) or 'json' for machine-readable structured data. | markdown |