Skip to Content
TecnicaAiConfigurazione Tavily Search API e Serper Image Search

Configurazione Tavily Search API e Serper Image Search

Funzionalità Ricerca Manuali e Immagini Online

La funzionalità di ricerca per le attrezzature utilizza:

  • Tavily Search API per trovare manuali e documentazione
  • Serper Image Search API per trovare immagini dei prodotti

Vantaggi

Tavily (Manuali)

  • ✅ Link Verificati: Solo risultati che esistono realmente
  • ✅ Ottimizzata per AI: Progettata specificamente per applicazioni AI
  • ✅ Filtraggio Intelligente: Prioritizza PDF e pagine di supporto tecnico
  • ✅ Economica: Piano gratuito con 1000 ricerche/mese
  • ✅ Veloce: Risposte in ~1-2 secondi

Serper (Immagini)

  • ✅ Ricerca Immagini Google: Usa l’API ufficiale di Google
  • ✅ Alta Qualità: Risultati pertinenti e ad alta risoluzione
  • ✅ Economica: $5 per 1000 ricerche (più economica di Google Custom Search)
  • ✅ Veloce: Risposte istantanee
  • ✅ Semplice: Nessuna configurazione Custom Search Engine

Setup

1. Tavily (Ricerca Manuali)

Crea Account

  1. Vai su https://tavily.com 
  2. Clicca su “Get API Key” o “Sign Up”
  3. Registrati con email e verifica

Ottieni API Key

  1. Accedi alla dashboard
  2. Copia la tua API key (inizia con tvly-...)

2. Serper (Ricerca Immagini)

Crea Account

  1. Vai su https://serper.dev 
  2. Clicca su “Sign Up” o “Get API Key”
  3. Registrati con email o Google

Ottieni API Key

  1. Accedi alla dashboard
  2. Vai su “API Keys”
  3. Copia la tua API key

3. Configura Variabili d’Ambiente

Aggiungi al tuo file .env.local:

# Ricerca Manuali
TAVILY_API_KEY=tvly-your-api-key-here
 
# Ricerca Immagini
SERPER_API_KEY=your-serper-api-key-here

4. Riavvia il Server

npm run dev

Utilizzo

Una volta configurato:

Ricerca Manuali

  1. Vai nella pagina di dettaglio di un’attrezzatura
  2. Clicca sulla tab “Documenti”
  3. Clicca “Cerca Manuali Online”
  4. L’AI effettuerà una ricerca reale e mostrerà:
    • PDF Diretti: Manuali PDF scaricabili (evidenziati in rosso)
    • Pagine di Supporto: Link a pagine che contengono il manuale
    • Query Google: Ricerche ottimizzate come fallback

Ricerca Immagini

  1. Vai nella pagina di dettaglio di un’attrezzatura
  2. Nella sezione “Immagine” (sidebar), clicca “Cerca”
  3. Verranno mostrate fino a 10 immagini dal web
  4. Clicca su un’immagine per salvarla come foto del prodotto
  5. L’immagine verrà visualizzata nella pagina

Fallback Senza API Key

Senza Tavily: Il sistema fornisce query di ricerca ottimizzate per Google

Senza Serper: Il pulsante “Cerca” mostra un avviso per configurare l’API

Prezzi

Tavily

  • Free Tier: 1000 ricerche/mese - GRATIS
  • Basic: $100/mese - 10,000 ricerche
  • Pro: $300/mese - 50,000 ricerche

Serper

  • Pay-as-you-go: $5 per 1000 ricerche (minimo $5)
  • Pro: $50/mese - 10,000 ricerche incluse
  • Credito iniziale di $5 per testare

Nota: Per la maggior parte degli utilizzi, il free tier di Tavily + credito iniziale Serper sono sufficienti.

Alternative

Se preferisci altre soluzioni:

Google Custom Search API

  • Gratis fino a 100 ricerche/giorno
  • Richiede configurazione Custom Search Engine
  • Più complessa da configurare

Brave Search API

  • $5/1000 ricerche
  • Focalizzata sulla privacy
  • Buoni risultati ma meno ottimizzata per AI

SerpAPI

  • $50/mese per 5000 ricerche
  • Molto affidabile
  • Più costosa per utilizzo base

Raccomandazione: Tavily è la scelta migliore per questo caso d’uso.

Supporto

Per problemi con Tavily:

Last updated on
Generazione Ricetta con AI per Prodotti FinitiAutenticazione a Due Fattori (2FA)