> ## 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

> 查找学术论文、引用和 scholarly sources。

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

**面向 Agent 的学术搜索。** 用 AIsa 查询论文、引用和研究资料，适合文献综述、技术调研和学术背景核查。

## 安装

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

## Agent 可以做什么？

<CardGroup cols={2}>
  <Card title="论文发现" icon="book-open">
    根据主题、关键词或问题发现相关论文。
  </Card>

  <Card title="引用线索" icon="quote-left">
    获取标题、作者、摘要、年份和引用相关信息。
  </Card>

  <Card title="时间范围过滤" icon="calendar">
    聚焦某个年份或时间段的研究。
  </Card>

  <Card title="研究辅助" icon="microscope">
    为文献综述、技术评估和研究计划提供来源。
  </Card>
</CardGroup>

## 设置

需要 `AISA_API_KEY` 环境变量。不要在命令、日志或文档中写入真实 key。

## 用法

```bash theme={null}
python3 ${CLAUDE_PLUGIN_ROOT}/skills/scholar-search/scripts/search_client.py scholar --query "<paper topic>"
```

### 参数

| 参数               | 必填 | 说明           |
| ---------------- | -- | ------------ |
| `--query` / `-q` | 是  | 学术搜索关键词或研究问题 |
| `--year-start`   | 否  | 起始年份         |
| `--year-end`     | 否  | 结束年份         |
| `--limit`        | 否  | 返回结果数量       |

### 示例

```bash theme={null}
# 搜索近期 Transformer 论文
python3 ${CLAUDE_PLUGIN_ROOT}/skills/scholar-search/scripts/search_client.py scholar --query "recent transformer architecture papers"

# 搜索指定年份范围内的论文
python3 ${CLAUDE_PLUGIN_ROOT}/skills/scholar-search/scripts/search_client.py scholar --query "state space models" --year-start 2023 --year-end 2026
```

## 输出

通常包含论文标题、作者、年份、摘要/片段、来源链接和引用相关字段。Agent 应把这些结果作为研究证据入口，而不是直接把搜索结果当最终结论。

## 适用场景

* 学术论文发现
* 技术方向调研
* 文献综述初稿
* 比较不同方法或模型族
* 需要引用来源的研究回答

## 开始使用

```bash theme={null}
export AISA_API_KEY="YOUR_AISA_API_KEY"
npm install -g @aisa-one/cli
aisa skills install scholar-search
```

## 相关

<CardGroup cols={3}>
  <Card title="Multi-source Search" icon="magnifying-glass" href="/zh/agent-skills/search">
    组合网页、学术和 Perplexity 检索。
  </Card>

  <Card title="Scholar API" icon="code" href="/api-reference/scholar/post_scholar-search-scholar">
    学术搜索 API reference。
  </Card>

  <Card title="Perplexity Deep Research" icon="microscope" href="/zh/agent-skills/perplexity-research">
    生成带引用的综合研究答案。
  </Card>
</CardGroup>