← Back to Skills Marketplace
terryren2024

Liang Tavily Search 1.0.1

by TerryRen2024 · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
741
Downloads
0
Stars
18
Active Installs
1
Versions
Install in OpenClaw
/install liang-tavily-search-1-0-1
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 appears coherent and limited to calling Tavily's search API. Before installing: 1) Be comfortable trusting Tavily with any full-page content you request (avoid --raw-content if you don't want large page contents sent to the service). 2) Store TAVILY_API_KEY securely (env var or the platform's secret store); the script uses a bearer token to call the API. 3) Ensure your runtime has a recent Node version that supports fetch (the script uses top-level await and fetch). 4) Note a minor metadata mismatch in owner IDs between registry metadata and _meta.json (likely benign but FYI). If you need stricter guarantees about data handling, review Tavily's privacy policy or avoid enabling --raw-content.
Capability Analysis
Type: OpenClaw Skill Name: liang-tavily-search-1-0-1 Version: 1.0.0 The skill is a legitimate implementation of a web search tool using the Tavily API. The script `scripts/search.mjs` parses command-line arguments and performs a standard POST request to the official Tavily endpoint (api.tavily.com) using the provided API key. No evidence of data exfiltration, obfuscation, or malicious instructions was found.
Capability Assessment
Purpose & Capability
Name/description, required binary (node), and required env var (TAVILY_API_KEY) align with a simple Node script that calls https://api.tavily.com/search. The script only talks to the Tavily API and formats results for display.
Instruction Scope
SKILL.md and the script are narrowly scoped to running the search script and using the Tavily API. Note: the script supports a --raw-content option which requests full page content from Tavily; that increases the amount of user data sent to the external API when used. Otherwise the instructions do not read unrelated files or other env vars.
Install Mechanism
No install spec — instruction-only plus a small included script. No downloads or archives; nothing is written to disk by an installer. The requirement that 'node' be present is appropriate for the .mjs script.
Credentials
Only TAVILY_API_KEY is required and declared as the primary credential. That is proportional for a service-backed search skill. No other secrets, config paths, or unrelated credentials are requested.
Persistence & Privilege
The skill does not request always:true and does not modify agent/system configs. It can be invoked by the agent (normal default), but there are no other privileged behaviors or persistent privileges requested.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install liang-tavily-search-1-0-1
  3. After installation, invoke the skill by name or use /liang-tavily-search-1-0-1
  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 for web search using Tavily's LLM-optimized API. - Provides relevant search results with content snippets, scores, and metadata. - Supports various options: number of results, search depth, topic, time range, domain filters, and output format. - Includes detailed documentation for authentication and usage with practical search examples. - Designed for easy integration with OpenClaw; requires TAVILY_API_KEY environment variable.
Metadata
Slug liang-tavily-search-1-0-1
Version 1.0.0
License MIT-0
All-time Installs 20
Active Installs 18
Total Versions 1
Frequently Asked Questions

What is Liang Tavily Search 1.0.1?

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 741 downloads so far.

How do I install Liang Tavily Search 1.0.1?

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

Is Liang Tavily Search 1.0.1 free?

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

Which platforms does Liang Tavily Search 1.0.1 support?

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

Who created Liang Tavily Search 1.0.1?

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

💬 Comments