scitex-scholar

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-scholar subcommand 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