Semantic Scholar Tools¶

Configuration File: semantic_scholar_tools.json Tool Type: Local Tools Count: 2

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

Available Tools¶

SemanticScholar_get_pdf_snippets (Type: SemanticScholarPDFSnippetsTool)¶

Fetch a paper’s open-access PDF from Semantic Scholar and return bounded text snippets around pro…

SemanticScholar_get_pdf_snippets tool specification

Tool Information:

  • Name: SemanticScholar_get_pdf_snippets

  • Type: SemanticScholarPDFSnippetsTool

  • Description: Fetch a paper’s open-access PDF from Semantic Scholar and return bounded text snippets around provided terms. Uses markitdown to convert PDF to markdown. Useful when key details (methods, experimental parameters) are in the full text rather than abstract.

Parameters:

  • paper_id (string) (optional) Semantic Scholar paper ID (e.g., from SemanticScholar_search_papers). The tool will fetch the PDF URL if available.

  • open_access_pdf_url (string) (optional) Direct open access PDF URL (recommended when you already have it from SemanticScholar_search_papers).

  • terms (array) (required) Terms to search for in the extracted full text (case-insensitive).

  • window_chars (integer) (optional) Context window size (characters) before and after each match.

  • max_snippets_per_term (integer) (optional) Maximum number of snippets returned per term.

  • max_total_chars (integer) (optional) Hard cap on total characters returned across all snippets.

Example Usage:

query = {
    "name": "SemanticScholar_get_pdf_snippets",
    "arguments": {
        "terms": ["item1", "item2"]
    }
}
result = tu.run(query)

SemanticScholar_search_papers (Type: SemanticScholarTool)¶

Search for papers on Semantic Scholar including abstracts. This tool queries the Semantic Scholar…

SemanticScholar_search_papers tool specification

Tool Information:

  • Name: SemanticScholar_search_papers

  • Type: SemanticScholarTool

  • Description: Search for papers on Semantic Scholar including abstracts. This tool queries the Semantic Scholar API using natural language keywords and returns papers with details such as title, abstract, publication year, journal (venue), and URL. Rate limits: 1 req/sec without API key, 100 req/sec with SEMANTIC_SCHOLAR_API_KEY environment variable set.

Parameters:

  • query (string) (required) Search query for Semantic Scholar. Use keywords separated by spaces to refine the search.

  • limit (integer) (required) Maximum number of papers to return from Semantic Scholar.

  • include_abstract (boolean) (optional) If true, best-effort fetches missing abstracts via the paper detail endpoint (only when abstract is missing in search results).

Example Usage:

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