search_sciencedirect
Search academic papers from Elsevier's ScienceDirect database using queries, filters for year, author, journal, and open access status.
Instructions
Search academic papers from Elsevier ScienceDirect database (requires API key)
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | Search query string | |
| maxResults | No | Maximum number of results to return | |
| year | No | Year filter (e.g., "2023", "2020-2023") | |
| author | No | Author name filter | |
| journal | No | Journal name filter | |
| openAccess | No | Filter for open access articles only |
Implementation Reference
- src/mcp/handleToolCall.ts:325-345 (handler)Main execution handler for the 'search_sciencedirect' MCP tool. Parses arguments, checks API key, invokes the ScienceDirect searcher, and formats the JSON response.case 'search_sciencedirect': { const { query, maxResults, year, author, journal, openAccess } = args; if (!process.env.ELSEVIER_API_KEY) { throw new Error('Elsevier API key not configured. Please set ELSEVIER_API_KEY environment variable.'); } const results = await searchers.sciencedirect.search(query, { maxResults, year, author, journal, openAccess }); return jsonTextResponse( `Found ${results.length} ScienceDirect papers.\n\n${JSON.stringify( results.map((paper: Paper) => PaperFactory.toDict(paper)), null, 2 )}` ); }
- src/mcp/schemas.ts:148-157 (schema)Zod schema for validating input parameters to the 'search_sciencedirect' tool.export const SearchScienceDirectSchema = z .object({ query: z.string().min(1), maxResults: z.number().int().min(1).max(100).optional().default(10), year: z.string().optional(), author: z.string().optional(), journal: z.string().optional(), openAccess: z.boolean().optional() }) .strip();
- src/mcp/tools.ts:367-389 (registration)MCP tool registration definition including name, description, and input schema.name: 'search_sciencedirect', description: 'Search academic papers from Elsevier ScienceDirect database (requires API key)', inputSchema: { type: 'object', properties: { query: { type: 'string', description: 'Search query string' }, maxResults: { type: 'number', minimum: 1, maximum: 100, description: 'Maximum number of results to return' }, year: { type: 'string', description: 'Year filter (e.g., "2023", "2020-2023")' }, author: { type: 'string', description: 'Author name filter' }, journal: { type: 'string', description: 'Journal name filter' }, openAccess: { type: 'boolean', description: 'Filter for open access articles only' } }, required: ['query'] } },
- Core search method in ScienceDirectSearcher class that performs the actual API request to Elsevier's ScienceDirect search endpoint, handles filters, rate limiting, and parses responses into Paper objects.async search(query: string, options: SearchOptions = {}): Promise<Paper[]> { const customOptions = options as any; if (!this.apiKey) { throw new Error('ScienceDirect API key is required'); } const maxResults = Math.min(options.maxResults || 10, 100); const papers: Paper[] = []; try { // Use PUT method with new API format (matching Python implementation) const requestBody: any = { qs: query }; // Add year filter if (options.year) { if (options.year.includes('-')) { const [startYear, endYear] = options.year.split('-'); requestBody.date = endYear ? `${startYear}-${endYear}` : startYear; } else { requestBody.date = options.year; } } // Add author filter if (options.author) { requestBody.authors = options.author; } // Display options requestBody.display = { offset: 0, show: maxResults, sortBy: options.sortBy === 'date' ? 'date' : 'relevance' }; await this.rateLimiter.waitForPermission(); const response = await this.client.put('/content/search/sciencedirect', requestBody, { headers: { 'Content-Type': 'application/json' } }); const results = response.data?.results || []; for (const result of results) { const paper = this.parseNewApiResult(result); if (paper) { papers.push(paper); } } // Enrich with abstracts if requested if (customOptions.includeAbstract && papers.length > 0) { const enrichedPapers = await this.enrichPapersWithAbstracts(papers); return enrichedPapers; } return papers; } catch (error: any) { this.handleHttpError(error, 'search'); } }
- src/mcp/searchers.ts:37-81 (helper)Initialization and registration of the ScienceDirectSearcher instance in the global searchers object, used by the tool handler.export function initializeSearchers(): Searchers { if (searchers) return searchers; logDebug('Initializing searchers...'); const arxivSearcher = new ArxivSearcher(); const wosSearcher = new WebOfScienceSearcher(process.env.WOS_API_KEY, process.env.WOS_API_VERSION); const pubmedSearcher = new PubMedSearcher(process.env.PUBMED_API_KEY); const biorxivSearcher = new BioRxivSearcher('biorxiv'); const medrxivSearcher = new MedRxivSearcher(); const semanticSearcher = new SemanticScholarSearcher(process.env.SEMANTIC_SCHOLAR_API_KEY); const iacrSearcher = new IACRSearcher(); const googleScholarSearcher = new GoogleScholarSearcher(); const sciHubSearcher = new SciHubSearcher(); const scienceDirectSearcher = new ScienceDirectSearcher(process.env.ELSEVIER_API_KEY); const springerSearcher = new SpringerSearcher( process.env.SPRINGER_API_KEY, process.env.SPRINGER_OPENACCESS_API_KEY ); const wileySearcher = new WileySearcher(process.env.WILEY_TDM_TOKEN); const scopusSearcher = new ScopusSearcher(process.env.ELSEVIER_API_KEY); const crossrefSearcher = new CrossrefSearcher(process.env.CROSSREF_MAILTO); searchers = { arxiv: arxivSearcher, webofscience: wosSearcher, pubmed: pubmedSearcher, wos: wosSearcher, biorxiv: biorxivSearcher, medrxiv: medrxivSearcher, semantic: semanticSearcher, iacr: iacrSearcher, googlescholar: googleScholarSearcher, scholar: googleScholarSearcher, scihub: sciHubSearcher, sciencedirect: scienceDirectSearcher, springer: springerSearcher, wiley: wileySearcher, scopus: scopusSearcher, crossref: crossrefSearcher }; logDebug('Searchers initialized successfully'); return searchers; }