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.md

GitHub

AIsa 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.one or https://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 --deep for 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) or news
  • --days <n>: For news topic, limit to last n days

Setup

Requirements:

  • node
  • AISA_API_KEY
  • Internet access with outbound requests to https://aisa.one and https://api.aisa.one

Auth, relay, upload, and side-effect notes:

  • This skill requires AISA_API_KEY from https://marketplace.aisa.one
  • Requests are sent through AIsa's remote relay at https://aisa.one and https://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 news is 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_KEY from https://marketplace.aisa.one
  • Powered by AIsa's unified API gateway (https://aisa.one / https://api.aisa.one)
  • Use --deep for more comprehensive research queries
  • Use --topic news for 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