← Back to Skills Marketplace
158
Downloads
0
Stars
1
Active Installs
2
Versions
Install in OpenClaw
/install tavily-metered-search
Description
Web search via Tavily API with built-in monthly usage tracking and quota management. Use when the user asks to search the web / look up sources / find links....
Usage Guidance
This skill appears to do what it says: it needs only a Tavily API key, will POST search requests to api.tavily.com, and will create/update data/tavily-usage.json in the skill folder to track counts. Before installing, (1) confirm you intend to give the skill a Tavily API key and that the vendor/site (tavily.com) is trustworthy; (2) prefer supplying the key via environment variable rather than placing it in ~/.openclaw/.env if that file contains other secrets; (3) note that --no-count skips local increment but still consumes Tavily quota; and (4) review network policies if you have constraints on outbound requests to third-party APIs.
Capability Analysis
Type: OpenClaw Skill
Name: tavily-metered-search
Version: 1.0.1
The skill provides a metered web search interface using the Tavily API, featuring monthly usage tracking and quota enforcement. The script `scripts/tavily_search.py` correctly implements its stated functionality, including reading the API key from environment variables or a local configuration file (`~/.openclaw/.env`) and managing local state in `data/tavily-usage.json`. No evidence of data exfiltration, malicious execution, or harmful prompt injection was found.
Capability Assessment
Purpose & Capability
Name/description claim web search + quota management; the bundled script implements Tavily API calls, monthly counting, warning/limit enforcement, and configuration exactly as described. Required env var (TAVILY_API_KEY) matches the claimed purpose.
Instruction Scope
Runtime instructions and the script operate within the skill's scope: they call https://api.tavily.com/search, read config/config.json, update data/tavily-usage.json, and optionally read ~/.openclaw/.env for TAVILY_API_KEY. Reading that .env file and writing the local usage file are expected for quota tracking, but users should be aware the script will read ~/.openclaw/.env if present.
Install Mechanism
No install spec; the skill is instruction/script-only and does not download or install external packages. This is low-risk from an installation perspective.
Credentials
Only TAVILY_API_KEY is required (declared). The script looks for it in the environment or in ~/.openclaw/.env. This is proportionate to the functionality, but users should ensure ~/.openclaw/.env does not contain other sensitive secrets they don't want read by skill code.
Persistence & Privilege
Skill does not request elevated privileges or set always:true. It writes/maintains only its own usage file under its skill data directory and does not modify other skills or global agent configuration.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install tavily-metered-search - After installation, invoke the skill by name or use
/tavily-metered-search - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
Add metadata declaration for TAVILY_API_KEY requirement
v1.0.0
Initial release - Tavily web search with monthly usage tracking and quota management
Metadata
Frequently Asked Questions
What is Tavily Metered Search?
Web search via Tavily API with built-in monthly usage tracking and quota management. Use when the user asks to search the web / look up sources / find links.... It is an AI Agent Skill for Claude Code / OpenClaw, with 158 downloads so far.
How do I install Tavily Metered Search?
Run "/install tavily-metered-search" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Tavily Metered Search free?
Yes, Tavily Metered Search is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Tavily Metered Search support?
Tavily Metered Search is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Tavily Metered Search?
It is built and maintained by FrankMei (@neverland83); the current version is v1.0.1.
More Skills