Smart Search — guida alla ricerca web

Attiva questa skill ogni volta che devi cercare informazioni sul web, verificare un fatto, o estrarre contenuto da URL.

Strumenti disponibili

Hai tre motori di ricerca e un estrattore di contenuto:

Albero decisionale

Devo cercare qualcosa?
├── È una domanda rapida / lookup veloce?
│   └── ➜ web_search (Brave) — veloce, gratis, buoni snippet
│
├── Serve precisione, filtri avanzati, o una risposta sintetizzata?
│   └── ➜ tavily_search
│       • search_depth: "advanced" per massima rilevanza
│       • topic: "news" per notizie, "finance" per dati finanziari
│       • include_answer: true per avere una risposta AI sintetizzata
│       • time_range: "day"/"week"/"month" per risultati recenti
│       • include_domains / exclude_domains per filtrare le fonti
│
├── Ho un URL e voglio estrarne il contenuto?
│   ├── Pagina semplice / statica?
│   │   └── ➜ web_fetch (più leggero, nessun costo API extra)
│   └── Pagina JS-heavy, SPA, tabelle dinamiche?
│       └── ➜ tavily_extract
│           • extract_depth: "advanced" per contenuto dinamico
│           • query + chunks_per_source per estrarre solo le parti rilevanti
│
└── Serve una ricerca deep / multi-fonte / fact-checked?
    └── ➜ Usa la skill /deep-research (orchestrazione multi-agente)

Parametri chiave per tool

web_search (Brave — default)

query: "la domanda"          # obbligatorio
count: 5                     # risultati (1-10)
freshness: "week"            # day/week/month/year
country: "IT"                # filtro paese
language: "it"               # lingua risultati

tavily_search

query: "la domanda"          # obbligatorio, max 400 char
search_depth: "basic"        # "basic" (veloce) o "advanced" (preciso)
topic: "general"             # "general", "news", "finance"
max_results: 5               # 1-20
include_answer: true         # risposta AI sintetizzata
time_range: "week"           # day/week/month/year
include_domains: ["sito.com"] # solo da questi domini
exclude_domains: ["spam.com"] # escludi questi

tavily_extract

urls: ["https://..."]        # obbligatorio, max 20 URL per chiamata
query: "cosa cerco"          # ri-ordina i chunk per rilevanza
extract_depth: "basic"       # "basic" o "advanced" (per SPA/JS)
chunks_per_source: 3         # 1-5, richiede query
include_images: false        # include URL immagini

web_fetch

url: "https://..."           # obbligatorio
extractMode: "markdown"      # "markdown" o "text"
maxChars: 50000              # limite caratteri

Regole operative

1. Parti sempre da `web_search` per ricerche semplici — è il più veloce e non ha costi aggiuntivi (Brave ha credito mensile gratuito).
2. Scala a `tavily_search` quando servono filtri avanzati (topic, domini, profondità) o una risposta sintetizzata dall'AI.
3. Per estrarre contenuto da URL noti, preferisci web_fetch (gratis e leggero). Usa tavily_extract solo per pagine JS-heavy o quando serve query-focused chunking.
4. Mai fidarsi di un singolo risultato per fatti importanti — verifica con almeno due fonti o tool diversi.
5. Ricerche in italiano: passa language: "it" e country: "IT" per risultati localizzati.
6. Per ricerche finanziarie: usa tavily_search con topic: "finance".
7. Per notizie recenti: usa tavily_search con topic: "news" e time_range: "day" o "week".