Semantic Scholar Ext Tools#

Configuration File: semantic_scholar_ext_tools.json Tool Type: Local Tools Count: 7

This page contains all tools defined in the semantic_scholar_ext_tools.json configuration file.

Available Tools#

SemanticScholar_get_author (Type: BaseRESTTool)#

Get detailed profile for a specific author on Semantic Scholar by author ID. Returns name, h-inde…

SemanticScholar_get_author tool specification

Tool Information:

  • Name: SemanticScholar_get_author

  • Type: BaseRESTTool

  • Description: Get detailed profile for a specific author on Semantic Scholar by author ID. Returns name, h-index, citation count, paper count, affiliations, homepage, and optionally their paper list with titles, years, and citation counts. Use SemanticScholar_search_authors first to find the author ID.

Parameters:

  • author_id (string) (required) Semantic Scholar author ID (e.g., ‘1741101’ for Oren Etzioni). Find using SemanticScholar_search_authors.

  • fields (string) (optional) Comma-separated fields: name,hIndex,citationCount,paperCount,affiliations,homepage,papers.title,papers.year,papers.citationCount,papers.paperId

Example Usage:

query = {
    "name": "SemanticScholar_get_author",
    "arguments": {
        "author_id": "example_value"
    }
}
result = tu.run(query)

SemanticScholar_get_author_papers (Type: BaseRESTTool)#

List an author’s publication bibliography from Semantic Scholar. Results use offset pagination: b…

SemanticScholar_get_author_papers tool specification

Tool Information:

  • Name: SemanticScholar_get_author_papers

  • Type: BaseRESTTool

  • Description: List an author’s publication bibliography from Semantic Scholar. Results use offset pagination: begin with offset=0 and continue with metadata.next_offset while metadata.has_more is true. This endpoint exposes a next offset but not an exact total. Returns one row per paper with citations, year, venue, and identifiers.

Parameters:

  • author_id (string) (required) Semantic Scholar author ID (e.g., ‘1741101’ for Oren Etzioni). Find using SemanticScholar_search_authors.

  • fields (string) (optional) Comma-separated per-paper fields. Available: paperId, title, year, citationCount, referenceCount, venue, externalIds, authors, openAccessPdf, abstract, publicationTypes, fieldsOfStudy. Default returns core bibliographic and impact fields.

  • limit (integer) (optional) Maximum number of papers to return (default 50, max 1000).

  • offset (integer) (optional) Zero-based paper offset. Continue with metadata.next_offset while metadata.has_more is true.

Example Usage:

query = {
    "name": "SemanticScholar_get_author_papers",
    "arguments": {
        "author_id": "example_value"
    }
}
result = tu.run(query)

SemanticScholar_get_paper (Type: BaseRESTTool)#

Get detailed metadata for a specific paper from Semantic Scholar by paper ID, DOI, PubMed ID, or …

SemanticScholar_get_paper tool specification

Tool Information:

  • Name: SemanticScholar_get_paper

  • Type: BaseRESTTool

  • Description: Get detailed metadata for a specific paper from Semantic Scholar by paper ID, DOI, PubMed ID, or other identifier. Returns title, abstract, AI-generated TLDR summary, authors, citation count, reference count, journal, publication types, fields of study, open access PDF link, and external IDs (DOI, PubMed, ArXiv, etc.). Identifier formats: Semantic Scholar paper ID (40-char hex), DOI: prefix (e.g., ‘DOI:10.1126/science.1225829’), PMID: prefix (e.g., ‘PMID:22745249’), ArXiv: prefix (e.g., ‘ArXiv:2106.01345’), or CorpusId: prefix. This complements SemanticScholar_search_papers by providing full paper details.

Parameters:

  • paper_id (string) (required) Paper identifier. Supports multiple formats: Semantic Scholar ID (e.g., ‘68d962effe5520777791bd6ec8ffa4b963ba4f38’), DOI (e.g., ‘DOI:10.1126/science.1225829’), PubMed (e.g., ‘PMID:22745249’), ArXiv (e.g., ‘ArXiv:2106.01345’), or CorpusId (e.g., ‘CorpusId:14088426’).

  • fields (string) (optional) Comma-separated list of fields to return. Available: paperId,title,abstract,year,citationCount,referenceCount,openAccessPdf,journal,publicationTypes,externalIds,authors,tldr,publicationDate,venue,fieldsOfStudy. Default returns core fields.

Example Usage:

query = {
    "name": "SemanticScholar_get_paper",
    "arguments": {
        "paper_id": "example_value"
    }
}
result = tu.run(query)

SemanticScholar_get_paper_citations (Type: BaseRESTTool)#

List one page of papers that CITE a given paper, including citation intents, influence flag, cont…

SemanticScholar_get_paper_citations tool specification

Tool Information:

  • Name: SemanticScholar_get_paper_citations

  • Type: BaseRESTTool

  • Description: List one page of papers that CITE a given paper, including citation intents, influence flag, contexts, and citing-paper metadata. Continue with metadata.next_offset while metadata.has_more is true. Semantic Scholar does not send a total on intermediate pages, so metadata gives a lower bound; the terminal page establishes the exact total.

Parameters:

  • paper_id (string) (required) Paper identifier whose CITING papers to list. Semantic Scholar ID (e.g., ‘204e3073870fae3d05bcbc2f6a8e263d9b72e776’ for ‘Attention Is All You Need’), or DOI:/PMID:/ArXiv:/CorpusId: prefixed identifier.

  • fields (string) (optional) Comma-separated fields for each citation record. Citation-edge fields: intents, isInfluential, contexts. Citing-paper fields are prefixed (e.g., title, year, authors, citationCount, externalIds, openAccessPdf, abstract). Default returns intents, isInfluential, contexts and core citing-paper metadata.

  • limit (integer) (optional) Maximum number of citing papers to return (default 20, max 1000).

  • offset (integer) (optional) Zero-based citation offset (default 0). Continue with metadata.next_offset.

Example Usage:

query = {
    "name": "SemanticScholar_get_paper_citations",
    "arguments": {
        "paper_id": "example_value"
    }
}
result = tu.run(query)

SemanticScholar_get_paper_references (Type: BaseRESTTool)#

List one page of papers that a given paper CITES, including citation intents, influence flag, con…

SemanticScholar_get_paper_references tool specification

Tool Information:

  • Name: SemanticScholar_get_paper_references

  • Type: BaseRESTTool

  • Description: List one page of papers that a given paper CITES, including citation intents, influence flag, contexts, and cited-paper metadata. Continue with metadata.next_offset while metadata.has_more is true. Intermediate pages expose a lower bound; the terminal page establishes the exact reference total.

Parameters:

  • paper_id (string) (required) Paper identifier whose REFERENCES (cited papers) to list. Semantic Scholar ID (e.g., ‘204e3073870fae3d05bcbc2f6a8e263d9b72e776’ for ‘Attention Is All You Need’), or DOI:/PMID:/ArXiv:/CorpusId: prefixed identifier.

  • fields (string) (optional) Comma-separated fields for each reference record. Citation-edge fields: intents, isInfluential, contexts. Cited-paper fields are prefixed (e.g., title, year, authors, citationCount, externalIds, openAccessPdf, abstract). Default returns intents, isInfluential, contexts and core cited-paper metadata.

  • limit (integer) (optional) Maximum number of cited papers to return (default 20, max 1000).

  • offset (integer) (optional) Zero-based reference offset (default 0). Continue with metadata.next_offset.

Example Usage:

query = {
    "name": "SemanticScholar_get_paper_references",
    "arguments": {
        "paper_id": "example_value"
    }
}
result = tu.run(query)

SemanticScholar_get_recommendations (Type: BaseRESTTool)#

Get paper recommendations from Semantic Scholar for a given paper. Returns papers similar to or r…

SemanticScholar_get_recommendations tool specification

Tool Information:

  • Name: SemanticScholar_get_recommendations

  • Type: BaseRESTTool

  • Description: Get paper recommendations from Semantic Scholar for a given paper. Returns papers similar to or related to the input paper based on Semantic Scholar’s recommendation algorithm. Useful for literature discovery - finding related work that you might have missed. Requires a Semantic Scholar paper ID (40-char hex). Use SemanticScholar_get_paper with DOI: prefix first to get the paper ID if you only have a DOI.

Parameters:

  • paper_id (string) (required) Semantic Scholar paper ID (40-char hex, e.g., ‘68d962effe5520777791bd6ec8ffa4b963ba4f38’). Get this from SemanticScholar_get_paper or SemanticScholar_search_papers.

  • limit (integer) (optional) Number of recommendations to return (default 10, max 500)

  • fields (string) (optional) Comma-separated fields for recommended papers: title,year,citationCount,abstract,authors,externalIds

Example Usage:

query = {
    "name": "SemanticScholar_get_recommendations",
    "arguments": {
        "paper_id": "example_value"
    }
}
result = tu.run(query)

SemanticScholar_search_authors (Type: BaseRESTTool)#

Search for researchers/authors on Semantic Scholar by name. Results use exact offset pagination: …

SemanticScholar_search_authors tool specification

Tool Information:

  • Name: SemanticScholar_search_authors

  • Type: BaseRESTTool

  • Description: Search for researchers/authors on Semantic Scholar by name. Results use exact offset pagination: begin with offset=0 and continue with metadata.next_offset while metadata.has_more is true; metadata.total_results is exact. Returns author IDs, names, h-index, citation count, paper count, and affiliations. Anonymous rate limits are about 1 request/second.

Parameters:

  • query (string) (required) Author name to search for (e.g., ‘Jennifer Doudna’, ‘Oren Etzioni’, ‘Yann LeCun’)

  • limit (integer) (optional) Maximum number of results (default 5, max 1000)

  • offset (integer) (optional) Zero-based author offset. Continue with metadata.next_offset while metadata.has_more is true.

  • fields (string) (optional) Comma-separated fields: name,hIndex,citationCount,paperCount,affiliations

Example Usage:

query = {
    "name": "SemanticScholar_search_authors",
    "arguments": {
        "query": "example_value"
    }
}
result = tu.run(query)