# Search

> Search command center for web, academic, Tavily, and Perplexity-backed research through one AIsa API key. Use when: the user needs one flagship skill for live search, source discovery, or citation-ready research. Supports fast lookup, answer generation, and deep research reports.

- Skill: `baofeng-tech/search-3` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add baofeng-tech/search-3`
- Raw SKILL.md: https://api.skillmd.com/api/skills/baofeng-tech/search-3/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: baofeng-tech (https://skillmd.com/u/baofeng-tech)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/baofeng-tech/search-3

---


# AIsa Search Command Center

Run live search, source discovery, and citation-ready research from one flagship AIsa search surface.

## When to use

- The user needs one general-purpose search skill for live web lookup, source discovery, or research synthesis.
- The user wants to move between quick search, scholar search, Tavily extraction, and Perplexity-backed answer generation without changing skills.
- The user needs a flagship search lane that can expand into citations, summaries, and deep research.

## When NOT to use

- The task is specifically about cross-source verification, confidence scoring, or consensus checks better handled by `multi-source-search`.
- The task is narrow enough for a single-provider sibling such as `scholar-search`, `tavily-search`, or `perplexity-search`.
- The workflow must avoid relay-based calls to `api.aisa.one`.

## High-Intent Workflows

- Search the web quickly, then expand into cited answers without switching packages.
- Pull academic sources or extracted pages when the first-pass lookup needs stronger evidence.
- Produce a deep research report when the user wants a broader map instead of a short answer.

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

## What This Skill Is Best For

### Fast web lookup
```text
Search the latest AI infrastructure launches and summarize the top sources.
```

### Scholar-backed research
```text
Find recent papers on multimodal reasoning from 2024 onward.
```

### Citation-rich answers
```text
Use Sonar Pro to answer which open-source agent frameworks are gaining traction and cite sources.
```

### Deep research reports
```text
Use Sonar Deep Research to produce a thorough market map of AI browser agents.
```

## Quick Start

```bash
export AISA_API_KEY="your-key"
```

## Example Requests

- Search the latest AI agent launches and show the most relevant sources first.
- Find papers and cited analysis on multimodal reasoning from the last 18 months.
- Build a deep research report on browser-use agents with sources and tradeoffs.

## Search APIs

### Web Search

```bash
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

```bash
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

```bash
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](https://docs.aisa.one/reference/post_perplexity-sonar)
- [Sonar Pro](https://docs.aisa.one/reference/post_perplexity-sonar-pro)
- [Sonar Reasoning Pro](https://docs.aisa.one/reference/post_perplexity-sonar-reasoning-pro)
- [Sonar Deep Research](https://docs.aisa.one/reference/post_perplexity-sonar-deep-research)

### Sonar

```bash
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

```bash
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

```bash
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

```bash
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

```bash
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

```bash
# Structured search
python3 scripts/search_client.py web --query "latest AI news" --count 10
python3 scripts/search_client.py scholar --query "transformer architecture" --count 10
python3 scripts/search_client.py smart --query "autonomous agents" --count 10

# Perplexity Sonar family
python3 scripts/search_client.py sonar --query "Summarize this week's AI launches"
python3 scripts/search_client.py sonar-pro --query "Compare AI agent frameworks with citations"
python3 scripts/search_client.py sonar-reasoning-pro --query "Analyze the defensibility of AI copilots"
python3 scripts/search_client.py sonar-deep-research --query "Write a deep research report on AI browser agents"

# Optional system instruction
python3 scripts/search_client.py sonar-pro \
  --query "Map the top coding agent products" \
  --system "Respond in markdown with a short executive summary first."

# Tavily utilities
python3 scripts/search_client.py tavily-search --query "AI developments"
python3 scripts/search_client.py tavily-extract --urls "https://example.com/article"

# Multi-source retrieval
python3 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:

```json
{
  "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](https://docs.aisa.one/reference/) for complete endpoint documentation.

## Resources

- [AIsa Verity](https://github.com/AIsa-team/verity) - Reference implementation of confidence-scored search agent
- [AIsa Documentation](https://docs.aisa.one) - Complete API documentation