> ## Documentation Index
> Fetch the complete documentation index at: https://aisa.one/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# AIsa Scholar Search

> Find academic papers, citations, and scholarly sources.

[View on GitHub ->](https://github.com/AIsa-team/agent-skills/tree/main/scholar-search)

**Academic search for agents.** Find papers, scholarly articles, citations, and year-bounded research sources through AIsa.

## Install

First, install the AIsa CLI if you have not already:

```bash theme={null}
npm install -g @aisa-one/cli
```

Then install the skill:

```bash theme={null}
aisa skills install scholar-search
```

## What can agents do with it?

<CardGroup cols={2}>
  <Card title="Paper discovery" icon="graduation-cap">
    Find academic papers for a research question.
  </Card>

  <Card title="Literature scans" icon="book-open">
    Gather papers around a topic or method.
  </Card>

  <Card title="Evidence review" icon="quote-left">
    Summarize claims with scholarly context.
  </Card>

  <Card title="Research workflows" icon="microscope">
    Use scholarly evidence in agent reports.
  </Card>
</CardGroup>

## Setup

This skill requires the `AISA_API_KEY` environment variable. When installed as a Claude plugin, the key is configured via the plugin's `userConfig`.

## Usage

Run the search client with the `scholar` subcommand:

```bash theme={null}
python3 ${CLAUDE_PLUGIN_ROOT}/skills/scholar-search/scripts/search_client.py scholar --query "<academic query>" --count <max_results> [--year-from YYYY] [--year-to YYYY]
```

### Arguments

| Argument         | Required | Default | Description                       |
| ---------------- | -------- | ------- | --------------------------------- |
| `--query` / `-q` | Yes      | —       | Academic search query             |
| `--count` / `-c` | No       | 10      | Maximum number of results (1–100) |
| `--year-from`    | No       | —       | Year lower bound (e.g., 2023)     |
| `--year-to`      | No       | —       | Year upper bound (e.g., 2026)     |

### Examples

```bash theme={null}
# Search for recent transformer papers
python3 ${CLAUDE_PLUGIN_ROOT}/skills/scholar-search/scripts/search_client.py scholar --query "transformer architecture attention mechanism" --count 10 --year-from 2024

# Search papers in a specific year range
python3 ${CLAUDE_PLUGIN_ROOT}/skills/scholar-search/scripts/search_client.py scholar --query "reinforcement learning from human feedback" --year-from 2022 --year-to 2025
```

## Output

The script prints structured academic results including:

* **Title** — Paper title
* **URL** — Link to the paper or abstract
* **Publication info** — Journal, conference, or preprint source
* **Snippet** — Abstract excerpt

## When to Use

Use this skill when the user needs academic papers, scholarly articles, research citations, or peer-reviewed sources. Best for literature reviews, citation lookups, and academic research tasks.

## Get started

1. Sign up at [aisa.one](https://aisa.one) (new accounts start with \$2 free credit).
2. Generate an API key from the console.
3. Set your key and install the skill:
   ```bash theme={null}
   export AISA_API_KEY="your-key"
   npm install -g @aisa-one/cli
   aisa skills install scholar-search
   ```
4. Start a new agent session so the runtime loads the updated skill instructions.

## Related

<CardGroup cols={3}>
  <Card title="Scholar API reference" icon="graduation-cap" href="/api-reference/scholar/searchscholar">
    Academic search endpoint docs.
  </Card>

  <Card title="AIsa Smart Search" icon="wand-magic-sparkles" href="/agent-skills/smart-search">
    Combine web and scholar sources.
  </Card>

  <Card title="Multi-source Search" icon="magnifying-glass" href="/agent-skills/search">
    Broader research retrieval skill.
  </Card>
</CardGroup>