---
read_when:
- Tavily destekli web araması istiyorsunuz
- Tavily API anahtarına ihtiyacınız var
- Tavily'yi web_search sağlayıcısı olarak istiyorsunuz
- URL'lerden içerik çıkarmak istiyorsunuz
summary: Tavily arama ve çıkarma araçları
title: Tavily
x-i18n:
generated_at: "2026-05-10T19:59:15Z"
model: gpt-5.5
provider: openai
source_hash: 071e2b1be054890711e32d7424d16d94133d16ff1ce7da3703e62c53b5c217ef
source_path: tools/tavily.md
workflow: 16
---
[Tavily](https://tavily.com), AI uygulamaları için tasarlanmış bir arama API'sidir. OpenClaw bunu iki şekilde sunar:
- genel arama aracı için `web_search` sağlayıcısı olarak
- açık Plugin araçları olarak: `tavily_search` ve `tavily_extract`
Tavily, yapılandırılabilir arama derinliği, konu filtreleme, alan adı filtreleri, AI tarafından oluşturulan yanıt özetleri ve URL'lerden içerik çıkarma (JavaScript ile oluşturulan sayfalar dahil) ile LLM tüketimi için optimize edilmiş yapılandırılmış sonuçlar döndürür.
| Özellik | Değer |
| ------------- | ----------------------------------- |
| Plugin kimliği | `tavily` |
| Kimlik doğrulama | `TAVILY_API_KEY` veya config `apiKey` |
| Temel URL | `https://api.tavily.com` (varsayılan) |
| Paketli araçlar | `tavily_search`, `tavily_extract` |
## Başlarken
[tavily.com](https://tavily.com) adresinde bir Tavily hesabı oluşturun, ardından panoda bir API anahtarı oluşturun.
```json5
{
plugins: {
entries: {
tavily: {
enabled: true,
config: {
webSearch: {
apiKey: "tvly-...", // optional if TAVILY_API_KEY is set
baseUrl: "https://api.tavily.com",
},
},
},
},
},
tools: {
web: {
search: {
provider: "tavily",
},
},
},
}
```
Herhangi bir agent'tan bir `web_search` tetikleyin veya doğrudan `tavily_search` çağırın.
Onboarding sırasında Tavily'yi seçmek veya `openclaw configure --section web` komutunu kullanmak, paketli Tavily Plugin'ini otomatik olarak etkinleştirir.
## Araç referansı
### `tavily_search`
Genel `web_search` yerine Tavily'ye özgü arama kontrolleri istediğinizde bunu kullanın.
| Parametre | Tür | Kısıtlamalar / varsayılan | Açıklama |
| ----------------- | ------------ | -------------------------------------- | ----------------------------------------------- |
| `query` | string | gerekli | Arama sorgusu dizesi. 400 karakterin altında tutun. |
| `search_depth` | enum | `basic` (varsayılan), `advanced` | `advanced` daha yavaştır ancak daha yüksek alaka düzeyi sağlar. |
| `topic` | enum | `general` (varsayılan), `news`, `finance` | Konu ailesine göre filtreleyin. |
| `max_results` | integer | 1-20 | Sonuç sayısı. |
| `include_answer` | boolean | varsayılan `false` | Tavily AI tarafından oluşturulan bir yanıt özeti ekleyin. |
| `time_range` | enum | `day`, `week`, `month`, `year` | Sonuçları güncelliğe göre filtreleyin. |
| `include_domains` | string dizisi | (yok) | Yalnızca bu alan adlarından gelen sonuçları dahil edin. |
| `exclude_domains` | string dizisi | (yok) | Bu alan adlarından gelen sonuçları hariç tutun. |
Arama derinliği ödünleşimi:
| Derinlik | Hız | Alaka düzeyi | En uygun kullanım |
| ---------- | ------ | --------- | ------------------------------------ |
| `basic` | Daha hızlı | Yüksek | Genel amaçlı sorgular (varsayılan). |
| `advanced` | Daha yavaş | En yüksek | Hassas araştırma ve doğruluk kontrolü. |
### `tavily_extract`
Bir veya daha fazla URL'den temiz içerik çıkarmak için bunu kullanın. JavaScript ile oluşturulan sayfaları işler ve hedefli çıkarım için sorgu odaklı parçalamayı destekler.
| Parametre | Tür | Kısıtlamalar / varsayılan | Açıklama |
| ------------------- | ------------ | ----------------------------- | ----------------------------------------------------------- |
| `urls` | string dizisi | gerekli, 1-20 | İçerik çıkarılacak URL'ler. |
| `query` | string | (isteğe bağlı) | Çıkarılan parçaları bu sorguya göre alaka düzeyiyle yeniden sıralayın. |
| `extract_depth` | enum | `basic` (varsayılan), `advanced` | JS ağırlıklı sayfalar, SPA'lar veya dinamik tablolar için `advanced` kullanın. |
| `chunks_per_source` | integer | 1-5; **`query` gerektirir** | URL başına döndürülen parçalar. `query` olmadan ayarlanırsa hata verir. |
| `include_images` | boolean | varsayılan `false` | Sonuçlara görsel URL'lerini dahil edin. |
Çıkarma derinliği ödünleşimi:
| Derinlik | Ne zaman kullanılmalı |
| ---------- | ------------------------------------------ |
| `basic` | Basit sayfalar. Önce bunu deneyin. |
| `advanced` | JS ile oluşturulan SPA'lar, dinamik içerik, tablolar. |
Daha büyük URL listelerini birden fazla `tavily_extract` çağrısına bölün (istek başına en fazla 20). Tam sayfalar yerine yalnızca ilgili içeriği almak için `query` ile `chunks_per_source` kullanın.
## Doğru aracı seçme
| İhtiyaç | Araç |
| ------------------------------------ | ---------------- |
| Hızlı web araması, özel seçenek yok | `web_search` |
| Derinlik, konu ve AI yanıtlarıyla arama | `tavily_search` |
| Belirli URL'lerden içerik çıkarma | `tavily_extract` |
Sağlayıcı olarak Tavily kullanılan genel `web_search` aracı, `query` ve `count` (en fazla 20 sonuç) destekler. Tavily'ye özgü kontroller (`search_depth`, `topic`, `include_answer`, alan adı filtreleri, zaman aralığı) için bunun yerine `tavily_search` kullanın.
## Gelişmiş yapılandırma
Tavily istemcisi API anahtarını şu sırayla arar:
1. `plugins.entries.tavily.config.webSearch.apiKey` (SecretRefs üzerinden çözümlenir).
2. Gateway ortamından `TAVILY_API_KEY`.
Hiçbiri yoksa `tavily_extract` bir kurulum hatası verir.
Tavily'yi bir proxy üzerinden sunuyorsanız `plugins.entries.tavily.config.webSearch.baseUrl` değerini geçersiz kılın. Varsayılan `https://api.tavily.com` değeridir.
`tavily_extract`, `query` olmadan `chunks_per_source` iletilen çağrıları reddeder. Tavily parçaları sorgu alaka düzeyine göre sıralar, bu nedenle bu parametre sorgu olmadan anlamsızdır.
## İlgili
Tüm sağlayıcılar ve otomatik algılama kuralları.
İçerik çıkarma ile arama ve scraping.
İçerik çıkarma ile nöral arama.
Plugin girdileri ve araç yönlendirme için tam config şeması.