What makes Tavily Search Skill notable?

6K downloads. Trust evidence available

How should Tavily Search Skill be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this agent.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

Claim this agent

agentCLAWHUBUnverified

Tavily Search Skill

Web search via Tavily API (alternative to Brave). Use when the user asks to search the web / look up sources / find links and Brave web_search is unavailable... Skill: Tavily Search Skill Owner: jayegt002 Summary: Web search via Tavily API (alternative to Brave). Use when the user asks to search the web / look up sources / find links and Brave web_search is unavailable... Tags: latest:1.0.7, security:1.0.6 Version history: v1.0.7 | 2026-04-02T22:02:17.361Z | auto - Updated documentation with clearer installation, setup, and usage instructions. - Restructured skill directory

OpenClaw

View on ClawHub Homepage

Rank

Safety

Downloads

6.0k

Updated

Oct 9, 2026

Version

1.0.7

Source

CLAWHUB

About

What it does, and when to use it.

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

Avoid when

Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor: Clawhubvendor · observed Oct 9, 2026
Protocol compatibility: OpenClawcompatibility · observed Oct 9, 2026
Adoption signal: 6K downloadsadoption · observed Oct 9, 2026
Latest release: 1.0.7release · observed Apr 2, 2026
Handshake status: UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s176rgfjpm6knwsvbxhfy2rf65842yvc:tavily-search-skill

Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.
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-jayegt002-tavily-search-skill/snapshot"

Documentation

CLAWHUB

21,430 characters of source documentation, loaded on request.

Extracted files

4 files captured from the source.

SKILL.md

---
name: tavily-search-skill
description: Web search via Tavily API (alternative to Brave). Use when the user asks to search the web / look up sources / find links and Brave web_search is unavailable or undesired.
metadata:
  openclaw:
    homepage: https://github.com/JayeGT002/Tavily-Search-Skill
---

# Tavily Search Skill

OpenClaw Skill for performing high quality web searches using the Tavily API.

## Directory Structure

```
tavily-search-skill/
├── SKILL.md                    ← must stay at root
├── search.sh                   ← must stay at root (entry script)
├── apikey                      ← API Key file (user creates this)
├── _meta.json
└── blocklist/
    ├── blocklist.json         ← blacklist config
    └── filter_blocklist.py     ← filter script
```

## Agent Workflow

When instructed to install this skill, follow these steps in order:

### Step 1: Install the skill

```bash
git clone https://github.com/JayeGT002/Tavily-Search-Skill.git tavily-search-skill
cd tavily-search-skill
```

### Step 2: Request API Key from user

Ask the user: "请提供你的 Tavily API Key，用于配置搜索功能。获取地址：https://app.tavily.com/api-keys"

**Wait for the user's API Key reply before proceeding.**

### Step 3: Create apikey file

```bash
echo "USER_PROVIDED_API_KEY" > apikey
chmod 600 apikey
```

### Step 4: Verify installation

```bash
./search.sh "test"
```

A successful response contains search results and quota info.

---

## Blacklist Management

The blacklist filters out low quality or untrusted sources from search results.

### View current blacklist

```bash
cat blocklist/blocklist.json
```

### Add a domain to blacklist

When the user says "block [domain]", update `blocklist/blocklist.json`:

Root domains automatically match all subdomains. Example: adding `csdn.net` also blocks `blog.csdn.net`, `download.csdn.net`, etc.

### Filter feedback

When results are filtered, a message is written to stderr (not visible in normal output). Check stderr if you suspect filtering is silently removing results.

---

## Usage

### Basic Search

```bash
./search.sh "search query"
```

### Specify Result Count

```bash
./search.sh "query" 10
```

### Include Images

```bash
./search.sh "query" 5 true
```

## Dependencies

- `curl`
- `jq`

Install if missing:
- Ubuntu/Debian: `sudo apt-get install curl jq`
- macOS: `brew install curl jq`
- Alpine: `apk add curl jq`

_meta.json

{
  "ownerId": "kn78ns1svg36jybcqfkxhtvcp182kf18",
  "slug": "tavily-search-skill",
  "version": "1.0.7",
  "publishedAt": 1775167337361
}

skill-card.md

## Description:

Web search via Tavily API for looking up sources, finding links, and retrieving web results when Brave web_search is unavailable or undesired.

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

## Publisher:

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

### License/Terms of Use:

MIT-0

## Use Case:

Developers and agents use this skill to run Tavily web searches, retrieve result links, optionally include images, and filter blocked domains.

### Deployment Geography for Use:

Global

## Known Risks and Mitigations:

Risk: Install instructions fetch mutable remote code that may differ from the reviewed artifact.

Mitigation: Verify or pin the downloaded code before running search.sh, and prefer a reviewed release artifact where possible.

Risk: Search queries are sent to Tavily and may expose sensitive user intent or confidential text.

Mitigation: Avoid searching for secrets, credentials, private data, or confidential material.

Risk: The Tavily API key can be stored in a local plaintext apikey file.

Mitigation: Prefer the TAVILY_API_KEY environment variable; if a local file is required, restrict permissions to the current user.

## Reference(s):

- [ClawHub Skill Page](https://clawhub.ai/jayegt002/skills/tavily-search-skill)
- [Project Homepage](https://github.com/JayeGT002/Tavily-Search-Skill)
- [Tavily API Keys](https://app.tavily.com/api-keys)

## Skill Output:

**Output Type(s):** [text, code, shell commands, configuration, guidance]

**Output Format:** [JSON search results with Markdown setup and usage guidance]

**Output Parameters:** [1D]

**Other Properties Related to Output:** [May include query text, result records, quota information, response time, and filtered domain output.]

## Skill Version(s):

1.0.7 (source: server release metadata and _meta.json)

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

blocklist/blocklist.json

{
  "blocked": [
    {"domain": "baidu.com", "reason": "百度搜索（机器生成/过时内容）"},
    {"domain": "csdn.net", "reason": "CSDN（爬虫聚合/SEO作弊）"},
    {"domain": "jianshu.com", "reason": "简书（洗稿/标题党/同质化）"},
    {"domain": "toutiao.com", "reason": "今日头条（AI垃圾内容重灾区）"},
    {"domain": "mp.sohu.com", "reason": "搜狐自媒体（营销号聚集地）"}
  ]
}

Github ReposUpdated 1h agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW

Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW

Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.