Literature Searcher
Run all commands from skills/literature-searcher. The package uses only the
Python standard library.
Search
python -m literature_searcher.searcher search "ionogel flexible sensor" --limit 10
python -m literature_searcher.searcher search "solid electrolyte" \
--platform openalex --platform semantic_scholar --year-from 2020 --year-to 2024Without --platform, the command searches CrossRef, OpenAlex, PubMed, and
Semantic Scholar. Scopus requires ELSEVIER_API_KEY.
Download Open-Access PDFs
python -m literature_searcher.searcher download --doi 10.1016/j.cej.2022.135593Downloads query Unpaywall by default. Enable the optional scihub-cli fallback
explicitly with --scihub-fallback auto.
Incremental Monitoring And Insight
New-Item -ItemType Directory -Force data | Out-Null
Copy-Item monitor_config.json.template data/monitor_config.jsonSet queries in data/monitor_config.json, then run:
python -m literature_searcher.monitor --config data/monitor_config.json
python -m literature_searcher.insight --input data/monitor_results.jsonMonitoring uses the HTTPS DeepLX endpoint in DEEPLX_ENDPOINT by default and
does not require a DeepL API key. To use a local OpenAI-compatible model
service, set LOCAL_LLM_BASE_URL and LOCAL_LLM_MODEL, then pass
--translator local_llm. Translation failures are recorded in the result JSON
and do not stop monitoring.
Python API
| Capability | Import | Entry point |
|---|---|---|
| Multi-platform search | literature_searcher.searcher |
search_papers() |
| Result deduplication | literature_searcher.searcher |
merge_and_deduplicate() |
| PDF download | literature_searcher.downloader |
Downloader.download_by_doi() |
| Paper classification | literature_searcher.classifier |
PaperClassifier.classify() |
| Incremental monitoring | literature_searcher.monitor |
run_monitor() |
| Coverage analysis | literature_searcher.insight |
analyze_coverage() |
PaperClassifier.classify() and batch_classify() accept both mappings and
objects with paper attributes.
Configuration
The package reads these optional variables from the process environment:
LITERATURE_EMAIL, OPENALEX_EMAIL, OPENALEX_API_KEY,
SEMANTIC_SCHOLAR_API_KEY, ELSEVIER_API_KEY, DEEPLX_ENDPOINT,
LOCAL_LLM_BASE_URL, and LOCAL_LLM_MODEL. Copy .env.example to .env in
the skill directory to load values automatically. Variables already exported by
the calling shell take precedence.