Skip to content

Add Tavily community connector - #16

Merged
aezell merged 2 commits into
mainfrom
alex/tavily-connector
Nov 19, 2026
Merged

aezell merged 2 commits into
mainfrom
alex/tavily-connector

Conversation

@aezell

@aezell aezell commented Nov 19, 2026

Copy link
Copy Markdown
Collaborator

Summary

Adds connectors/tavily, a community connector for the Tavily API at https://api.tavily.com.

  • owner: community. I do not work for Tavily.
  • Auth: Authorization: Bearer tvly-... per the headers and authentication page. Keys come from app.tavily.com; the free plan has 1,000 credits a month.
  • Retry-After is forwarded (Tavily documents it on 429). Credit costs per request are in the Billing notice and the example titles, from the credits page.

Routes

Route Docs
POST /search Search
POST /extract Extract
POST /crawl Crawl
POST /map Map
POST /research Research
GET /research/:request_id Get research
GET /usage Usage

Not forwarded: enterprise key management and organization usage endpoints, GET /logs, POST /feedback, and keyless access mode (a different auth header).

Probe

GET /usage: the only documented key-information endpoint; spends no credits. Asserts key and account are objects, key.usage is an integer, account.current_plan is non-empty text and detail is absent. Tavily limits /usage to 10 requests per 10 minutes (rate limits), which the example notes mention. If reviewers would rather not depend on that limit, a one-result POST /search (1 credit per check) is the fallback.

  • A made-up key returned HTTP 401 {"detail": {"error": "Unauthorized: missing or invalid API key."}} on 2026-11-19; scripts/probe.mjs classifies it invalid_api_key. Every POST route and GET /research/:id also answered 401 to the made-up key, so the paths exist.
  • Not run with a real key. I have no Tavily account to probe with; the assertions follow the documented response.
  • node scripts/check-connectors.mjs tavily and the ajv schema check pass.

Icons

The square mark cropped from the logo on Tavily's docs site (mintlify.s3.us-west-1.amazonaws.com/tavilyai/logo/light.svg); icon.svg in the original #1F1E1E, mark.svg in currentColor. Tavily publishes no brand page; the logo is its trademark, used to identify the service.

🤖 Generated with Claude Code

Bearer auth; the probe reads GET /usage, which spends no credits. Forwards
search, extract, crawl, map, research (start and poll) and usage.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@aezell
aezell requested a review from a team as a code owner November 19, 2026 19:29
@aezell
aezell merged commit 6b09c15 into main Nov 19, 2026
3 checks passed
@aezell
aezell deleted the alex/tavily-connector branch November 19, 2026 19:58
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant