--- name: aisa-multi-search-engine-b6e436206448 description: 'Multi-source search engine powered by AIsa API. Combines Tavily web search, Scholar academic search, Smart hybrid search, and Perplexity deep research — all through a single AIsa API key. Includes confidence scoring and AI synthesis. Use when: the user needs web search, research, source discovery, or content extraction.' license: MIT compatibility: Designed for Agent Skills compatible clients such as OpenClaw, Claude Code, Hermes, and GitHub-backed skill catalogs. Requires system binaries python3, node, environment variables AISA_API_KEY and internet access to api.aisa.one. metadata: author: AIsa version: 1.0.2 homepage: https://aisa.one repository: https://github.com/baofeng-tech/agent-skills tags: x,search,research,aisa platforms: agentskills.io,agentskill.sh,github primary_env: AISA_API_KEY allowed-tools: Read Bash Grep --- # AIsa Multi Search Engine v1.0.0 Multi-source search engine powered by [AIsa API](https://aisa.one). 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](https://aisa.one). ## Search Tools This plugin registers seven agent tools, each backed by a different AIsa API endpoint. | Tool | Description | AIsa Endpoint | |------|-------------|---------------| | `aisa_web_search` | Structured web search results | `/scholar/search/web` | | `aisa_scholar_search` | Academic paper search with year filtering | `/scholar/search/scholar` | | `aisa_smart_search` | Intelligent hybrid search (web + academic) | `/scholar/search/smart` | | `aisa_tavily_search` | Advanced web search with depth, topic, time, domain filters | `/tavily/search` | | `aisa_tavily_extract` | Extract clean content from URLs | `/tavily/extract` | | `aisa_perplexity_search` | Deep research via Perplexity Sonar models | `/sonar`, `/sonar-pro`, etc. | | `aisa_multi_search` | Parallel multi-source search with confidence scoring | Multiple endpoints | ## Usage Examples ### Web Search Search the web for structured results. ``` Use aisa_web_search to find "latest developments in AI agents 2025" ``` ### Academic Search Search scholarly papers with optional year filtering. ``` Use aisa_scholar_search to find papers on "transformer architecture" from 2024 to 2025 ``` ### Smart Search Intelligent hybrid search combining web and academic sources. ``` Use aisa_smart_search to research "autonomous AI agents" ``` ### Tavily Search (Advanced) Advanced web search with filtering options. ``` Use aisa_tavily_search for "AI startup funding" with topic "news" and time_range "month" ``` ### Tavily Extract Extract full content from specific URLs. ``` Use aisa_tavily_extract to get content from ["https://example.com/article"] ``` ### Perplexity Deep Research Use Perplexity Sonar models for synthesized answers with citations. ``` Use aisa_perplexity_search to answer "What is the current state of quantum computing?" with model "sonar-pro" ``` | Model | Best For | |-------|----------| | `sonar` | Quick answers, fast response | | `sonar-pro` | Detailed answers with more citations | | `sonar-reasoning-pro` | Complex reasoning and analysis | | `sonar-deep-research` | Exhaustive multi-step research | ### Multi-Source Search (Verity-Style) Parallel search across all sources with confidence scoring and AI synthesis. ``` 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. | Factor | Weight | Description | |--------|--------|-------------| | Source Availability | 40% | How many search sources returned results | | Result Quality | 35% | Volume of results relative to expectations | | Source Diversity | 15% | Mix of academic and web sources | | Recency | 10% | Bonus for having any successful sources | | Score | Level | Interpretation | |-------|-------|----------------| | 90-100 | Very High | Strong consensus across sources | | 70-89 | High | Good agreement, reliable sources | | 50-69 | Medium | Mixed signals, verify independently | | 30-49 | Low | Conflicting or sparse sources | | 0-29 | Very Low | Insufficient 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`. | Endpoint | Method | Description | |----------|--------|-------------| | `/scholar/search/web` | POST | Web search with structured results | | `/scholar/search/scholar` | POST | Academic paper search | | `/scholar/search/smart` | POST | Intelligent hybrid search | | `/scholar/explain` | POST | Generate result explanations with confidence | | `/tavily/search` | POST | Tavily web search | | `/tavily/extract` | POST | Extract content from URLs | | `/tavily/crawl` | POST | Crawl web pages | | `/tavily/map` | POST | Generate site maps | | `/sonar` | POST | Perplexity Sonar (fast) | | `/sonar-pro` | POST | Perplexity Sonar Pro (detailed) | | `/sonar-reasoning-pro` | POST | Perplexity Sonar Reasoning Pro | | `/sonar-deep-research` | POST | Perplexity Sonar Deep Research | ## Configuration The plugin accepts the following configuration options. | Option | Type | Default | Description | |--------|------|---------|-------------| | `aisaApiKey` | string | — | AIsa API key (or set `AISA_API_KEY` env var) | | `defaultMaxResults` | integer | 10 | Default max results per search (1-100) | | `defaultSearchDepth` | string | `basic` | Default Tavily search depth | ## Architecture ``` ┌─────────────────────────────────────────────────────────────┐ │ User Query │ └─────────────────────────────────────────────────────────────┘ │ ┌───────────────┼───────────────┐ ▼ ▼ ▼ ┌─────────┐ ┌─────────┐ ┌─────────┐ │ Scholar │ │ Web │ │ Smart │ └─────────┘ └─────────┘ └─────────┘ │ │ │ └───────────────┼───────────────┘ ▼ ┌─────────────────┐ │ Tavily Search │ └─────────────────┘ │ ▼ ┌─────────────────┐ │ AIsa Explain │ │ (Meta-Analysis) │ └─────────────────┘ │ ▼ ┌─────────────────┐ │ Confidence Score│ │ + Synthesis │ └─────────────────┘ ``` ## Pricing | API | Approximate Cost | |-----|-----------------| | Web search | ~$0.001 | | Scholar search | ~$0.002 | | Smart search | ~$0.002 | | Tavily search | ~$0.002 | | Explain | ~$0.003 | | Perplexity Sonar | ~$0.005 | ## Resources - [AIsa](https://aisa.one) — Get your API key - [AIsa API Reference](https://aisa.one/docs/api-reference) — Complete endpoint documentation - [ClawHub](https://clawhub.ai) — Plugin marketplace ## License MIT --- Source attribution: baofeng-tech Original project: https://github.com/baofeng-tech/agent-skills/blob/6da0a55a3aa88f283251abe4392be1217ccb7b52/aisa-multi-search-engine/SKILL.md License: MIT License information: https://opensource.org/license/mit Original upstream instructions; downloaded from Mega AI Hub. ## Upstream license notice MIT License Copyright (c) 2026 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. # Mega AI Hub resource metadata Creator / publisher: baofeng-tech Original project: https://github.com/baofeng-tech/agent-skills/blob/6da0a55a3aa88f283251abe4392be1217ccb7b52/aisa-multi-search-engine/SKILL.md Attribution basis: Source repository record Fields of work: Data & Analytics, Education & Research, Marketing Roles: Data Analyst, Marketing Analyst, Researcher Specialties: API, Backend, Design, Word Documents, Frontend, Git, Testing Tools: Aisa Api Country applicability: Country not specified Classification basis: Source catalog labels Instruction SHA-256: 4ebfcec5b31da7130bc003dd001cc8b0a06a79e2aaa4f1ea3f9f2ca6349644f6