# Sci Search

> Academic paper search and metrics analysis. Searches arXiv, PubMed, Web of Science, Springer Nature, Scopus, Semantic Scholar, and OpenAlex simultaneously with journal impact factor data. Triggers on requests to search for papers or find literature.

- Skill: `shzhao27208/sci-search` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add shzhao27208/sci-search`
- Raw SKILL.md: https://api.skillmd.com/api/skills/shzhao27208/sci-search/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Research & Search
- License: MIT
- Author: shzhao27208 (https://skillmd.com/u/shzhao27208)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/shzhao27208/sci-search

---


# Sci-Search — Sci Search Skill

Academic paper search and metrics analysis tool for scientific research workflows.

## Trigger Phrases
- "搜索关于 [主题] 的高影响因子论文"
- "在 Web of Science 上查找 [主题] 的最新文献"
- "search academic papers on [topic]"
- "find recent papers about [topic] on Web of Science"
- "get impact factor for [topic] papers"

## Capabilities
- **Seven-Source Search**: Simultaneously searches arXiv, PubMed, **Web of Science**, **Springer Nature**, **Scopus**, **Semantic Scholar**, and **OpenAlex** (API-key-gated sources activate when keys are configured).
- **Web of Science Integration**: Returns SCI-indexed papers with times-cited counts — the gold standard for academic quality filtering.
- **Springer Nature Integration**: Returns articles from Springer, Nature, Palgrave Macmillan, and other Springer Nature imprints with DOI links.
- **Scopus Integration**: Elsevier's largest abstract and citation database; returns cited-by counts.
- **Semantic Scholar Integration**: AI-powered academic graph with citation counts; no API key required.
- **OpenAlex Integration**: Free and open catalog of 200M+ scholarly works; no API key required.
- **Journal Metrics**: Automatically supplements results with JCR partitions and Impact Factors (IF).
- **Ranking & Highlighting**: Highlights top-tier journals (Nature, Science, Advanced Materials, etc.).
- **Markdown Export**: Generates formatted markdown reports of search results.
- **Source Selection**: Use `--source scopus`, `--source springer`, `--source semantic_scholar`, `--source openalex`, `--source wos`, or `--source all` for all sources.

## Configuration

### Web of Science API (Recommended for SCI literature)
Add `WOS_API_KEY` to the unified `~/.aut_sci_write/.env` file to enable Web of Science search:
```bash
WOS_API_KEY=your_wos_api_key
```
Apply for a free API key at: https://developer.clarivate.com/apis/wos-starter

The **WoS Starter API** is free to apply for and provides access to the Web of Science Core Collection — the most authoritative index of SCI/SSCI journals.

### Springer Nature API (two endpoints)
The Springer Nature API provides two separate endpoints:

**1. Metadata API** (`/meta/v2/json`) — metadata for all Springer Nature content (journals + books).
Add `SPRINGER_API_KEY` to `~/.aut_sci_write/.env`:
```bash
SPRINGER_API_KEY=your_springer_api_key
```

**2. Open Access API** (`/openaccess/json`) — full-text OA content from BMC, SpringerOpen, Nature OA articles.
Add `SPRINGER_OA_API_KEY` to `~/.aut_sci_write/.env` (falls back to `SPRINGER_API_KEY` if not set):
```bash
SPRINGER_OA_API_KEY=your_oa_api_key
```

Apply for free API keys at: https://dev.springernature.com/

Use `--source springer` for both, `--source springer_meta` for metadata only, or `--source springer_oa` for Open Access only.

### Scopus API (Elsevier — largest abstract database)
Add `SCOPUS_API_KEY` to `~/.aut_sci_write/.env` to enable Scopus search:
```bash
SCOPUS_API_KEY=your_scopus_api_key
```
Apply for a free API key at: https://dev.elsevier.com/

The **Scopus Search API** covers 90M+ records across science, technology, medicine, social sciences, and arts & humanities. Requires institutional affiliation for full access.

### Semantic Scholar (free, no key required)
Works out of the box. For higher rate limits, optionally add:
```bash
SEMANTIC_SCHOLAR_API_KEY=your_key
```
Request a key at: https://www.semanticscholar.org/product/api#api-key

### OpenAlex (free, no key required)
Works out of the box. For polite pool (faster rate limits), optionally add:
```bash
OPENALEX_EMAIL=your_email@example.com
```

### Other optional `.env` values (all in `~/.aut_sci_write/.env`)
- `SPRINGER_API_KEY` - Springer Nature Metadata API key (see above)
- `SPRINGER_OA_API_KEY` - Springer Nature Open Access API key (falls back to SPRINGER_API_KEY)
- `SCOPUS_API_KEY` - Elsevier Scopus API key (see above)
- `SEMANTIC_SCHOLAR_API_KEY` - optional, for higher rate limits
- `OPENALEX_EMAIL` - optional, for polite pool access
- `NCBI_API_KEY` - optional PubMed/NCBI E-utilities API key for higher rate limits
- `NCBI_EMAIL` - optional contact email sent to NCBI E-utilities
- `NCBI_TOOL` - optional NCBI tool name; defaults to `sci-search`
- `ZOTERO_USER_ID` — for Zotero integration
- `ZOTERO_API_KEY` — for Zotero integration

## Usage

Main script: `./sci_search.py`

```bash
# Search all sources (arXiv + PubMed + WoS + Springer + Scopus + Semantic Scholar + OpenAlex)
python skills/sci-search/sci_search.py "perovskite solar cells" --limit 5

# Search Web of Science only
python skills/sci-search/sci_search.py "solid state electrolyte" --source wos --limit 10

# Search PubMed only with NCBI E-utilities
python skills/sci-search/sci_search.py "cancer immunotherapy" --source pubmed --limit 10

# Search Springer Nature only
python skills/sci-search/sci_search.py "machine learning materials science" --source springer --limit 10

# Search Scopus only
python skills/sci-search/sci_search.py "lithium ion battery" --source scopus --limit 10

# Search Semantic Scholar only (no key needed)
python skills/sci-search/sci_search.py "transformer attention mechanism" --source semantic_scholar --limit 10

# Search OpenAlex only (no key needed)
python skills/sci-search/sci_search.py "CRISPR gene editing" --source openalex --limit 10

# Export results to markdown
python skills/sci-search/sci_search.py "graphene battery" --output results.md
```



---
## © License & Copyright
**Aut_Sci_Write** — Autonomous Scientific Writer

- **Author**: Shuo Zhao
- **License**: MIT License
- **Copyright**: © 2026 Shuo Zhao. All rights reserved.
- **Original Work**: This is an original work created by the author. No reproduction, redistribution, or commercial use without explicit permission.
  **Permission is hereby granted**, free of charge, to any person obtaining a copy of this software... (**See the LICENSE file in the root directory for the full MIT terms.**)

---
*This skill is part of the Aut_Sci_Write suite. For full license terms, see the [LICENSE](../LICENSE) file in the project root.*
---