\r \r

OpenClaw Search\r

\r Intelligent search for autonomous agents, powered by AIsa.\r \r One API key gives you:\r

• Structured web search\r
• Scholar search\r
• Hybrid scholar search\r
• Tavily search and extraction tools\r
• Perplexity Sonar answer-generation endpoints with citations\r \r

What This Skill Is Best For\r

\r

Fast web lookup\r

Search the latest AI infrastructure launches and summarize the top sources.\r
```\r
\r
### Scholar-backed research\r
```text\r
Find recent papers on multimodal reasoning from 2024 onward.\r
```\r
\r
### Citation-rich answers\r
```text\r
Use Sonar Pro to answer which open-source agent frameworks are gaining traction and cite sources.\r
```\r
\r
### Deep research reports\r
```text\r
Use Sonar Deep Research to produce a thorough market map of AI browser agents.\r
```\r
\r
## Quick Start\r
\r
```bash\r
export AISA_API_KEY="your-key"\r
```\r
\r
## Search APIs\r
\r
### Web Search\r
\r
```bash\r
curl -X POST "https://api.aisa.one/apis/v1/scholar/search/web?query=AI+frameworks&max_num_results=10" \\r
  -H "Authorization: Bearer $AISA_API_KEY"\r
```\r
\r
### Scholar Search\r
\r
```bash\r
curl -X POST "https://api.aisa.one/apis/v1/scholar/search/scholar?query=transformer+models&max_num_results=10" \\r
  -H "Authorization: Bearer $AISA_API_KEY"\r
\r
curl -X POST "https://api.aisa.one/apis/v1/scholar/search/scholar?query=LLM&max_num_results=10&as_ylo=2024&as_yhi=2025" \\r
  -H "Authorization: Bearer $AISA_API_KEY"\r
```\r
\r
### Hybrid Scholar Search\r
\r
```bash\r
curl -X POST "https://api.aisa.one/apis/v1/scholar/search/smart?query=machine+learning+optimization&max_num_results=10" \\r
  -H "Authorization: Bearer $AISA_API_KEY"\r
```\r
\r
## Perplexity Sonar APIs\r
\r
The deprecated `/search/full` and `/search/smart` nodes have been removed from this skill.\r
\r
The replacement flow is the Perplexity API family:\r
\r
| Endpoint | Use case |\r
|----------|----------|\r
| `/perplexity/sonar` | Lightweight, cost-effective search answers with citations |\r
| `/perplexity/sonar-pro` | Better for complex queries and multi-step follow-ups |\r
| `/perplexity/sonar-reasoning-pro` | Stronger analytical reasoning with web search |\r
| `/perplexity/sonar-deep-research` | Exhaustive research and long-form reports |\r
\r
These descriptions are based on the AIsa docs:\r
- [Sonar](https://docs.aisa.one/reference/post_perplexity-sonar)\r
- [Sonar Pro](https://docs.aisa.one/reference/post_perplexity-sonar-pro)\r
- [Sonar Reasoning Pro](https://docs.aisa.one/reference/post_perplexity-sonar-reasoning-pro)\r
- [Sonar Deep Research](https://docs.aisa.one/reference/post_perplexity-sonar-deep-research)\r
\r
### Sonar\r
\r
```bash\r
curl -X POST "https://api.aisa.one/apis/v1/perplexity/sonar" \\r
  -H "Authorization: Bearer $AISA_API_KEY" \\r
  -H "Content-Type: application/json" \\r
  -d '{\r
    "model": "sonar",\r
    "messages": [\r
      {"role": "user", "content": "What changed in the AI agent ecosystem this week?"}\r
    ]\r
  }'\r
```\r
\r
### Sonar Pro\r
\r
```bash\r
curl -X POST "https://api.aisa.one/apis/v1/perplexity/sonar-pro" \\r
  -H "Authorization: Bearer $AISA_API_KEY" \\r
  -H "Content-Type: application/json" \\r
  -d '{\r
    "model": "sonar-pro",\r
    "messages": [\r
      {"role": "user", "content": "Compare the top browser-use agent frameworks and cite the key differences."}\r
    ]\r
  }'\r
```\r
\r
### Sonar Reasoning Pro\r
\r
```bash\r
curl -X POST "https://api.aisa.one/apis/v1/perplexity/sonar-reasoning-pro" \\r
  -H "Authorization: Bearer $AISA_API_KEY" \\r
  -H "Content-Type: application/json" \\r
  -d '{\r
    "model": "sonar-reasoning-pro",\r
    "messages": [\r
      {"role": "user", "content": "Analyze whether small vertical AI agents can defend against general-purpose copilots."}\r
    ]\r
  }'\r
```\r
\r
### Sonar Deep Research\r
\r
```bash\r
curl -X POST "https://api.aisa.one/apis/v1/perplexity/sonar-deep-research" \\r
  -H "Authorization: Bearer $AISA_API_KEY" \\r
  -H "Content-Type: application/json" \\r
  -d '{\r
    "model": "sonar-deep-research",\r
    "messages": [\r
      {"role": "user", "content": "Create a deep research report on AI coding agents in 2026, including product categories, pricing, and risks."}\r
    ]\r
  }'\r
```\r
\r
## Tavily APIs\r
\r
```bash\r
curl -X POST "https://api.aisa.one/apis/v1/tavily/search" \\r
  -H "Authorization: Bearer $AISA_API_KEY" \\r
  -H "Content-Type: application/json" \\r
  -d '{"query":"latest AI developments"}'\r
\r
curl -X POST "https://api.aisa.one/apis/v1/tavily/extract" \\r
  -H "Authorization: Bearer $AISA_API_KEY" \\r
  -H "Content-Type: application/json" \\r
  -d '{"urls":["https://example.com/article"]}'\r
\r
curl -X POST "https://api.aisa.one/apis/v1/tavily/crawl" \\r
  -H "Authorization: Bearer $AISA_API_KEY" \\r
  -H "Content-Type: application/json" \\r
  -d '{"url":"https://example.com","max_depth":2}'\r
\r
curl -X POST "https://api.aisa.one/apis/v1/tavily/map" \\r
  -H "Authorization: Bearer $AISA_API_KEY" \\r
  -H "Content-Type: application/json" \\r
  -d '{"url":"https://example.com"}'\r
```\r
\r
## Python Client\r
\r
```bash\r
# Structured search\r
python3 {baseDir}/scripts/search_client.py web --query "latest AI news" --count 10\r
python3 {baseDir}/scripts/search_client.py scholar --query "transformer architecture" --count 10\r
python3 {baseDir}/scripts/search_client.py smart --query "autonomous agents" --count 10\r
\r
# Perplexity Sonar family\r
python3 {baseDir}/scripts/search_client.py sonar --query "Summarize this week's AI launches"\r
python3 {baseDir}/scripts/search_client.py sonar-pro --query "Compare AI agent frameworks with citations"\r
python3 {baseDir}/scripts/search_client.py sonar-reasoning-pro --query "Analyze the defensibility of AI copilots"\r
python3 {baseDir}/scripts/search_client.py sonar-deep-research --query "Write a deep research report on AI browser agents"\r
\r
# Optional system instruction\r
python3 {baseDir}/scripts/search_client.py sonar-pro \\r
  --query "Map the top coding agent products" \\r
  --system "Respond in markdown with a short executive summary first."\r
\r
# Tavily utilities\r
python3 {baseDir}/scripts/search_client.py tavily-search --query "AI developments"\r
python3 {baseDir}/scripts/search_client.py tavily-extract --urls "https://example.com/article"\r
\r
# Multi-source retrieval\r
python3 {baseDir}/scripts/search_client.py verity --query "Is quantum computing ready for enterprise?"\r
```\r
\r
## API Reference\r
\r
| Endpoint | Method | Description |\r
|----------|--------|-------------|\r
| `/scholar/search/web` | POST | Web search with structured results |\r
| `/scholar/search/scholar` | POST | Academic paper search |\r
| `/scholar/search/smart` | POST | Hybrid scholar search |\r
| `/scholar/explain` | POST | Generate result explanations |\r
| `/perplexity/sonar` | POST | Lightweight search answers with citations |\r
| `/perplexity/sonar-pro` | POST | Advanced search answers for complex tasks |\r
| `/perplexity/sonar-reasoning-pro` | POST | Analytical reasoning with web search |\r
| `/perplexity/sonar-deep-research` | POST | Exhaustive research reports |\r
| `/tavily/search` | POST | Tavily search integration |\r
| `/tavily/extract` | POST | Extract content from URLs |\r
| `/tavily/crawl` | POST | Crawl web pages |\r
| `/tavily/map` | POST | Generate site maps |\r
\r
## Parameters\r
\r
### Scholar search query parameters\r
\r
| Parameter | Type | Description |\r
|-----------|------|-------------|\r
| `query` | string | Search query |\r
| `max_num_results` | integer | Max results (default 10) |\r
| `as_ylo` | integer | Year lower bound |\r
| `as_yhi` | integer | Year upper bound |\r
\r
### Perplexity request body\r
\r
This skill sends a minimal OpenAI-style payload:\r
\r
```json\r
{\r
  "model": "sonar-pro",\r
  "messages": [\r
    {"role": "system", "content": "Optional system instruction"},\r
    {"role": "user", "content": "Your question"}\r
  ]\r
}\r
```\r
\r
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.\r
\r
## Notes\r
\r
- `/search/full` and `/search/smart` are no longer documented here because you indicated those nodes have been retired.\r
- The existing scholar and Tavily endpoints remain available.\r
- `verity` still focuses on parallel retrieval from scholar, web, hybrid scholar, and Tavily sources.\r
\r
## Full API Reference\r
\r
See [API Reference](https://docs.aisa.one/reference/) for complete endpoint documentation.\r
\r
## Resources\r
\r
- [AIsa Verity](https://github.com/AIsa-team/verity) - Reference implementation of confidence-scored search agent\r
- [AIsa Documentation](https://docs.aisa.one) - Complete API documentation\r