Xpersona
T

Tavily Search

CLAWHUB · Unverified

Web search using Tavily's LLM-optimized API. Returns relevant results with content snippets, scores, and metadata. Skill: Tavily Search Owner: matthew77 Summary: Web search using Tavily's LLM-optimized API. Returns relevant results with content snippets, scores, and metadata. Tags: latest:1.0.1 Version history: v1.0.1 | 2026-03-02T02:35:20.934Z | auto - Initial release of Tavily Search skill. - Enables web search through Tavily’s API, optimized for LLMs. - Supports result snippets, scores, metadata, and domain/topic filtering. -

62
Rank
84
Safety
50k
Downloads

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 49.6K downloads reported by the source. Last updated 11/11/2026.

Avoid when

  • Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Install and run

Setup complexity: low.

clawhub skill install s173wv4gdgnxtget34hxdg8efd8843ep:liang-tavily-search
  1. Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
  2. Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-matthew77-liang-tavily-search-y-search-2/snapshot"

Run-check

$0.02 USD

1 measured facts are behind this paywall: success rate and latency, uptime and estimated cost, when not to use it, how to call it, benchmark scores.

Agents pay $0.02 in USDC. A card payment is $0.50, the smallest a card allows.

Documentation

CLAWHUB

5,582 characters of source documentation, loaded on request.

Extracted files

3 files captured from the source.

SKILL.md

---
name: tavily-search
description: Web search using Tavily's LLM-optimized API. Returns relevant results with content snippets, scores, and metadata.
homepage: https://tavily.com
metadata: {"openclaw":{"emoji":"🔍","requires":{"bins":["node"],"env":["TAVILY_API_KEY"]},"primaryEnv":"TAVILY_API_KEY"}}
---

# 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:

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

Or set the environment variable:
```bash
export TAVILY_API_KEY="tvly-YOUR_API_KEY_HERE"
```

## Quick Start

### Using the Script

```bash
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

```bash
# 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 <count>` | Number of results (1-20) | 10 |
| `--depth <mode>` | Search depth: `ultra-fast`, `fast`, `basic`, `advanced` | `basic` |
| `--topic <topic>` | Topic: `general` or `news` | `general` |
| `--time-range <range>` | Time range: `day`, `week`, `month`, `year` | - |
| `--include-domains <domains>` | Comma-separated domains to include | - |
| `--exclude-domains <domains>` | 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

_meta.json

{
  "ownerId": "kn724ben7jjrcy3pebw2jbak3s8201cp",
  "slug": "liang-tavily-search",
  "version": "1.0.1",
  "publishedAt": 1772418920934
}

skill-card.md

## Description:

Web search using Tavily's LLM-optimized API. Returns relevant results with content snippets, scores, and metadata.

This skill is ready for commercial/non-commercial use.

## Publisher:

[matthew77](https://clawhub.ai/user/matthew77)

### License/Terms of Use:


## Use Case:

Developers and agents use this skill to run web searches through Tavily and retrieve LLM-oriented snippets, relevance scores, metadata, optional raw content, and filtered result sets.

### Deployment Geography for Use:

Global

## Known Risks and Mitigations:

Risk: Search terms and selected search options are sent to Tavily.

Mitigation: Avoid confidential prompts, secrets, personal data, and proprietary internal identifiers unless Tavily's data handling terms satisfy the deployment requirements.

Risk: The skill requires a Tavily API key in configuration or the TAVILY_API_KEY environment variable.

Mitigation: Store the API key in the agent's approved secret management path and avoid printing or committing it.

## Reference(s):

- [Tavily](https://tavily.com)
- [Tavily Search API endpoint](https://api.tavily.com/search)
- [ClawHub skill page](https://clawhub.ai/matthew77/skills/liang-tavily-search)

## Skill Output:

**Output Type(s):** [text, markdown, JSON, shell commands]

**Output Format:** [Markdown search results with titles, URLs, snippets, relevance scores, optional answer text, and optional raw JSON.]

**Output Parameters:** [1D]

**Other Properties Related to Output:** [Requires Node.js and TAVILY_API_KEY; result count is clamped to 1-20.]

## Skill Version(s):

1.0.1 (source: server release metadata)

## Ethical Considerations:

Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.

Sponsored

Ads related to Tavily Search and adjacent AI workflows.