Tavily Search Web Search
This skill provides the ability to search the internet for information in real time, using the Tavily API to obtain high-quality web results, summaries, and links.
Use Cases
- Real-Time Information: Find the latest news, version updates, company announcements, social events, and technology news.
- Resource Location: Search for official documentation, developer manuals, entry points to original papers, online course pages, and official tool websites.
- Fact-Checking: Answer questions containing time-sensitive terms such as "recent," "current," "latest," "official website," or "today."
- In-Depth Background: Before answering complex questions, use search to gather industry background or multiple perspectives.
Dependencies and Configuration
- Dependencies:
python3, Python package tavily-python.
- Environment Variable:
TAVILY_API_KEY must be set.
Environment Variable Configuration
If the environment variable is not configured, you can quickly set it using the following link:
If a dependency is missing from the environment, run:
python3 -m pip install tavily-python
Tools and Scripts
This skill includes one core Python script that supports text and JSON output.
Script Location
/var/minis/skills/tavily-search/scripts/search.py
Command Examples
# Basic search (default text output, including title/URL/summary)
python3 scripts/search.py "Python 3.13 New Features"
# Specify the number of results to return
python3 scripts/search.py "Shanghai Events This Week" --max 8
# Get JSON format (suitable for further processing by the model)
python3 scripts/search.py "Rust Web Framework" --format json
# Include the reference answer generated by the API (if any)
python3 scripts/search.py "What is RAG Technology" --include-answer
Parameter Description
query (positional argument): Search keyword.
--max: Number of results to return. Default is 5.
--format: text (default) or json.
--include-answer: Boolean switch. In text mode, displays the API-aggregated answer field.
Workflow Recommendations
- Search First, Then Answer: For topics that are not general common knowledge, especially recent events, first call
search.py to obtain context, then synthesize the answer.
- Include Source Citations: At the end of the answer or within paragraphs, be sure to include URLs from the search results as sources to improve credibility.
- Structured Processing: If you need to process a large amount of information, prioritize using
--format json and parse the results internally.
minis_url: minis://skills/tavily-search/SKILL.md
1---2name: tavily-search3description: Use the Tavily Search API to perform web searches. When users need to find the latest information, official documentation, news updates, tutorial links, policy changes, or any real-time facts, prioritize triggering this skill. Be sure to load this skill whenever information retrieval requests appear, such as "look this up," "latest," "now," "official website," "literature/paper/course entry point," or "is there a better solution?" It supports searching web pages and retrieving summaries and original links. This skill should take precedence over pure model guessing to provide users with verifiable sources of information.4---56# Tavily Search Web Search78This skill provides the ability to search the internet for information in real time, using the Tavily API to obtain high-quality web results, summaries, and links.910## Use Cases1112- **Real-Time Information**: Find the latest news, version updates, company announcements, social events, and technology news.13- **Resource Location**: Search for official documentation, developer manuals, entry points to original papers, online course pages, and official tool websites.14- **Fact-Checking**: Answer questions containing time-sensitive terms such as "recent," "current," "latest," "official website," or "today."15- **In-Depth Background**: Before answering complex questions, use search to gather industry background or multiple perspectives.1617## Dependencies and Configuration1819- **Dependencies**: `python3`, Python package `tavily-python`.20- **Environment Variable**: `TAVILY_API_KEY` must be set.2122### Environment Variable Configuration2324If the environment variable is not configured, you can quickly set it using the following link:2526- [Set TAVILY_API_KEY](minis://settings/environments?create_key=TAVILY_API_KEY&create_value=)2728If a dependency is missing from the environment, run:2930```bash31python3 -m pip install tavily-python32```3334## Tools and Scripts3536This skill includes one core Python script that supports text and JSON output.3738### Script Location3940`/var/minis/skills/tavily-search/scripts/search.py`4142### Command Examples4344```bash45# Basic search (default text output, including title/URL/summary)46python3 scripts/search.py "Python 3.13 New Features"4748# Specify the number of results to return49python3 scripts/search.py "Shanghai Events This Week" --max 85051# Get JSON format (suitable for further processing by the model)52python3 scripts/search.py "Rust Web Framework" --format json5354# Include the reference answer generated by the API (if any)55python3 scripts/search.py "What is RAG Technology" --include-answer56```5758### Parameter Description5960- `query` (positional argument): Search keyword.61- `--max`: Number of results to return. Default is 5.62- `--format`: `text` (default) or `json`.63- `--include-answer`: Boolean switch. In text mode, displays the API-aggregated `answer` field.6465## Workflow Recommendations66671. **Search First, Then Answer**: For topics that are not general common knowledge, especially recent events, first call `search.py` to obtain context, then synthesize the answer.682. **Include Source Citations**: At the end of the answer or within paragraphs, be sure to include URLs from the search results as sources to improve credibility.693. **Structured Processing**: If you need to process a large amount of information, prioritize using `--format json` and parse the results internally.7071minis_url: minis://skills/tavily-search/SKILL.md