← Back to Plugins
Tools

Ai4scholar

glfruit By glfruit 👁 29 views ▲ 0 votes

Forked AI4Scholar plugin for OpenClaw with local fixes

GitHub

Install

openclaw plugins install ai4scholar

Configuration Example

{
  "plugins": {
    "entries": {
      "ai4scholar": {
        "enabled": true,
        "config": {
          "apiKey": "<your-api-key>"
        }
      }
    }
  }
}

README

# AI4Scholar

**Multi-source academic literature search, management, and analysis plugin for [OpenClaw](https://github.com/openclaw/openclaw).**

Powered by [ai4scholar.net](https://ai4scholar.net).

## What It Does

AI4Scholar gives your OpenClaw agent direct access to **6 academic platforms** through **36 built-in tools**.

### Platforms

| Platform | Coverage |
|----------|----------|
| **Semantic Scholar** | 200M+ papers across all fields |
| **PubMed** | Biomedical & life sciences |
| **Google Scholar** | Broad academic search |
| **arXiv** | Physics, CS, math, biology preprints |
| **bioRxiv** | Biology preprints |
| **medRxiv** | Health sciences preprints |

### Tools (36)

**Search (9)**

| Tool | Platform | Description |
|------|----------|-------------|
| `search_semantic` | Semantic Scholar | Search papers with year filtering |
| `search_pubmed` | PubMed | Biomedical papers, date range + sorting |
| `search_google_scholar` | Google Scholar | Broad academic search via ai4scholar proxy |
| `search_arxiv` | arXiv | Preprints search |
| `search_biorxiv` | bioRxiv | Biology preprints by category + date |
| `search_medrxiv` | medRxiv | Health preprints by category + date |
| `search_semantic_snippets` | Semantic Scholar | Full-text snippet search (~500 word excerpts) |
| `search_semantic_bulk` | Semantic Scholar | Bulk search, up to 1000 results with pagination |
| `search_semantic_paper_match` | Semantic Scholar | Exact title matching |

**Paper Details & Batch (4)**

| Tool | Description |
|------|-------------|
| `get_semantic_paper_detail` | Paper metadata by ID (DOI, arXiv ID, PMID, etc.) |
| `get_pubmed_paper_detail` | PubMed paper metadata by PMID |
| `get_semantic_paper_batch` | Batch paper details (up to 500) |
| `get_pubmed_paper_batch` | Batch PubMed details |

**Citations & References (4)**

| Tool | Description |
|------|-------------|
| `get_semantic_citations` | Papers citing the given paper |
| `get_semantic_references` | Papers referenced by the given paper |
| `get_pubmed_citations` | PubMed citation lookup |
| `get_pubmed_related` | PubMed related papers |

**Authors (5)**

| Tool | Description |
|------|-------------|
| `search_semantic_authors` | Search authors by name |
| `get_semantic_author_detail` | Author profile (h-index, papers, citations) |
| `get_semantic_author_papers` | All papers by an author |
| `get_semantic_author_batch` | Batch author details (up to 1000) |
| `get_semantic_paper_authors` | All authors of a paper |

**Recommendations (2)**

| Tool | Description |
|------|-------------|
| `get_semantic_recommendations` | Recommend papers from positive/negative examples |
| `get_semantic_recommendations_for_paper` | Similar papers for a single paper |

**PDF Download & Full-Text Reading (10)**

| Tool | Description |
|------|-------------|
| `download_semantic` | Open access PDF URL from Semantic Scholar |
| `read_semantic_paper` | Download + extract full text (Semantic Scholar) |
| `download_arxiv` | arXiv PDF URL |
| `read_arxiv_paper` | Download + extract full text (arXiv) |
| `download_biorxiv` | bioRxiv PDF URL |
| `download_medrxiv` | medRxiv PDF URL |
| `read_biorxiv_paper` | Download + extract full text (bioRxiv) |
| `read_medrxiv_paper` | Download + extract full text (medRxiv) |
| `download_by_doi` | Download PDF by DOI (supports institutional access) |
| `read_by_doi` | Download + extract full text by DOI |

**Auto-Citation (1)**

| Tool | Description |
|------|-------------|
| `auto_cite` | One-click citation annotation: add real references to academic text (IEEE/APA/Vancouver/Nature styles) |

**Scientific Drawing (1)**

| Tool | Description |
|------|-------------|
| `sci_draw` | AI-powered scientific figure generation (text-to-image, edit, style transfer, SVG, critique) |

### Slash Commands

| Command | Description |
|---------|-------------|
| `/library` | List downloaded papers in the active project |
| `/projects` | List all literature projects |
| `/reading-list` | Show the reading list |

## Install

### From npm (recommended)

```bash
openclaw plugins install ai4scholar
```

After installation, **restart the gateway**:

```bash
openclaw gateway stop && openclaw gateway start
```

### Update

```bash
openclaw plugins update ai4scholar
```

### Verify

```bash
openclaw plugins list
# Should show: ai4scholar (enabled)
```

## Configuration

Set your API key in `openclaw.json`:

```json
{
  "plugins": {
    "entries": {
      "ai4scholar": {
        "enabled": true,
        "config": {
          "apiKey": "<your-api-key>"
        }
      }
    }
  }
}
```

Get your API key at [ai4scholar.net](https://ai4scholar.net?src=openclaw).

## Usage

Just talk to your OpenClaw agent:

```
Search for recent papers on CRISPR in cancer immunotherapy
```

```
Read the full text of arXiv:2401.12345 and summarize the Methods section
```

```
Add citations to this Introduction paragraph: <paste text>
```

```
Give me a literature survey on protein folding methods since 2020
```

For detailed usage, visit [ai4scholar.net](https://ai4scholar.net?src=openclaw).

## Project Structure

```
ai4scholar/
โ”œโ”€โ”€ src/
โ”‚   โ”œโ”€โ”€ tools/
โ”‚   โ”‚   โ”œโ”€โ”€ api-client.ts        # HTTP client for ai4scholar.net
โ”‚   โ”‚   โ”œโ”€โ”€ semantic-scholar.ts  # 17 Semantic Scholar tools
โ”‚   โ”‚   โ”œโ”€โ”€ pubmed.ts            # 5 PubMed tools
โ”‚   โ”‚   โ”œโ”€โ”€ google-scholar.ts    # Google Scholar search
โ”‚   โ”‚   โ”œโ”€โ”€ arxiv.ts             # 3 arXiv tools
โ”‚   โ”‚   โ”œโ”€โ”€ biorxiv.ts           # 6 bioRxiv/medRxiv tools
โ”‚   โ”‚   โ”œโ”€โ”€ doi-download.ts      # 2 DOI-based download tools
โ”‚   โ”‚   โ”œโ”€โ”€ auto-cite.ts         # Auto-citation via ai4scholar API
โ”‚   โ”‚   โ”œโ”€โ”€ sci-draw.ts          # Scientific figure generation
โ”‚   โ”‚   โ”œโ”€โ”€ pdf-utils.ts         # PDF download & text extraction
โ”‚   โ”‚   โ”œโ”€โ”€ result.ts            # Tool result helpers
โ”‚   โ”‚   โ””โ”€โ”€ params.ts            # Parameter parsing
โ”‚   โ”œโ”€โ”€ hooks/
โ”‚   โ”‚   โ””โ”€โ”€ scholar-mode.ts      # Scholar mode system prompt
โ”‚   โ””โ”€โ”€ commands.ts              # Slash commands
โ”œโ”€โ”€ openclaw.plugin.json
โ””โ”€โ”€ index.ts
```

## License

MIT
tools

Comments

Sign in to leave a comment

Loading comments...