aisa-tavily
Search the web and extract public page content through AIsa's Tavily-backed API relay. Use when: the user needs open-web research, source discovery, current news lookup, or public URL content extracti
SKILL.mdclaude-release/aisa-tavily/SKILL.md
GitHubAIsa Tavily Search
Search the web and extract public page content through AIsa's Tavily-backed API relay. Use this skill when the user needs open-web research, source discovery, current-news lookup, or readable extraction from a specific public URL.
When to use
- When the user needs web search results for a topic, question, company, product, or event
- When the user wants source discovery before summarizing, comparing, or validating information
- When the user needs current-news lookup with recent-day filtering
- When the user provides a public URL and wants the page content extracted for downstream analysis
- When a task-first research workflow needs remote search results instead of local browser automation
When NOT to use
- Do not use this skill for sites that require login, browser interaction, cookies, or private account access
- Do not use this skill for posting, social engagement, media upload, or OAuth-based workflows; it performs search and public-URL extraction only
- Do not use this skill when there is no network access to
https://aisa.oneorhttps://api.aisa.one - Do not use this skill for local file extraction or private document parsing
Quick Reference
| Task | Command |
|---|---|
| Search the web | node scripts/search.mjs "query" |
| Search with more results | node scripts/search.mjs "query" -n 10 |
| Run deeper research | node scripts/search.mjs "query" --deep |
| Search news | node scripts/search.mjs "query" --topic news |
| Search recent news only | node scripts/search.mjs "query" --topic news --days 7 |
| Extract content from a URL | node scripts/extract.mjs "https://example.com/article" |
Capabilities
- Search the open web through AIsa's Tavily-backed relay
- Return concise, relevant result sets for research and agent workflows
- Run deeper research with
--deepfor broader coverage - Focus on news search with
--topic news - Limit news lookback windows with
--days <n> - Extract readable content from a public URL
High-Intent Workflows
Open-web research
Use search to gather public sources before summarizing, comparing claims, or building a research brief.
node scripts/search.mjs "query"
node scripts/search.mjs "query" -n 10
node scripts/search.mjs "query" --deep
Current-news lookup
Use news mode when the task is about recent coverage, current events, or time-bounded reporting.
node scripts/search.mjs "query" --topic news
node scripts/search.mjs "query" --topic news --days 7
Public URL extraction
Use extraction when the user already has a public page URL and needs readable page content for downstream analysis.
node scripts/extract.mjs "https://example.com/article"
Options
-n <count>: Number of results (default: 5, max: 20)--deep: Use advanced search for deeper research (slower, more comprehensive)--topic <topic>: Search topic -general(default) ornews--days <n>: For news topic, limit to last n days
Setup
Requirements:
nodeAISA_API_KEY- Internet access with outbound requests to
https://aisa.oneandhttps://api.aisa.one
Auth, relay, upload, and side-effect notes:
- This skill requires
AISA_API_KEYfrom https://marketplace.aisa.one - Requests are sent through AIsa's remote relay at
https://aisa.oneandhttps://api.aisa.one - Search queries and public target URLs are sent to the remote AIsa relay so it can return search results or extracted page content
- This skill does not use OAuth and does not require an approval flow
- This skill does not upload media or files
- This skill works against public web content and public URLs; it is not a local browser, cookie, account-access, or browser-automation workflow
Inputs and Outputs
Inputs
- Search query text
- Optional result count via
-n <count> - Optional deeper-research mode via
--deep - Optional topic selection via
--topic general|news - Optional recent-news window via
--days <n> - Public URL for extraction via
node scripts/extract.mjs "https://example.com/article"
Outputs
- Search results returned from AIsa's Tavily-backed relay
- News-focused result sets when
--topic newsis used - Extracted readable page content for a public URL
Example Requests
- "Search for recent coverage of OpenAI enterprise pricing"
- "Find sources comparing vector databases for production RAG"
- "Look up this week's news about NVIDIA export controls"
- "Extract the main content from this article URL"
- "Search the web for public sources on this company and summarize the findings"
Notes
- Needs
AISA_API_KEYfrom https://marketplace.aisa.one - Powered by AIsa's unified API gateway (
https://aisa.one/https://api.aisa.one) - Use
--deepfor more comprehensive research queries - Use
--topic newsfor current-events lookup - Search and extraction run through remote relay requests, not local browser automation
- No OAuth approval flow is involved
- No media or file upload flow is involved