models

class google_scholar_search_mcp.models.PaperResult(*, title, authors=<factory>, year=None, abstract=None, num_citations=0, url=None, pub_url=None, venue=None, scholar_id=None)[source]

Bases: BaseModel

A paper in a search result list.

title: str
authors: list[str]
year: int | None
abstract: str | None
num_citations: int
url: str | None
pub_url: str | None
venue: str | None
scholar_id: str | None
model_config = {}

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

class google_scholar_search_mcp.models.PaperDetails(*, title, authors=<factory>, year=None, abstract=None, num_citations=0, url=None, pub_url=None, venue=None, scholar_id=None, cites_per_year=<factory>, public_access=None, bibtex=None)[source]

Bases: PaperResult

A paper with details, citation history and BibTeX.

cites_per_year: dict[int, int]
public_access: bool | None
bibtex: str | None
model_config = {}

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

class google_scholar_search_mcp.models.SearchResponse(*, query, total_results, papers, message=None, offset=0, next_offset=None)[source]

Bases: BaseModel

Result of a single keyword search.

query: str
total_results: int
papers: list[PaperResult]
message: str | None
offset: int
next_offset: int | None
model_config = {}

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

class google_scholar_search_mcp.models.BulkSearchResponse(*, results, total_queries, completed_queries, errors=<factory>)[source]

Bases: BaseModel

Combined result of several searches run in one call.

results: list[SearchResponse]
total_queries: int
completed_queries: int
errors: list[str]
model_config = {}

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

class google_scholar_search_mcp.models.CitationResponse(*, cited_paper_title=None, total_citations=None, citations, offset=0, next_offset=None)[source]

Bases: BaseModel

Papers that cite a given paper.

cited_paper_title: str | None
total_citations: int | None
citations: list[PaperResult]
offset: int
next_offset: int | None
model_config = {}

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].