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 full publication bibliography from Semantic Scholar, one row per paper, with per…

SemanticScholar_get_author_papers tool specification

Tool Information:

  • Name: SemanticScholar_get_author_papers

  • Type: BaseRESTTool

  • Description: List an author’s full publication bibliography from Semantic Scholar, one row per paper, with per-paper citation counts, publication years, venues, and identifiers. This is the enumerable paper list that the aggregate-profile tool (SemanticScholar_get_author: hIndex, total citationCount, paperCount) does not return. Provide the Semantic Scholar author ID; find it with SemanticScholar_search_authors.

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) Pagination offset into the author’s paper list (default 0).

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 the papers that CITE a given paper, with per-citation detail: the citation INTENTS (backgrou…

SemanticScholar_get_paper_citations tool specification

Tool Information:

  • Name: SemanticScholar_get_paper_citations

  • Type: BaseRESTTool

  • Description: List the papers that CITE a given paper, with per-citation detail: the citation INTENTS (background, methodology, result), an isInfluential flag (highly influential citation), and the citing-sentence CONTEXTS. This is the enumerable per-citing-paper view that aggregate citation-count or supporting/contradicting-tally tools do not provide. Provide a Semantic Scholar paper ID (40-char hex), or a DOI:/PMID:/ArXiv:/CorpusId: prefixed identifier. Use SemanticScholar_get_paper or SemanticScholar_search_papers to find the paper ID. Each result row wraps the citing paper under ‘citingPaper’.

Parameters:

  • paper_id (string) (required) Paper identifier whose CITING papers to list. Semantic Scholar ID (e.g., ‘649def34f8be52c8b66281af98ae884c09aef38b’ 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) Pagination offset into the citation list (default 0).

Example Usage:

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

SemanticScholar_get_paper_references (Type: BaseRESTTool)

List the papers that a given paper CITES (its reference list / bibliography), with per-reference …

SemanticScholar_get_paper_references tool specification

Tool Information:

  • Name: SemanticScholar_get_paper_references

  • Type: BaseRESTTool

  • Description: List the papers that a given paper CITES (its reference list / bibliography), with per-reference detail: the citation INTENTS (background, methodology, result), an isInfluential flag, and the citing-sentence CONTEXTS for each reference. This complements bare-DOI reference lists by adding WHY each work is cited. Provide a Semantic Scholar paper ID (40-char hex), or a DOI:/PMID:/ArXiv:/CorpusId: prefixed identifier. Each result row wraps the cited paper under ‘citedPaper’.

Parameters:

  • paper_id (string) (required) Paper identifier whose REFERENCES (cited papers) to list. Semantic Scholar ID (e.g., ‘649def34f8be52c8b66281af98ae884c09aef38b’ 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) Pagination offset into the reference list (default 0).

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. Returns author IDs, names, h-index, c…

SemanticScholar_search_authors tool specification

Tool Information:

  • Name: SemanticScholar_search_authors

  • Type: BaseRESTTool

  • Description: Search for researchers/authors on Semantic Scholar by name. Returns author IDs, names, h-index, citation count, paper count, and affiliations. Use the authorId from results with SemanticScholar_get_author for detailed profiles. Rate limits: 1 req/sec without API key.

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)

  • 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)