tavily-search
Ricerca web con Tavily: answer + fonti strutturate con snippet, pensata per agenti/RAG. Per raccogliere fonti da riusare.
❔ da accertare
⚪ mai vettata — nessuno l'ha ancora guardata; non vuol dire che sia a posto
C:\Users\Ettore\.openclaw\skill-workshop\proposals\tavily-search-20260709-7934e64596\PROPOSAL.mdC:\Users\Ettore\.openclaw\skill-workshop\proposals\tavily-search-20260709-7934e64596name: "tavily-search"
description: "Ricerca web con Tavily: answer + fonti strutturate con snippet, pensata per agenti/RAG. Per raccogliere fonti da riusare."
status: proposal
version: "v1"
date: "2026-07-09T12:34:08.314Z"
metadata: { "openclaw": { "requires": { "env": ["TAVILY_API_KEY"] }, "primaryEnv": "TAVILY_API_KEY" } }tavily-search
Ricerca web tramite l'API di Tavily (search API nata per agenti LLM): restituisce una answer breve più una lista di risultati strutturati (titolo, URL, snippet ripulito), ideali da passare ad altri step.
Quando usarla (vs le altre due)
- Tavily (questa) → vuoi fonti strutturate + snippet puliti da dare in pasto a un agente/RAG o a uno step successivo, con una answer sintetica di contorno. Ottima per raccolta fonti automatizzata.
- perplexity-search → quando vuoi una risposta ragionata completa, non una lista.
- serpapi-search → quando vuoi la SERP grezza del motore (posizionamento reale, news, local, shopping).
Come si usa
Esegui lo script con la query come argomento:
python {baseDir}/scripts/search.py "fornitori europei di batterie LFP per storage domestico"Variabili opzionali:
TAVILY_DEPTH(basicdefault |advanced— piu approfondita, costa piu crediti).TAVILY_MAX(numero risultati, default 5).
Output: Risposta: (answer sintetica) + Risultati: elenco numerato con titolo, URL e snippet.
Setup
Richiede la chiave TAVILY_API_KEY (free tier ~1000 ricerche/mese). Istruzioni in references/SETUP.md.
Note
- Pensata per pipeline: l'output e facile da rileggere e citare.
- Se manca la chiave la skill non si attiva (gating su
requires.env).
Conteggio esatto dall'endpoint Anthropic count_tokens (gratuito, solo rate-limited), envelope del messaggio già sottratto. I caratteri sono un dato locale, servono da riscontro.
Questa skill è in sola lettura: le proposte si applicano o si rifiutano dal workshop. Per lavorarci sopra si copia la cartella nello workspace di un agente e si modifica lì.
- proposal.json1.3 kB
- PROPOSAL.md1.7 kB
- references/SETUP.md643 B
- scripts/search.py1.6 kB
nessuna modifica fatta da qui: nessun backup
questo workspace non è un repo git
Scrittura consentita solo dentro le cartelle skills\ dei workspace del registro e solo sul file SKILL.md (deroga alla stanza Identità autorizzata da Ettore il 2026-08-10). Ogni salvataggio crea prima un backup datato; nessun file viene mai cancellato.