| name | multi-source-search |
| description | Multi-source intelligent search for agents. Retrieval across web, scholar, Tavily, and Perplexity Sonar models. |
| license | MIT |
| compatibility | Works with any agentskills.io-compatible harness — Claude Code, Claude, OpenCode, Cursor, Codex, Gemini CLI, OpenClaw, Hermes, Goose, and others. Requires Python 3, a POSIX shell, and AISA_API_KEY. |
| metadata | {"aisa":{"emoji":"🔎","homepage":"https://aisa.one","requires":{"bins":["curl","python3"],"env":["AISA_API_KEY"]},"primaryEnv":"AISA_API_KEY","harnesses":["claude-code","claude","opencode","cursor","codex","gemini-cli","openclaw","hermes","goose"]}} |
Multi-source Search
Intelligent search for autonomous agents, powered by AIsa.
One API key gives you:
- Structured web search
- Scholar search
- Hybrid scholar search
- Tavily search and extraction tools
- Perplexity Sonar answer-generation endpoints with citations
Compatibility
Works with any agentskills.io-compatible
harness, including:
- Claude Code and Claude (Anthropic)
- OpenAI Codex
- Cursor
- Gemini CLI (Google)
- OpenCode, Goose, OpenClaw, Hermes
- and any other harness that implements the Agent Skills
specification
Requires Python 3, a POSIX shell, and AISA_API_KEY (get one at
aisa.one).
What This Skill Is Best For
Fast web lookup
Search the latest AI infrastructure launches and summarize the top sources.
Scholar-backed research
Find recent papers on multimodal reasoning from 2024 onward.
Citation-rich answers
Use Sonar Pro to answer which open-source agent frameworks are gaining traction and cite sources.
Deep research reports
Use Sonar Deep Research to produce a thorough market map of AI browser agents.
Quick Start
export AISA_API_KEY="your-key"
Search APIs
Web Search
curl -X POST "https://api.aisa.one/apis/v1/scholar/search/web?query=AI+frameworks&max_num_results=10" \
-H "Authorization: Bearer $AISA_API_KEY"
Scholar Search
curl -X POST "https://api.aisa.one/apis/v1/scholar/search/scholar?query=transformer+models&max_num_results=10" \
-H "Authorization: Bearer $AISA_API_KEY"
curl -X POST "https://api.aisa.one/apis/v1/scholar/search/scholar?query=LLM&max_num_results=10&as_ylo=2024&as_yhi=2025" \
-H "Authorization: Bearer $AISA_API_KEY"
Hybrid Scholar Search
curl -X POST "https://api.aisa.one/apis/v1/scholar/search/smart?query=machine+learning+optimization&max_num_results=10" \
-H "Authorization: Bearer $AISA_API_KEY"
Perplexity Sonar APIs
The deprecated /search/full and /search/smart nodes have been removed from this skill.
The replacement flow is the Perplexity API family:
| Endpoint | Use case |
|---|
/perplexity/sonar | Lightweight, cost-effective search answers with citations |
/perplexity/sonar-pro | Better for complex queries and multi-step follow-ups |
/perplexity/sonar-reasoning-pro | Stronger analytical reasoning with web search |
/perplexity/sonar-deep-research | Exhaustive research and long-form reports |
These descriptions are based on the AIsa docs:
Sonar
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 changed in the AI agent ecosystem this week?"}
]
}'
Sonar Pro
curl -X POST "https://api.aisa.one/apis/v1/perplexity/sonar-pro" \
-H "Authorization: Bearer $AISA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "sonar-pro",
"messages": [
{"role": "user", "content": "Compare the top browser-use agent frameworks and cite the key differences."}
]
}'
Sonar Reasoning Pro
curl -X POST "https://api.aisa.one/apis/v1/perplexity/sonar-reasoning-pro" \
-H "Authorization: Bearer $AISA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "sonar-reasoning-pro",
"messages": [
{"role": "user", "content": "Analyze whether small vertical AI agents can defend against general-purpose copilots."}
]
}'
Sonar 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": "Create a deep research report on AI coding agents in 2026, including product categories, pricing, and risks."}
]
}'
Tavily APIs
curl -X POST "https://api.aisa.one/apis/v1/tavily/search" \
-H "Authorization: Bearer $AISA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"latest AI developments"}'
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"]}'
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","max_depth":2}'
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
python3 {baseDir}/scripts/search_client.py web --query "latest AI news" --count 10
python3 {baseDir}/scripts/search_client.py scholar --query "transformer architecture" --count 10
python3 {baseDir}/scripts/search_client.py smart --query "autonomous agents" --count 10
python3 {baseDir}/scripts/search_client.py sonar --query "Summarize this week's AI launches"
python3 {baseDir}/scripts/search_client.py sonar-pro --query "Compare AI agent frameworks with citations"
python3 {baseDir}/scripts/search_client.py sonar-reasoning-pro --query "Analyze the defensibility of AI copilots"
python3 {baseDir}/scripts/search_client.py sonar-deep-research --query "Write a deep research report on AI browser agents"
python3 {baseDir}/scripts/search_client.py sonar-pro \
--query "Map the top coding agent products" \
--system "Respond in markdown with a short executive summary first."
python3 {baseDir}/scripts/search_client.py tavily-search --query "AI developments"
python3 {baseDir}/scripts/search_client.py tavily-extract --urls "https://example.com/article"
python3 {baseDir}/scripts/search_client.py verity --query "Is quantum computing ready for enterprise?"
API Reference
| Endpoint | Method | Description |
|---|
/scholar/search/web | POST | Web search with structured results |
/scholar/search/scholar | POST | Academic paper search |
/scholar/search/smart | POST | Hybrid scholar search |
/scholar/explain | POST | Generate result explanations |
/perplexity/sonar | POST | Lightweight search answers with citations |
/perplexity/sonar-pro | POST | Advanced search answers for complex tasks |
/perplexity/sonar-reasoning-pro | POST | Analytical reasoning with web search |
/perplexity/sonar-deep-research | POST | Exhaustive research reports |
/tavily/search | POST | Tavily search integration |
/tavily/extract | POST | Extract content from URLs |
/tavily/crawl | POST | Crawl web pages |
/tavily/map | POST | Generate site maps |
Parameters
Scholar search query parameters
| Parameter | Type | Description |
|---|
query | string | Search query |
max_num_results | integer | Max results (default 10) |
as_ylo | integer | Year lower bound |
as_yhi | integer | Year upper bound |
Perplexity request body
This skill sends a minimal OpenAI-style payload:
{
"model": "sonar-pro",
"messages": [
{"role": "system", "content": "Optional system instruction"},
{"role": "user", "content": "Your question"}
]
}
Use messages because the AIsa Perplexity endpoints are presented as "Ask AI" endpoints in the official docs. This skill keeps the payload intentionally small for broad compatibility.
Notes
/search/full and /search/smart are no longer documented here because you indicated those nodes have been retired.- The existing scholar and Tavily endpoints remain available.
verity still focuses on parallel retrieval from scholar, web, hybrid scholar, and Tavily sources.
Full API Reference
See API Reference for complete endpoint documentation.
Resources
