Skip to main content

​
Tavily

Shanone’s Tavily integration gives your agent 5 tools for AI-optimized web search and content retrieval — search results are pre-cleaned and ranked for LLM consumption rather than raw HTML.

​
Getting Started

1

Get a Tavily API key

Sign up at tavily.com and copy an API key from your Tavily dashboard.
2

Connect in Shanone

Ask your agent to search the web with Tavily, or add the API key proactively from Integrations in the Shanone dashboard.
3

Retry your request

Once the key is stored, shanone_execute_tool calls for tavily_* tools will succeed.
Tavily uses API key authentication rather than OAuth. If no key is connected for your account, Shanone falls back to a shared server-side key where configured — check with your admin if tavily_* calls behave unexpectedly.

​
Available Tools

Shanone provides 5 tools for Tavily:
tavily_search — AI-optimized web search with configurable depth, topic filters, and result count
tavily_extract — pull clean, structured content from one or more URLs
tavily_crawl — recursively crawl a site starting from a base URL
tavily_map — discover a site’s URL structure without extracting full content
tavily_research — multi-step, agentic research that combines search and extraction into a single synthesized answer

​
Common Use Cases

Competitive research

Search and extract pricing/feature pages from competitor sites for a comparison doc

Fact-checking

Verify a claim in a draft by searching for corroborating sources

Site discovery

Map a documentation site’s structure before deciding which pages to crawl

Deep research reports

Use tavily_research to produce a synthesized, cited answer to an open-ended question

​
Troubleshooting

Narrow the query and set an explicit topic (e.g. "news") or a time_range if the tool schema supports it — check shanone_get_tool_schema for tavily_search to see available filters.
Crawls of large sites can exceed reasonable single-call latency. Scope the crawl with a narrower base URL or lower depth/limit parameter, or use tavily_map first to plan a targeted crawl.
Your Tavily API key is missing, invalid, or has hit its plan’s request quota. Re-check the key under Integrations in the Shanone dashboard against your Tavily account.