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

> Blend web and scholarly search for broader evidence.

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

**Hybrid web and scholar search.** Combine current web results with academic sources when a task needs broader evidence.

## 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 smart-search
```

## What can agents do with it?

<CardGroup cols={2}>
  <Card title="Hybrid retrieval" icon="wand-magic-sparkles">
    Search web and scholarly sources together.
  </Card>

  <Card title="Broader coverage" icon="layer-group">
    Reduce blind spots from single-source search.
  </Card>

  <Card title="Research summaries" icon="file-lines">
    Summarize findings across source types.
  </Card>

  <Card title="Evidence comparison" icon="scale-balanced">
    Compare current sources with academic evidence.
  </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 `smart` subcommand:

```bash theme={null}
python3 ${CLAUDE_PLUGIN_ROOT}/skills/smart-search/scripts/search_client.py smart --query "<search query>" --count <max_results>
```

### Arguments

| Argument         | Required | Default | Description                       |
| ---------------- | -------- | ------- | --------------------------------- |
| `--query` / `-q` | Yes      | —       | Search query                      |
| `--count` / `-c` | No       | 10      | Maximum number of results (1–100) |

### Example

```bash theme={null}
python3 ${CLAUDE_PLUGIN_ROOT}/skills/smart-search/scripts/search_client.py smart --query "impact of large language models on software engineering" --count 10
```

## Output

The script prints a mixed set of results from both web and academic sources, including titles, URLs, and content snippets.

## When to Use

Use this skill when the user's query spans both general knowledge and academic research. For example, questions about emerging technologies, scientific topics with practical applications, or any query where both web articles and papers would be valuable.

## 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 smart-search
   ```
4. Start a new agent session so the runtime loads the updated skill instructions.

## Related

<CardGroup cols={3}>
  <Card title="AIsa Scholar Search" icon="graduation-cap" href="/agent-skills/scholar-search">
    Academic paper and scholarly source search.
  </Card>

  <Card title="AIsa Web Search" icon="globe" href="/agent-skills/web-search">
    Current web source search.
  </Card>

  <Card title="Multi-source Search" icon="magnifying-glass" href="/agent-skills/search">
    Broader search and answer workflow.
  </Card>
</CardGroup>