# Paper Finder

> |

- **Type:** Skill
- **Install:** `agentstack add skill-jesamkim-oh-my-skills-paper-finder`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [jesamkim](https://agentstack.voostack.com/s/jesamkim)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [jesamkim](https://github.com/jesamkim)
- **Source:** https://github.com/jesamkim/oh-my-skills/tree/main/my-skills/paper-finder

## Install

```sh
agentstack add skill-jesamkim-oh-my-skills-paper-finder
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Paper Finder

## Overview

Search academic papers across multiple APIs and produce structured results with citation counts, abstracts, and links. Designed for PoC research, technical exploration, and literature review.

## Workflow

### 1. Keyword Search

Run the search script with user's keywords:

```bash
python3 {SKILL_DIR}/scripts/search_papers.py search "" --limit 10
```

The script searches **Semantic Scholar** first. On rate limit (429) or failure, falls back to **OpenAlex**.

To search a specific source:

```bash
python3 {SKILL_DIR}/scripts/search_papers.py search "" --source semantic
python3 {SKILL_DIR}/scripts/search_papers.py search "" --source openalex
python3 {SKILL_DIR}/scripts/search_papers.py search "" --source arxiv
```

### 2. Paper Lookup by ID

Look up a specific paper by ArXiv ID or DOI:

```bash
python3 {SKILL_DIR}/scripts/search_papers.py lookup --arxiv 2301.00234
python3 {SKILL_DIR}/scripts/search_papers.py lookup --doi 10.1145/1234567.1234568
```

### 3. Output Options

**Markdown table** (default): Displays results in terminal as a formatted table.

**Save to file**:

```bash
python3 {SKILL_DIR}/scripts/search_papers.py search "" --output docs/papers/results.md
```

**BibTeX export**:

```bash
python3 {SKILL_DIR}/scripts/search_papers.py search "" --bibtex docs/papers/results.bib
```

**Sort by citations**:

```bash
python3 {SKILL_DIR}/scripts/search_papers.py search "" --sort citations
```

### 4. Present Results

After running the script, present results to the user as a markdown table:

| # | Title | Authors | Year | Citations | Link |
|---|-------|---------|------|-----------|------|

Include a brief summary of what was found and highlight the most relevant papers based on citation count and recency.

## Key Behaviors

- Always run the search script rather than constructing curl commands manually
- If the script is unavailable or fails, fall back to curl commands documented in `references/api_reference.md`
- Create `docs/papers/` directory before saving if it doesn't exist
- When user provides ArXiv IDs (e.g., 2301.00234), use the `lookup` command
- For broad research topics, suggest refining keywords if results are too generic
- Present results in Korean explanations with English paper titles preserved

## Rate Limit Notes

| API | Limit | Notes |
|-----|-------|-------|
| Semantic Scholar | 100 req/5min (no key) | Strict; get free key for higher limits |
| OpenAlex | ~100K req/day | Very generous; preferred fallback |
| ArXiv | 3 req/sec | Generous for normal use |

If Semantic Scholar returns 429, the script automatically retries with OpenAlex.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [jesamkim](https://github.com/jesamkim)
- **Source:** [jesamkim/oh-my-skills](https://github.com/jesamkim/oh-my-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-jesamkim-oh-my-skills-paper-finder
- Seller: https://agentstack.voostack.com/s/jesamkim
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.