tavily-search
Perform real-time web searches with customizable filters for topics, domains, and time ranges. Retrieve detailed results, including raw content, images, and AI-generated answers, for comprehensive information gathering.
Instructions
A powerful web search tool that provides comprehensive, real-time results using Tavily's AI search engine. Returns relevant web content with customizable parameters for result count, content type, and domain filtering. Ideal for gathering current information, news, and detailed web content analysis.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| auto_parameters | No | Let Tavily automatically configure search parameter based on the querry. The explicit parameters will override the automatic ones. | |
| country | No | Boost search results from a specific country. This will prioritize content from the selected country in the search results. Available only if topic is general. | |
| days | No | The number of days back from the current date to include in the search results. This specifies the time frame of data to be retrieved. Please note that this feature is only available when using the 'news' search topic | |
| exclude_domains | No | List of domains to specifically exclude, if the user asks to exclude a domain set this to the domain of the site | |
| include_answer | No | Include an LLM-generated answer to the provided query | |
| include_domains | No | A list of domains to specifically include in the search results, if the user asks to search on specific sites set this to the domain of the site | |
| include_image_descriptions | No | Include a list of query-related images and their descriptions in the response | |
| include_images | No | Include a list of query-related images in the response | |
| include_raw_content | No | Include the cleaned and parsed HTML content of each search result | |
| max_results | No | The maximum number of search results to return | |
| query | Yes | The search query to execute with Tavily. | |
| search_depth | No | The depth of the search. It can be 'basic' or 'advanced' | basic |
| time_range | No | The time range back from the current date to include in the search results. This feature is available for both 'general' and 'news' search topics | |
| topic | No | The category of the search. This will determine which of our agents will be used for the search | general |
Input Schema (JSON Schema)
{
"properties": {
"auto_parameters": {
"default": false,
"description": "Let Tavily automatically configure search parameter based on the querry. The explicit parameters will override the automatic ones.",
"title": "Auto Parameters",
"type": "boolean"
},
"country": {
"anyOf": [
{
"enum": [
"afghanistan",
"albania",
"algeria",
"andorra",
"angola",
"argentina",
"armenia",
"australia",
"austria",
"azerbaijan",
"bahamas",
"bahrain",
"bangladesh",
"barbados",
"belarus",
"belgium",
"belize",
"benin",
"bhutan",
"bolivia",
"bosnia and herzegovina",
"botswana",
"brazil",
"brunei",
"bulgaria",
"burkina faso",
"burundi",
"cambodia",
"cameroon",
"canada",
"cape verde",
"central african republic",
"chad",
"chile",
"china",
"colombia",
"comoros",
"congo",
"costa rica",
"croatia",
"cuba",
"cyprus",
"czech republic",
"denmark",
"djibouti",
"dominican republic",
"ecuador",
"egypt",
"el salvador",
"equatorial guinea",
"eritrea",
"estonia",
"ethiopia",
"fiji",
"finland",
"france",
"gabon",
"gambia",
"georgia",
"germany",
"ghana",
"greece",
"guatemala",
"guinea",
"haiti",
"honduras",
"hungary",
"iceland",
"india",
"indonesia",
"iran",
"iraq",
"ireland",
"israel",
"italy",
"jamaica",
"japan",
"jordan",
"kazakhstan",
"kenya",
"kuwait",
"kyrgyzstan",
"latvia",
"lebanon",
"lesotho",
"liberia",
"libya",
"liechtenstein",
"lithuania",
"luxembourg",
"madagascar",
"malawi",
"malaysia",
"maldives",
"mali",
"malta",
"mauritania",
"mauritius",
"mexico",
"moldova",
"monaco",
"mongolia",
"montenegro",
"morocco",
"mozambique",
"myanmar",
"namibia",
"nepal",
"netherlands",
"new zealand",
"nicaragua",
"niger",
"nigeria",
"north korea",
"north macedonia",
"norway",
"oman",
"pakistan",
"panama",
"papua new guinea",
"paraguay",
"peru",
"philippines",
"poland",
"portugal",
"qatar",
"romania",
"russia",
"rwanda",
"saudi arabia",
"senegal",
"serbia",
"singapore",
"slovakia",
"slovenia",
"somalia",
"south africa",
"south korea",
"south sudan",
"spain",
"sri lanka",
"sudan",
"sweden",
"switzerland",
"syria",
"taiwan",
"tajikistan",
"tanzania",
"thailand",
"togo",
"trinidad and tobago",
"tunisia",
"turkey",
"turkmenistan",
"uganda",
"ukraine",
"united arab emirates",
"united kingdom",
"united states",
"uruguay",
"uzbekistan",
"venezuela",
"vietnam",
"yemen",
"zambia",
"zimbabwe"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Boost search results from a specific country. This will prioritize content from the selected country in the search results. Available only if topic is general.",
"title": "Country"
},
"days": {
"default": 3,
"description": "The number of days back from the current date to include in the search results. This specifies the time frame of data to be retrieved. Please note that this feature is only available when using the 'news' search topic",
"title": "Days",
"type": "integer"
},
"exclude_domains": {
"description": "List of domains to specifically exclude, if the user asks to exclude a domain set this to the domain of the site",
"items": {
"type": "string"
},
"title": "Exclude Domains",
"type": "array"
},
"include_answer": {
"default": false,
"description": "Include an LLM-generated answer to the provided query",
"title": "Include Answer",
"type": "boolean"
},
"include_domains": {
"description": "A list of domains to specifically include in the search results, if the user asks to search on specific sites set this to the domain of the site",
"items": {
"type": "string"
},
"title": "Include Domains",
"type": "array"
},
"include_image_descriptions": {
"default": false,
"description": "Include a list of query-related images and their descriptions in the response",
"title": "Include Image Descriptions",
"type": "boolean"
},
"include_images": {
"default": false,
"description": "Include a list of query-related images in the response",
"title": "Include Images",
"type": "boolean"
},
"include_raw_content": {
"default": false,
"description": "Include the cleaned and parsed HTML content of each search result",
"title": "Include Raw Content",
"type": "boolean"
},
"max_results": {
"default": 10,
"description": "The maximum number of search results to return",
"maximum": 20,
"minimum": 5,
"title": "Max Results",
"type": "integer"
},
"query": {
"description": "The search query to execute with Tavily.",
"title": "Query",
"type": "string"
},
"search_depth": {
"default": "basic",
"description": "The depth of the search. It can be 'basic' or 'advanced'",
"enum": [
"basic",
"advanced"
],
"title": "Search Depth",
"type": "string"
},
"time_range": {
"anyOf": [
{
"enum": [
"day",
"week",
"month",
"year",
"d",
"w",
"m",
"y"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "The time range back from the current date to include in the search results. This feature is available for both 'general' and 'news' search topics",
"title": "Time Range"
},
"topic": {
"default": "general",
"description": "The category of the search. This will determine which of our agents will be used for the search",
"enum": [
"general",
"news"
],
"title": "Topic",
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
}