How do I install the Tavily skill?

Run npx skillmds@latest add tomevault-io/tavily in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Tavily skill do?

Performs a search or extracts content using the Tavily API. Use when this capability is needed. It is listed under Integrations & APIs on SkillMD.

Is Tavily safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Tavily?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Tavily free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Tavily?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Tavily by tomevault-io — Agent Skill

Name: Tavily
Author: tomevault-io

File contents

Tavily Search Skill

Performs a search or extracts content using the Tavily API. Specify 'search' or 'extract' in the 'action' parameter.

Usage

The skill is executed via a Python script: ~/.myaaw/skills/tavily/scripts/tavily.py. It accepts a JSON string as the first argument calling the tool.

Arguments

The input JSON should contain the following fields:

Field	Type	Description	Required
`action`	string	The action to perform: `search` (Search API) or `extract` (Extract API).	Yes
`search_args`	object	Arguments for the Tavily search API. Required if action is `search`.	Conditional
`extract_args`	object	Arguments for the Tavily extract API. Required if action is `extract`.	Conditional

Search Arguments (`search_args`)

Field	Type	Description	Default
`query`	string	The search query. (Required)	-
`topic`	string	Category of the search: `general` or `news`.	`general`
`search_depth`	string	Depth of the search: `basic` or `advanced`.	`basic`
`chunks_per_source`	int	Number of content chunks per source (advanced search only).	3
`max_results`	int	Maximum number of search results.	5
`time_range`	string	Time range (`day`, `week`, `month`, `year`) or abbrevs (`d`, etc).	-
`days`	int	Number of days back to include (news topic only).	7
`include_answer`	bool	Include LLM-generated answer.	`false`
`include_raw_content`	bool	Include cleaned HTML content of search results.	`false`
`include_images`	bool	Include image search results.	`false`
`include_image_descriptions`	bool	Include descriptive text for images.	`false`
`include_domains`	array	List of domains to include.	-
`exclude_domains`	array	List of domains to exclude.	-

Extract Arguments (`extract_args`)

Field	Type	Description	Default
`urls`	string	URL(s) to extract content from. Separated by commas/newlines for multiple.	(Required)
`include_images`	bool	Include images from extracted content.	`false`
`extract_depth`	string	Depth of the extraction process: `basic` or `advanced`.	`basic`

Environment

Requires TAVILY_API_KEY to be set in the environment or in a .env file in the project root.

Example

.venv/bin/python ~/.myaaw/skills/tavily/scripts/tavily.py '{"action": "search", "search_args": {"query": "AI Agents"}}'

Converted and distributed by TomeVault — claim your Tome and manage your conversions.

---name: tavilydescription: Performs a search or extracts content using the Tavily API. Use when this capability is needed.---# Tavily Search SkillPerforms a search or extracts content using the Tavily API. Specify 'search' or 'extract' in the 'action' parameter.## UsageThe skill is executed via a Python script: `~/.myaaw/skills/tavily/scripts/tavily.py`.It accepts a JSON string as the first argument calling the tool.### ArgumentsThe input JSON should contain the following fields:| Field | Type | Description | Required || :--- | :--- | :--- | :--- || `action` | string | The action to perform: `search` (Search API) or `extract` (Extract API). | Yes || `search_args` | object | Arguments for the Tavily search API. Required if action is `search`. | Conditional || `extract_args` | object | Arguments for the Tavily extract API. Required if action is `extract`. | Conditional |#### Search Arguments (`search_args`)| Field | Type | Description | Default || :--- | :--- | :--- | :--- || `query` | string | The search query. (Required) | - || `topic` | string | Category of the search: `general` or `news`. | `general` || `search_depth` | string | Depth of the search: `basic` or `advanced`. | `basic` || `chunks_per_source` | int | Number of content chunks per source (advanced search only). | 3 || `max_results` | int | Maximum number of search results. | 5 || `time_range` | string | Time range (`day`, `week`, `month`, `year`) or abbrevs (`d`, etc). | - || `days` | int | Number of days back to include (news topic only). | 7 || `include_answer` | bool | Include LLM-generated answer. | `false` || `include_raw_content` | bool | Include cleaned HTML content of search results. | `false` || `include_images` | bool | Include image search results. | `false` || `include_image_descriptions` | bool | Include descriptive text for images. | `false` || `include_domains` | array | List of domains to include. | - || `exclude_domains` | array | List of domains to exclude. | - |#### Extract Arguments (`extract_args`)| Field | Type | Description | Default || :--- | :--- | :--- | :--- || `urls` | string | URL(s) to extract content from. Separated by commas/newlines for multiple. | (Required) || `include_images` | bool | Include images from extracted content. | `false` || `extract_depth` | string | Depth of the extraction process: `basic` or `advanced`. | `basic` |### EnvironmentRequires `TAVILY_API_KEY` to be set in the environment or in a `.env` file in the project root.### Example```bash.venv/bin/python ~/.myaaw/skills/tavily/scripts/tavily.py '{"action": "search", "search_args": {"query": "AI Agents"}}'```---> Converted and distributed by [TomeVault](https://tomevault.io/claim/shiyinq) — claim your Tome and manage your conversions.

Frequently asked questions

Tavily