By name: scitex-scholar
description: |
[WHAT] Scientific-paper search, metadata enrichment, PDF download, and BibTeX library management for the SciTeX ecosystem.
[WHEN] Use when searching the literature, resolving DOIs, enriching citations, downloading PDFs through institutional access, or managing a reproducible paper library.
[HOW] import scitex_scholar for the Python API; see leaf skills for entry points.
tags: [scitex-scholar]
allowed-tools: mcp__scitex__scholar_*
type: reference
scitex-scholar
Unified toolkit for scientific literature workflows: search across
multiple academic databases, resolve DOIs, enrich BibTeX with impact
factors and citation counts, download PDFs (including paywalled papers
via OpenAthens browser automation), and organise papers in a
deduplicated, project-based library at ~/.scitex/scholar/library/.
Installation & import (two equivalent paths)
The same module is reachable via two install paths. Both forms work at runtime; which one a user has depends on their install choice.
# Standalone — pip install scitex-scholar
import scitex_scholar
scitex_scholar.Scholar(...)
# Umbrella — pip install scitex
import scitex.scholar
scitex.scholar.Scholar(...)
pip install scitex-scholar alone does NOT expose the scitex namespace;
import scitex.scholar raises ModuleNotFoundError. To use the
scitex.scholar form, also pip install scitex.
See [../../general/02_interface-python-api.md] for the ecosystem-wide rule and empirical verification table.
Sub-skills
Mandatory leaves
- 01_installation.md — pip install + extras + smoke verify
- 02_quick-start.md — minimal search-and-save example
- 03_python-api.md — top-level public callables
- 04_cli-reference.md —
scitex-scholarsubcommand summary
Core / interfaces
- 05_mcp-tools.md — MCP tools (
scholar_*namespace) - 06_api-overview.md — top-level re-exports, subpackages, storage layout, install extras
Workflows
- 10_authentication.md — OpenAthens SSO login, session caching, cookie storage
- 11_search.md — multi-source search (CrossRef, OpenAlex, Semantic Scholar, PubMed, arXiv)
- 12_doi-resolution.md — resolve DOIs from titles, resumable batches, rate limits
- 13_bibtex-enrichment.md — add metadata (abstract, citations, IF) with per-field provenance
- 14_pdf-download.md — OpenURL → publisher → PDF, Zotero translators, browser modes
- 15_library-management.md — MASTER/8DIGIT-ID storage, project symlinks, metadata.json
- 16_semantic-highlight.md — overlay claim / method / limitation highlights on a PDF
Environment
- 20_env-vars.md — SCITEX_* env vars read by scitex-scholar at runtime
Lessons learned
- 30_extraction-lessons.md — extraction edge cases, parser pitfalls, and accumulated bug-fix notes