← Back to Skills Marketplace
fangtang0206

Tavily Quota Router

by fangtang0206 · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
145
Downloads
2
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install tavily-quota-router
Description
Tavily quota-aware multi-key search router. Use when you want reliable Tavily-backed web search across multiple API keys, automatic failover for invalid/rate...
Usage Guidance
This skill appears to do what it claims, but review these practical points before installing: - Keys are stored in config/keys.json in plaintext under the skill directory. Only put keys you control there and ensure file permissions are appropriate. - The script will send whatever keys you configure to https://api.tavily.com for usage checks and searches. Do not add third-party or shared keys you don't want transmitted. - Run python3 scripts/tavily_multi_key.py test-keys or status locally first to verify behavior and that the endpoint is expected. If you run the skill on a hosted agent, remember that the host will have access to these keys and network traffic goes to Tavily. - The skill writes local state (state/quota.json) containing usage and cooldown info; that data may include usage metrics but keys are masked in outputs. - If you need tighter security, consider storing keys in a secured vault rather than in the skills config file or restricting access to the skill directory. If you want, I can walk through the code line-by-line or highlight exactly where and how keys are sent and persisted.
Capability Analysis
Type: OpenClaw Skill Name: tavily-quota-router Version: 1.0.0 The tavily-quota-router skill is a utility designed to manage multiple Tavily API keys, providing automatic failover and quota-aware routing. The core logic in scripts/tavily_multi_key.py uses standard Python libraries to interact with official Tavily API endpoints (api.tavily.com) for searching and usage tracking. No evidence of data exfiltration, unauthorized execution, or malicious prompt injection was found; the code is well-structured and aligns with its stated purpose.
Capability Assessment
Purpose & Capability
Name/description match the implementation: the script reads keys from config/keys.json, calls Tavily's /usage and /search endpoints, and routes across keys. No unrelated credentials, binaries, or external services are requested.
Instruction Scope
SKILL.md instructs the agent to use the bundled script and to consult config/keys.json; the script's runtime actions (read local config/state, call api.tavily.com, write local state) match the documented scope. It does not ask to read other system files or transmit data to unexpected endpoints.
Install Mechanism
No install spec is provided; this is instruction + script only. No downloads or package installs occur, so there is no installer risk in the skill bundle itself.
Credentials
The skill requires no environment variables or external credentials declared by the registry. It expects API keys in config/keys.json, which is coherent for a multi-key router. No unrelated secrets are requested.
Persistence & Privilege
always is false and the skill does not request elevated or system-wide privileges. It writes only its own state/config files under the skill directory (state/quota.json, config/keys.json), which is expected and proportionate.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install tavily-quota-router
  3. After installation, invoke the skill by name or use /tavily-quota-router
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of the Tavily Quota Router skill: - Enables quota-aware, multi-key Tavily web search with automatic routing and failover - Syncs API key usage via Tavily's official `/usage` endpoint - Automatically selects a healthy key and skips invalid, rate-limited, or exhausted keys - Provides per-key usage and status visibility - Includes commands to check status, test keys, perform searches, and reset local state - Requires user configuration of multiple Tavily API keys in `config/keys.json`
Metadata
Slug tavily-quota-router
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Tavily Quota Router?

Tavily quota-aware multi-key search router. Use when you want reliable Tavily-backed web search across multiple API keys, automatic failover for invalid/rate... It is an AI Agent Skill for Claude Code / OpenClaw, with 145 downloads so far.

How do I install Tavily Quota Router?

Run "/install tavily-quota-router" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Tavily Quota Router free?

Yes, Tavily Quota Router is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Tavily Quota Router support?

Tavily Quota Router is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Tavily Quota Router?

It is built and maintained by fangtang0206 (@fangtang0206); the current version is v1.0.0.

💬 Comments