← Back to Skills Marketplace
15914355527

Tavily Search V2

by 15914355527 · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
177
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install liang-tavily-search-v2
Description
Web search using Tavily's LLM-optimized API. Returns relevant results with content snippets, scores, and metadata.
README (SKILL.md)

Tavily Search

Search the web and get relevant results optimized for LLM consumption.

Authentication

Get your API key at https://tavily.com and add to your OpenClaw config:

{
  "skills": {
    "entries": {
      "tavily-search": {
        "enabled": true,
        "apiKey": "tvly-YOUR_API_KEY_HERE"
      }
    }
  }
}

Or set the environment variable:

export TAVILY_API_KEY="tvly-YOUR_API_KEY_HERE"

Quick Start

Using the Script

node {baseDir}/scripts/search.mjs "query"
node {baseDir}/scripts/search.mjs "query" -n 10
node {baseDir}/scripts/search.mjs "query" --deep
node {baseDir}/scripts/search.mjs "query" --topic news

Examples

# Basic search
node {baseDir}/scripts/search.mjs "python async patterns"

# With more results
node {baseDir}/scripts/search.mjs "React hooks tutorial" -n 10

# Advanced search
node {baseDir}/scripts/search.mjs "machine learning" --deep

# News search
node {baseDir}/scripts/search.mjs "AI news" --topic news

# Domain-filtered search
node {baseDir}/scripts/search.mjs "Python docs" --include-domains docs.python.org

Options

Option Description Default
-n \x3Ccount> Number of results (1-20) 10
--depth \x3Cmode> Search depth: ultra-fast, fast, basic, advanced basic
--topic \x3Ctopic> Topic: general or news general
--time-range \x3Crange> Time range: day, week, month, year -
--include-domains \x3Cdomains> Comma-separated domains to include -
--exclude-domains \x3Cdomains> Comma-separated domains to exclude -
--raw-content Include full page content false
--json Output raw JSON false

Search Depth

Depth Latency Relevance Use Case
ultra-fast Lowest Lower Real-time chat, autocomplete
fast Low Good Need chunks but latency matters
basic Medium High General-purpose, balanced
advanced Higher Highest Precision matters, research

Tips

  • Keep queries under 400 characters - Think search query, not prompt
  • Break complex queries into sub-queries - Better results than one massive query
  • Use --include-domains to focus on trusted sources
  • Use --time-range for recent information
  • Filter by score (0-1) to get highest relevance results
Usage Guidance
This skill looks coherent and only needs your Tavily API key and Node. Before installing: verify you trust the tavily.com service and the skill publisher; prefer setting TAVILY_API_KEY as an environment variable rather than pasting it into shared config files; review and rotate the key if you later delete the skill; note minor metadata mismatches in the bundled _meta.json (slug/version/owner differ from registry) — these are likely benign but you may want to confirm the publisher identity if provenance matters. Also ensure your Node version supports global fetch or run in an environment where fetch is available.
Capability Analysis
Type: OpenClaw Skill Name: liang-tavily-search-v2 Version: 1.0.0 The skill provides a legitimate interface for the Tavily Search API. The script 'scripts/search.mjs' correctly handles API authentication via environment variables and communicates only with the official Tavily endpoint (api.tavily.com). No malicious patterns, obfuscation, or unauthorized data access were found in the code or the 'SKILL.md' instructions.
Capability Assessment
Purpose & Capability
Name and description (web search via Tavily) match the requirements and code: only Node and TAVILY_API_KEY are required, and the script POSTs to https://api.tavily.com/search. Nothing in the files demands unrelated services or permissions.
Instruction Scope
SKILL.md instructions stay on-topic: they show how to provide an API key (env or config) and how to run the provided Node script with search options. The runtime instructions do not ask the agent to read unrelated files, system secrets, or exfiltrate data to unexpected endpoints.
Install Mechanism
There is no install spec (instruction-only plus an included script), so nothing is downloaded or installed automatically. The included script is small and plain JS; it makes a network call to the declared Tavily API host only.
Credentials
Only a single environment variable (TAVILY_API_KEY) is required and is justified by the API call. The SKILL.md suggests storing the key in OpenClaw config or as an env var — standard for API clients.
Persistence & Privilege
The skill is not always-enabled and is user-invocable; it does not request elevated system persistence or modify other skills' configurations. Autonomous invocation is allowed (platform default) but not combined with other concerning permissions.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install liang-tavily-search-v2
  3. After installation, invoke the skill by name or use /liang-tavily-search-v2
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of Tavily Search skill. - Enables web search using Tavily’s LLM-optimized API with relevant results, content snippets, scores, and metadata. - Supports multiple result options such as search depth, topic, result count, domain filters, time range, and output format. - Requires API key configuration via environment variable or OpenClaw config. - Includes command-line script for quick searches with flexible parameters.
Metadata
Slug liang-tavily-search-v2
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Tavily Search V2?

Web search using Tavily's LLM-optimized API. Returns relevant results with content snippets, scores, and metadata. It is an AI Agent Skill for Claude Code / OpenClaw, with 177 downloads so far.

How do I install Tavily Search V2?

Run "/install liang-tavily-search-v2" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Tavily Search V2 free?

Yes, Tavily Search V2 is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Tavily Search V2 support?

Tavily Search V2 is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Tavily Search V2?

It is built and maintained by 15914355527 (@15914355527); the current version is v1.0.0.

💬 Comments