← Back to Skills Marketplace
574
Downloads
1
Stars
2
Active Installs
1
Versions
Install in OpenClaw
/install liang-tavily-research
Description
Comprehensive research grounded in web data with explicit citations. Use when you need multi-source synthesis—comparisons, current events, market analysis, d...
README (SKILL.md)
Tavily Research
Conduct comprehensive research on any topic with automatic source gathering, analysis, and response generation with citations.
Authentication
Get your API key at https://tavily.com and add to your OpenClaw config:
{
"skills": {
"entries": {
"tavily-research": {
"enabled": true,
"apiKey": "tvly-YOUR_API_KEY_HERE"
}
}
}
}
Or set the environment variable:
export TAVILY_API_KEY="tvly-YOUR_API_KEY_HERE"
Quick Start
Using the Script
node {baseDir}/scripts/research.mjs "query"
node {baseDir}/scripts/research.mjs "query" --pro
node {baseDir}/scripts/research.mjs "query" --output report.md
Examples
# Quick overview
node {baseDir}/scripts/research.mjs "What is retrieval augmented generation?"
# Comprehensive analysis
node {baseDir}/scripts/research.mjs "LangGraph vs CrewAI for multi-agent systems" --pro
# Market research with output file
node {baseDir}/scripts/research.mjs "Fintech startup landscape 2025" --pro --output fintech-report.md
# Technical comparison
node {baseDir}/scripts/research.mjs "React vs Vue vs Svelte" --pro
Options
| Option | Description | Default |
|---|---|---|
--model \x3Cmodel> |
Model: mini, pro, auto |
mini |
--output \x3Cfile> |
Save report to file | - |
--json |
Output raw JSON | false |
Model Selection
Rule of thumb: "what does X do?" → mini. "X vs Y vs Z" or "best way to..." → pro.
| Model | Use Case | Speed |
|---|---|---|
mini |
Single topic, targeted research | ~30s |
pro |
Comprehensive multi-angle analysis | ~60-120s |
auto |
API chooses based on complexity | Varies |
Output Format
The research includes:
- AI-generated answer: Comprehensive synthesis
- Sources: Citations with titles, URLs, and relevance scores
- Metadata: Query, response time, and statistics
Tips
- Research can take 30-120 seconds depending on complexity
- Use
--profor comparisons, market analysis, or detailed reports - Use
--outputto save reports for later reference - The
automodel lets Tavily choose based on query complexity
Usage Guidance
This skill appears to do exactly what it says: it sends your query to Tavily's API and formats the response. Before installing, confirm you trust tavily.com and are comfortable providing your Tavily API key to the agent (the key is used to authenticate requests to api.tavily.com). If you have sensitive queries, avoid using --output to save them to disk in shared locations. If you need stricter controls, consider creating a limited-scope API key (if Tavily supports that) or reviewing network policies so the skill can only contact api.tavily.com.
Capability Analysis
Type: OpenClaw Skill
Name: liang-tavily-research
Version: 1.0.0
The skill provides a wrapper for the Tavily API, allowing research queries and outputting results. The `scripts/research.mjs` script includes an `--output <file>` option that directly uses the provided file path with `fs.writeFileSync` without any path sanitization. This creates a vulnerability where an AI agent, if prompted by a malicious user or if its own logic is flawed, could be instructed to write the research report to an arbitrary file path (e.g., via path traversal), potentially overwriting sensitive files or leading to further compromise. While the feature of saving a report is legitimate, the lack of input validation for the file path constitutes a high-risk capability.
Capability Assessment
Purpose & Capability
Name/description (web research with citations) align with required items: Node runtime and a single TAVILY_API_KEY. The script sends queries to api.tavily.com and returns results, which is consistent with the stated functionality.
Instruction Scope
SKILL.md and the included script limit actions to: reading TAVILY_API_KEY, POSTing a JSON query to https://api.tavily.com/search, formatting the returned JSON into a report, and optionally writing the report to a file. There are no instructions to read other environment variables, scan local files, or transmit data to third-party endpoints.
Install Mechanism
No install spec is provided (instruction-only plus an included script). The only runtime requirement is the node binary, which is reasonable for a JS script. Nothing is downloaded from untrusted URLs or written to unusual locations.
Credentials
Only one credential is required (TAVILY_API_KEY) and it is the primary credential. That matches the need to authenticate to Tavily's API; there are no unrelated secrets or broad environment access requested.
Persistence & Privilege
always is false and the skill does not request persistent system-wide changes or modify other skills. It does not store credentials itself; it expects the user to provide the API key via env or config.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install liang-tavily-research - After installation, invoke the skill by name or use
/liang-tavily-research - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
tavily-research 1.0.0 – Initial release
- Enables comprehensive web-based research with explicit citations.
- Supports both quick overviews and detailed multi-source synthesis (comparisons, market analysis, current events).
- Allows interactive queries via command line with options for output file, model selection, and JSON output.
- Includes authentication via API key and clear instructions for setup.
- Provides flexible model choices: mini, pro, and auto, to suit various research needs.
Metadata
Frequently Asked Questions
What is Tavily Research?
Comprehensive research grounded in web data with explicit citations. Use when you need multi-source synthesis—comparisons, current events, market analysis, d... It is an AI Agent Skill for Claude Code / OpenClaw, with 574 downloads so far.
How do I install Tavily Research?
Run "/install liang-tavily-research" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Tavily Research free?
Yes, Tavily Research is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Tavily Research support?
Tavily Research is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Tavily Research?
It is built and maintained by Liang (@matthew77); the current version is v1.0.0.
More Skills