Xpersona
T

Tavily

CLAWHUB · Unverified

Use Tavily web search/discovery to find URLs/sources, do lead research, gather up-to-date links, or produce a cited summary from web results. Skill: Tavily Owner: tylordius Summary: Use Tavily web search/discovery to find URLs/sources, do lead research, gather up-to-date links, or produce a cited summary from web results. Tags: latest:0.1.1 Version history: v0.1.1 | 2026-02-28T14:52:37.545Z | user Security metadata: declare required env var TAVILY_API_KEY. Remove TAVILY_ENDPOINT override; hardcode endpoint https://api.tavily.com/search. v0.1.0 | 2026-02-28

62
Rank
84
Safety
10k
Downloads

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 10K downloads reported by the source. Last updated 11/16/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 s17axawbz8hdwmk76wzrsxwg6n884ffh:tavily-tool
  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-tylordius-tavily-tool-ily-tool-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

8,762 characters of source documentation, loaded on request.

Extracted files

4 files captured from the source.

SKILL.md

---
name: tavily
description: Use Tavily web search/discovery to find URLs/sources, do lead research, gather up-to-date links, or produce a cited summary from web results.
metadata: {"openclaw":{"requires":{"env":["TAVILY_API_KEY"]},"primaryEnv":"TAVILY_API_KEY"}}
---

# Tavily

Use the bundled CLI to run Tavily searches from the terminal and collect sources fast.

## Quick start (CLI)

The scripts **require** `TAVILY_API_KEY` in the environment (sent as `Authorization: Bearer ...`).

```bash
export TAVILY_API_KEY="..."
node skills/tavily/scripts/tavily_search.js --query "best rust http client" --max_results 5
```

- JSON response is printed to **stdout**.
- A simple URL list is printed to **stderr** by default.

## Common patterns

### Get URLs only

```bash
export TAVILY_API_KEY="..."
node skills/tavily/scripts/tavily_search.js --query "OpenTelemetry collector config" --urls-only
```

### Restrict to (or exclude) specific domains

```bash
export TAVILY_API_KEY="..."
node skills/tavily/scripts/tavily_search.js \
  --query "oauth device code flow" \
  --include_domains oauth.net,datatracker.ietf.org \
  --exclude_domains medium.com
```

## Notes

- The bundled CLI supports a subset of Tavily’s request fields (query, max_results, include_domains, exclude_domains).
- For API field notes and more examples, read: `references/tavily-api.md`.
- Wrapper script (optional): `scripts/tavily_search.sh`.

_meta.json

{
  "ownerId": "kn78x7kg14jggfbz385es5bdrn81ddgw",
  "slug": "tavily-tool",
  "version": "0.1.1",
  "publishedAt": 1772290357545
}

references/tavily-api.md

# Tavily API notes (quick reference)

## Endpoint

- Search: `POST https://api.tavily.com/search`

## Auth

- Send the API key via HTTP header: `Authorization: Bearer <TAVILY_API_KEY>`.
- This skill’s scripts read the key from **env var only**: `TAVILY_API_KEY`.

## Common request fields

```json
{
  "query": "...",
  "max_results": 5,
  "include_domains": ["example.com"],
  "exclude_domains": ["spam.com"]
}
```

(Additional Tavily options exist; this skill’s CLI supports only a common subset for discovery use-cases.)

## Script usage

### JSON output (stdout) + URL list (stderr)

```bash
export TAVILY_API_KEY="..."
node skills/tavily/scripts/tavily_search.js --query "best open source vector database" --max_results 5
```

### URLs only

```bash
export TAVILY_API_KEY="..."
node skills/tavily/scripts/tavily_search.js --query "SvelteKit tutorial" --urls-only
```

### Include / exclude domains

```bash
export TAVILY_API_KEY="..."
node skills/tavily/scripts/tavily_search.js \
  --query "websocket load testing" \
  --include_domains k6.io,github.com \
  --exclude_domains medium.com
```

## Notes

- Exit code `2` indicates missing required args or missing `TAVILY_API_KEY`.
- Exit code `3` indicates network/HTTP failure.
- Exit code `4` indicates a non-JSON response.

skill-card.md

## Description:

Use Tavily web search/discovery to find URLs/sources, do lead research, gather up-to-date links, or produce a cited summary from web results.

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

## Publisher:

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

### License/Terms of Use:


## Use Case:

Developers and agents use this skill to run Tavily searches from the terminal, collect current source URLs, and gather search-result JSON for research or citation workflows.

### Deployment Geography for Use:

Global

## Known Risks and Mitigations:

Risk: Search queries and the Tavily API key are sent to Tavily's API.

Mitigation: Avoid sensitive private data in search queries and scope TAVILY_API_KEY to this use where the environment supports it.

Risk: The CLI supports only a subset of Tavily request fields.

Mitigation: Use the documented parameters for discovery workflows or call Tavily directly when unsupported API fields are required.

## Reference(s):

- [Tavily API notes](references/tavily-api.md)
- [Tavily search endpoint](https://api.tavily.com/search)
- [ClawHub skill page](https://clawhub.ai/tylordius/skills/tavily-tool)

## Skill Output:

**Output Type(s):** [API Calls, Shell commands, JSON, Guidance]

**Output Format:** [JSON search responses or newline-delimited URLs, with Markdown usage guidance]

**Output Parameters:** [1D]

**Other Properties Related to Output:** [Requires TAVILY_API_KEY; supports query, max_results, include_domains, and exclude_domains.]

## Skill Version(s):

0.1.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 and adjacent AI workflows.