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

> Return current web results with titles, URLs, and snippets.

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

**Simple current web search.** Return structured titles, URLs, and snippets through AIsa's web search endpoint.

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

## What can agents do with it?

<CardGroup cols={2}>
  <Card title="Current lookup" icon="globe">
    Search web sources for up-to-date information.
  </Card>

  <Card title="Structured results" icon="list">
    Return titles, URLs, and snippets for agent review.
  </Card>

  <Card title="Source discovery" icon="magnifying-glass">
    Find sources before writing or analysis.
  </Card>

  <Card title="Research handoff" icon="file-lines">
    Feed structured links into a larger workflow.
  </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 `web` subcommand:

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

### Arguments

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

### Example

```bash theme={null}
python3 ${CLAUDE_PLUGIN_ROOT}/skills/web-search/scripts/search_client.py web --query "latest AI agent frameworks 2026" --count 5
```

## Output

The script prints structured results including:

* **Title** — Page title
* **URL** — Direct link to the source
* **Snippet** — Content excerpt relevant to the query

## When to Use

Use this skill when the user asks to search the web, find information online, look up recent events, or needs general web results. This is the most versatile search tool for broad queries.

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

## Related

<CardGroup cols={3}>
  <Card title="AIsa Smart Search" icon="wand-magic-sparkles" href="/agent-skills/smart-search">
    Hybrid web and scholarly retrieval.
  </Card>

  <Card title="Tavily Search" icon="magnifying-glass" href="/agent-skills/tavily-search">
    Web search with depth and filter controls.
  </Card>

  <Card title="Multi-source Search" icon="magnifying-glass-plus" href="/agent-skills/search">
    Broader search coverage with multiple providers.
  </Card>
</CardGroup>