AIsa Multi Search Engine v1.0.0#

Multi-source search engine powered by AIsa API. One API key unlocks web search, academic search, Tavily integration, and Perplexity deep research with confidence-scored results.

Quick Start#

bash

export AISA_API_KEY="your-key-here"

Get your API key at aisa.one.

Search Tools#

This plugin registers seven agent tools, each backed by a different AIsa API endpoint.

ToolDescriptionAIsa Endpointaisa_web_searchStructured web search results/scholar/search/web``aisa_scholar_searchAcademic paper search with year filtering/scholar/search/scholar``aisa_smart_searchIntelligent hybrid search (web + academic)/scholar/search/smart``aisa_tavily_searchAdvanced web search with depth, topic, time, domain filters/tavily/search``aisa_tavily_extractExtract clean content from URLs/tavily/extract``aisa_perplexity_searchDeep research via Perplexity Sonar models/sonar, /sonar-pro, etc.aisa_multi_searchParallel multi-source search with confidence scoringMultiple endpoints

Usage Examples#

Web Search#

Search the web for structured results.

text

Use aisa_web_search to find "latest developments in AI agents 2025"

Academic Search#

Search scholarly papers with optional year filtering.

text

Use aisa_scholar_search to find papers on "transformer architecture" from 2024 to 2025

Smart Search#

Intelligent hybrid search combining web and academic sources.

text

Use aisa_smart_search to research "autonomous AI agents"

Tavily Search (Advanced)#

Advanced web search with filtering options.

text

Use aisa_tavily_search for "AI startup funding" with topic "news" and time_range "month"

Tavily Extract#

Extract full content from specific URLs.

text

Use aisa_tavily_extract to get content from ["https://example.com/article"]

Perplexity Deep Research#

Use Perplexity Sonar models for synthesized answers with citations.

text

Use aisa_perplexity_search to answer "What is the current state of quantum computing?" with model "sonar-pro"

ModelBest ForsonarQuick answers, fast responsesonar-proDetailed answers with more citationssonar-reasoning-proComplex reasoning and analysissonar-deep-researchExhaustive multi-step research

Multi-Source Search (Verity-Style)#

Parallel search across all sources with confidence scoring and AI synthesis.

text

Use aisa_multi_search to comprehensively research "Is quantum computing ready for enterprise use?"

Confidence Scoring#

The aisa_multi_search tool provides a deterministic confidence score based on four factors.

FactorWeightDescriptionSource Availability40%How many search sources returned resultsResult Quality35%Volume of results relative to expectationsSource Diversity15%Mix of academic and web sourcesRecency10%Bonus for having any successful sourcesScoreLevelInterpretation90-100Very HighStrong consensus across sources70-89HighGood agreement, reliable sources50-69MediumMixed signals, verify independently30-49LowConflicting or sparse sources0-29Very LowInsufficient data

Python CLI Client#

A standalone Python client is included for command-line use.

bash

# Web search
python3 scripts/search_client.py web --query "latest AI news" --count 10

# Academic search
python3 scripts/search_client.py scholar --query "transformer architecture" --year-from 2024

# Smart search
python3 scripts/search_client.py smart --query "autonomous agents" --count 10

# Tavily search
python3 scripts/search_client.py tavily --query "AI developments" --depth advanced

# Extract content from URLs
python3 scripts/search_client.py extract --urls "https://example.com/article"

# Perplexity deep research
python3 scripts/search_client.py sonar --query "quantum computing" --model sonar-pro

# Multi-source search with confidence scoring
python3 scripts/search_client.py verity --query "Is quantum computing ready?"

API Endpoints Reference#

All endpoints use the AIsa API base URL https://api.aisa.one/apis/v1.

EndpointMethodDescription/scholar/search/webPOSTWeb search with structured results/scholar/search/scholarPOSTAcademic paper search/scholar/search/smartPOSTIntelligent hybrid search/scholar/explainPOSTGenerate result explanations with confidence/tavily/searchPOSTTavily web search/tavily/extractPOSTExtract content from URLs/tavily/crawlPOSTCrawl web pages/tavily/mapPOSTGenerate site maps/sonarPOSTPerplexity Sonar (fast)/sonar-proPOSTPerplexity Sonar Pro (detailed)/sonar-reasoning-proPOSTPerplexity Sonar Reasoning Pro/sonar-deep-researchPOSTPerplexity Sonar Deep Research

Configuration#

The plugin accepts the following configuration options.

OptionTypeDefaultDescriptionaisaApiKeystring—AIsa API key (or set AISA_API_KEY env var)defaultMaxResultsinteger10Default max results per search (1-100)defaultSearchDepthstringbasicDefault Tavily search depth

Architecture#

text

┌─────────────────────────────────────────────────────────────┐
│                      User Query                             │
└─────────────────────────────────────────────────────────────┘
                              │
              ┌───────────────┼───────────────┐
              ▼               ▼               ▼
        ┌─────────┐     ┌─────────┐     ┌─────────┐
        │ Scholar  │     │   Web   │     │  Smart  │
        └─────────┘     └─────────┘     └─────────┘
              │               │               │
              └───────────────┼───────────────┘
                              ▼
                    ┌─────────────────┐
                    │  Tavily Search  │
                    └─────────────────┘
                              │
                              ▼
                    ┌─────────────────┐
                    │  AIsa Explain   │
                    │ (Meta-Analysis) │
                    └─────────────────┘
                              │
                              ▼
                    ┌─────────────────┐
                    │ Confidence Score│
                    │  + Synthesis    │
                    └─────────────────┘

Pricing#

APIApproximate CostWeb search~$0.001Scholar search~$0.002Smart search~$0.002Tavily search~$0.002Explain~$0.003Perplexity Sonar~$0.005

Resources#

• AIsa — Get your API key
• AIsa API Reference — Complete endpoint documentation
• ClawHub — Plugin marketplace

License#

MIT