← Back to Skills Marketplace
5326
Downloads
1
Stars
47
Active Installs
8
Versions
Install in OpenClaw
/install 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...
Usage Guidance
Install this only if you are comfortable sending search queries to Tavily and using a Tavily API key for quota-bearing requests. Prefer the TAVILY_API_KEY environment variable or another secret manager over a plaintext apikey file when possible, and use a reviewed or pinned source if installing from GitHub.
Capability Assessment
Purpose & Capability
The shell script performs Tavily search requests, fetches Tavily quota data, and filters blocked domains; these behaviors fit the stated web-search purpose.
Instruction Scope
The skill has a broad web-search trigger and includes installation/setup instructions, but the setup runs only when instructed to install and the routine usage is limited to search queries.
Install Mechanism
Installation uses an unpinned GitHub clone and optional system package-manager commands for curl and jq; this is disclosed but carries normal supply-chain risk.
Credentials
Network calls to Tavily, local reads of the API-key file and blocklist, temporary file use, jq, curl, and python3 are proportionate to the search and filtering workflow.
Persistence & Privilege
The skill can persist a user-provided Tavily API key in a local plaintext apikey file with chmod 600, and also supports using TAVILY_API_KEY from the environment.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install tavily-search-skill - After installation, invoke the skill by name or use
/tavily-search-skill - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.7
- Updated documentation with clearer installation, setup, and usage instructions.
- Restructured skill directory overview and agent workflow.
- Added explicit guidance on API key management and security.
- Improved section on blacklist management and filtering.
- Clarified dependencies and installation commands for common platforms.
v1.0.6
Security fix: remove hardcoded paths and suspicious behaviors flagged by VirusTotal
v1.0.5
🌟Added
Search Result Blocklist Filtering - Added blocklist/ directory with domain blocklist and filter script
blocklist/blocklist.json - Blocked domain list (supports subdomain matching)
blocklist/filter_blocklist.py - Python filter script
Automatically filters low-quality sources like Baidu and CSDN from search results
Filtered count shown in output as [BLOCKLIST] Filtered N results
📒Changed
SKILL.md Update - Fixed YAML frontmatter format
GitHub Repository Structure - Standardized layout, skill moved to Tavily-Search-Skill/ subdirectory
README Improvement - Added directory structure guide and blocklist usage instructions
🔧Fixed
Fixed blocklist being incorrectly treated as a file instead of a directory
v1.0.4
Version 1.0.4 — No changes detected in this release.
- Version number bumped to 1.0.4.
- No modifications to documentation or functionality.
-_meta.json → 1.0.4, add required_envs: ["TAVILY_API_KEY"] and required_binaries: ["curl", "jq"]
//Skill completed: All planned issues have been confirmed and fixed. The skill will no longer be updated unless there are serious problems.
v1.0.3
Version 1.0.3
- Added version, author, and trigger metadata to SKILL.md.
- Updated description to English and clarified feature list.
- Revised and translated documentation sections for broader accessibility.
- No functional or code changes detected.
v1.0.2
- Added _meta.json file.
- SKILL.md fully translated from English to Chinese (simplified), including features, usage instructions, and output examples.
- No changes to core functionality.
v1.0.1
- Updated documentation from Chinese to English for broader accessibility.
- Added English installation instructions for dependencies (`curl`, `jq`) on Ubuntu/Debian and macOS.
- Clarified required environment variable and API key setup in English.
- No functional or code changes; documentation only.
v1.0.0
Tavily-Search-Skill 1.0.0
- 初始版本，集成 Tavily API，实现高质量网络搜索功能
- 支持实时额度管理，区分免费与付费额度，自动更新使用量
- 可切换付费优先模式，便于费用控制
- 提供完整的错误处理，包括网络或额度相关问题
- 搜索结果以结构化 JSON 返回
- 提供命令行用法示例及状态、额度查询
Metadata
Frequently Asked Questions
What is 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... It is an AI Agent Skill for Claude Code / OpenClaw, with 5326 downloads so far.
How do I install Tavily Search Skill?
Run "/install tavily-search-skill" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Tavily Search Skill free?
Yes, Tavily Search Skill is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Tavily Search Skill support?
Tavily Search Skill is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Tavily Search Skill?
It is built and maintained by 黑川眠也 (@jayegt002); the current version is v1.0.7.
More Skills