Assistance with writing literature reviews by searching for academic sources via Semantic Scholar, OpenAlex, Crossref and PubMed APIs. Use when the user needs to find papers on a topic, get details for specific DOIs, or draft sections of a literature review with proper citations.
Help write academic literature reviews using a multi-engine search integration (S2, OA, CR, PM).
efetch for full XML records).--source all or --source both), results are automatically deduplicated by DOI.USER_EMAIL env var).| Variable | Purpose | Default |
|---|---|---|
USER_EMAIL | Email for polite API access | [email protected] |
CLAWDBOT_EMAIL | Fallback if USER_EMAIL not set | — |
SEMANTIC_SCHOLAR_API_KEY | Optional S2 API key for higher rate limits | — |
OPENALEX_API_KEY | Optional OpenAlex API key | — |
Get a comprehensive overview from all major academic databases. Results are automatically deduplicated by DOI.
python3 scripts/lit_search.py search "impact of glycyrrhiza on bifidobacterium" --limit 5 --source all
oa): Fast and comprehensive, good abstracts.s2): High-quality citation data and TL;DRs.cr): Precise DOI-based metadata (no abstracts).pm): Gold standard for biomedical research, full abstracts and PMIDs.python3 scripts/lit_search.py search "prebiotic effects of liquorice" --source pm
Search both S2 and OA simultaneously to ensure nothing is missed. Deduplicated by default.
python3 scripts/lit_search.py search "Bifidobacterium infantis growth" --source both
Retrieve detailed metadata including TL;DR summaries.
python3 scripts/lit_search.py details "DOI:10.1016/j.foodchem.2023.136000"
Each result includes:
id: Source-specific identifier (PMID for PubMed, OpenAlex ID, S2 paper ID, DOI for Crossref)doi: DOI when available (used for deduplication)title: Paper titleyear: Publication yearauthors: List of author namesabstract: Full abstract text (when available)venue: Journal or conference namecitationCount: Citation count (S2, OA)source: Which database the result came fromcitationCount or recent years for a more modern review.--source pm for the most reliable biomedical literature.