search_papers
Search Google Scholar for academic papers by keyword and use year filters, sorting, or paging to narrow research results.
Instructions
Search Google Scholar for academic papers by keyword.
To page, call again with offset set to the next_offset of the
previous response (None means there are no more results). Each page
costs at least one slow request: only page when the user needs more.
Args: query (str): Search query (same syntax as Google Scholar search box). max_results (int): Maximum number of results to return (1-20, default 10). year_from (int | None): Filter to papers published in or after this year. year_to (int | None): Filter to papers published in or before this year. sort_by (str): Sort order — "relevance" (default) or "date". include_patents (bool): Include patents in results (default True). offset (int): Number of results to skip (default 0). Scholar serves at most the first 1000 results of a query.
Returns:
SearchResponse: Matching papers, with offset and next_offset for paging.
Raises:
ScholarBlockedError: If Google Scholar blocks the client.
ScholarRateLimitError: If Google Scholar throttles the request after retries.
ScholarInvalidArgumentError: If offset reaches past the first 1000 results.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "<query>"
},
"name": "search_papers"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | ||
| offset | No | ||
| sort_by | No | relevance | |
| year_to | No | ||
| year_from | No | ||
| max_results | No | ||
| include_patents | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | ||
| offset | No | ||
| papers | Yes | ||
| message | No | ||
| next_offset | No | ||
| total_results | Yes |