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 →

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

npx skills

npx skills add AIsa-team/agent-skills --skill multi-source-search

Start a new agent session after installing so the skill loads.

What can agents do with it?

Fast web lookup

“Summarize the latest AI infrastructure launches this month.”

Scholar-backed research

“Find recent academic papers on self-correcting agent frameworks.”

Citation-rich answers

“Answer this question with inline citations using Perplexity Sonar Pro.”

Deep research reports

“Generate a 2,000-word report on autonomous browser agents.”

Content extraction

“Pull the main article text from these 5 URLs for analysis.”

Site intelligence

“Map the structure of this docs site and crawl it for RAG.”

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/search/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

export AISA_API_KEY="your-key"

Web + scholar

# 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

# 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

# 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

# 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 MCP and A2A for agent tooling"
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
/scholar/search/scholar	POST	Academic papers
/scholar/search/mixed	POST	Smart hybrid search
/scholar/search/explain	POST	Explain search
/perplexity/sonar	POST	Sonar — fast answers
/perplexity/sonar-pro	POST	Sonar Pro — synthesis
/perplexity/sonar-reasoning-pro	POST	Sonar Reasoning Pro
/perplexity/sonar-deep-research	POST	Sonar Deep Research
/tavily/search	POST	Tavily search
/tavily/extract	POST	Tavily extract
/tavily/crawl	POST	Tavily crawl
/tavily/map	POST	Tavily map

Get started

1. Sign up at aisa.one and create an API key in the console.
2. Set it in your shell: export AISA_API_KEY="your-key".
3. Install the skill with one of the commands under Install, then start a new agent session.

Related

Search API reference

Tavily search, extract, crawl, map — with live playgrounds.

Scholar API reference

Web, scholar, smart, and explain endpoints.

Perplexity API reference

Full Sonar family endpoint docs.