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

# Multi-source Search

> Unified web, academic, Tavily, and Perplexity Sonar search for autonomous agents. One skill covers ranked web results, scholar papers, citation-backed answers, content extraction, recursive crawling, and site mapping.

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

**Multi-source intelligent retrieval for autonomous agents.** One `AISA_API_KEY` unlocks structured web search, academic paper lookup, Tavily extraction/crawling, and the full Perplexity Sonar family for citation-rich answers.

## 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 multi-source-search
```

## What can agents do with it?

<CardGroup cols={2}>
  <Card title="Fast web lookup" icon="magnifying-glass">
    "Summarize the latest AI infrastructure launches this month."
  </Card>

  <Card title="Scholar-backed research" icon="book-open">
    "Find recent academic papers on self-correcting agent frameworks."
  </Card>

  <Card title="Citation-rich answers" icon="quote-left">
    "Answer this question with inline citations using Perplexity Sonar Pro."
  </Card>

  <Card title="Deep research reports" icon="file-lines">
    "Generate a 2,000-word report on autonomous browser agents."
  </Card>

  <Card title="Content extraction" icon="scissors">
    "Pull the main article text from these 5 URLs for analysis."
  </Card>

  <Card title="Site intelligence" icon="sitemap">
    "Map the structure of this docs site and crawl it for RAG."
  </Card>
</CardGroup>

## Core capabilities

* **Web search** (`/scholar/search/web`) — structured web results for current information
* **Scholar search** (`/scholar/search/scholar`) — academic papers with optional date filtering
* **Smart/hybrid search** (`/scholar/search/mixed`) — combines web + scholar in one call
* **Explain search** (`/scholar/explain`) — explanatory synthesis over results
* **Perplexity Sonar family** — `sonar`, `sonar-pro`, `sonar-reasoning-pro`, `sonar-deep-research`
* **Tavily** — `search`, `extract`, `crawl`, `map`
* **Verity multi-source** — parallel retrieval across source types

## Quick start

```bash theme={null}
export AISA_API_KEY="your-key"
```

### Web + scholar

```bash theme={null}
# Structured web search
curl -X POST "https://api.aisa.one/apis/v1/scholar/search/web" \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "latest AI infrastructure launches 2026"}'

# Academic papers
curl -X POST "https://api.aisa.one/apis/v1/scholar/search/scholar" \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "self-correcting agent frameworks"}'

# Smart hybrid (web + scholar)
curl -X POST "https://api.aisa.one/apis/v1/scholar/search/mixed" \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "retrieval-augmented generation"}'
```

### Perplexity Sonar

```bash theme={null}
# Fast answers
curl -X POST "https://api.aisa.one/apis/v1/perplexity/sonar" \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "sonar", "messages": [{"role": "user", "content": "What is MCP?"}]}'

# Deep research
curl -X POST "https://api.aisa.one/apis/v1/perplexity/sonar-deep-research" \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "sonar-deep-research", "messages": [{"role": "user", "content": "State of agentic payments in 2026"}]}'
```

### Tavily utilities

```bash theme={null}
# Search
curl -X POST "https://api.aisa.one/apis/v1/tavily/search" \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "LLM agent frameworks"}'

# Extract clean article text
curl -X POST "https://api.aisa.one/apis/v1/tavily/extract" \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls": ["https://example.com/article"]}'

# Recursive crawl
curl -X POST "https://api.aisa.one/apis/v1/tavily/crawl" \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com", "depth": 2}'

# Site map
curl -X POST "https://api.aisa.one/apis/v1/tavily/map" \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'
```

## Python client

```bash theme={null}
# Web + scholar + smart
python3 scripts/search_client.py web --query "AI agent news"
python3 scripts/search_client.py scholar --query "self-correcting agents"
python3 scripts/search_client.py smart --query "RAG patterns"

# Perplexity
python3 scripts/search_client.py sonar --query "What is MCP?"
python3 scripts/search_client.py sonar-pro --query "Compare OpenRouter vs AIsa"
python3 scripts/search_client.py sonar-reasoning-pro --query "Analyze x402 adoption"
python3 scripts/search_client.py sonar-deep-research --query "State of agentic payments"

# Tavily
python3 scripts/search_client.py tavily-search --query "LLM agents"
python3 scripts/search_client.py tavily-extract --urls "https://example.com/article"
python3 scripts/search_client.py tavily-crawl --url "https://example.com" --depth 2
python3 scripts/search_client.py tavily-map --url "https://example.com"

# Multi-source parallel retrieval
python3 scripts/search_client.py verity --query "AI agent benchmarks 2026"
```

## Endpoint reference

| Endpoint                          | Method | Purpose                                                                              |
| --------------------------------- | ------ | ------------------------------------------------------------------------------------ |
| `/scholar/search/web`             | POST   | [Web search](/api-reference/scholar/searchweb)                                       |
| `/scholar/search/scholar`         | POST   | [Academic papers](/api-reference/scholar/searchscholar)                              |
| `/scholar/search/mixed`           | POST   | [Smart hybrid search](/api-reference/scholar/searchsmart-1)                          |
| `/scholar/explain`                | POST   | [Explain search](/api-reference/scholar/explainsearch)                               |
| `/perplexity/sonar`               | POST   | [Sonar — fast answers](/api-reference/perplexity/post_perplexity-sonar)              |
| `/perplexity/sonar-pro`           | POST   | [Sonar Pro — synthesis](/api-reference/perplexity/post_perplexity-sonar-pro)         |
| `/perplexity/sonar-reasoning-pro` | POST   | [Sonar Reasoning Pro](/api-reference/perplexity/post_perplexity-sonar-reasoning-pro) |
| `/perplexity/sonar-deep-research` | POST   | [Sonar Deep Research](/api-reference/perplexity/post_perplexity-sonar-deep-research) |
| `/tavily/search`                  | POST   | [Tavily search](/api-reference/search/post_tavily-search)                            |
| `/tavily/extract`                 | POST   | [Tavily extract](/api-reference/search/post_tavily-extract)                          |
| `/tavily/crawl`                   | POST   | [Tavily crawl](/api-reference/search/post_tavily-crawl)                              |
| `/tavily/map`                     | POST   | [Tavily map](/api-reference/search/post_tavily-map)                                  |

## 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. `export AISA_API_KEY="your-key"` and install the skill:
   ```bash theme={null}
   npm install -g @aisa-one/cli
   aisa skills install multi-source-search
   ```

## Related

<CardGroup cols={3}>
  <Card title="Search API reference" icon="magnifying-glass" href="/api-reference/search/post_tavily-search">
    Tavily search, extract, crawl, map — with live playgrounds.
  </Card>

  <Card title="Scholar API reference" icon="book-open" href="/api-reference/scholar/searchweb">
    Web, scholar, smart, and explain endpoints.
  </Card>

  <Card title="Perplexity API reference" icon="sparkles" href="/api-reference/perplexity/post_perplexity-sonar">
    Full Sonar family endpoint docs.
  </Card>
</CardGroup>