| name | smart-search |
| description | Intelligent hybrid search combining web and academic sources via AIsa Smart Search endpoint. Best when you need both web and scholarly results. Use when: the user needs web search, research, source discovery, or content extraction. |
| compatibility | Designed for Agent Skills compatible clients such as OpenClaw, Claude Code, Hermes, and GitHub-backed skill catalogs. Requires system binaries python3, environment variables AISA_API_KEY and internet access to api.aisa.one. |
| metadata | {"aisa":{"emoji":"🔎","requires":{"bins":["python3"],"env":["AISA_API_KEY"]},"primaryEnv":"AISA_API_KEY","compatibility":"Designed for Agent Skills compatible clients such as OpenClaw, Claude Code, Hermes, and GitHub-backed skill catalogs. Requires system binaries python3, environment variables AISA_API_KEY and internet access to api.aisa.one."}} |
AIsa Smart Search
Intelligent hybrid search that combines web and academic sources using the AIsa Smart Search endpoint. Automatically blends general web results with scholarly articles for comprehensive coverage.
Setup
This skill requires the AISA_API_KEY environment variable. When installed as a Claude plugin, the key is configured via the plugin's userConfig.
Usage
Run the search client with the smart subcommand:
python3 ${CLAUDE_PLUGIN_ROOT}/skills/smart-search/scripts/search_client.py smart --query "<search query>" --count <max_results>
Arguments
| Argument | Required | Default | Description |
|---|
--query / -q | Yes | — | Search query |
--count / -c | No | 10 | Maximum number of results (1–100) |
Example
python3 ${CLAUDE_PLUGIN_ROOT}/skills/smart-search/scripts/search_client.py smart --query "impact of large language models on software engineering" --count 10
Output
The script prints a mixed set of results from both web and academic sources, including titles, URLs, and content snippets.
When to Use
Use this skill when the user's query spans both general knowledge and academic research. For example, questions about emerging technologies, scientific topics with practical applications, or any query where both web articles and papers would be valuable.
