Skip to main content

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.

View on GitHub -> Academic search for agents. Find papers, scholarly articles, citations, and year-bounded research sources through AIsa.

​
Install

aisa skills install scholar-search

​
What can agents do with it?

Paper discovery

Find academic papers for a research question.

Literature scans

Gather papers around a topic or method.

Evidence review

Summarize claims with scholarly context.

Research workflows

Use scholarly evidence in agent reports.

​
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: 
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

ArgumentRequiredDefaultDescription
--query / -qYes—Academic search query
--count / -cNo10Maximum number of results (1–100)
--year-fromNo—Year lower bound (e.g., 2023)
--year-toNo—Year upper bound (e.g., 2026)

​
Examples

# 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 (new accounts start with $2 free credit).
  2. Generate an API key from the console.
  3. Set your key and install the skill: 
    export AISA_API_KEY="your-key"
aisa skills install scholar-search
  4. Start a new agent session so the runtime loads the updated skill instructions.

Scholar API reference

Academic search endpoint docs.

AIsa Smart Search

Combine web and scholar sources.

Multi-source Search

Broader research retrieval skill.