No embeddings, no vector database, no API — solo Whisper + SQLite FTS5 in esecuzione sulla tua macchina.

> **Roadmap:** L'estrazione dei clip è il primo passo verso un montaggio video completamente guidato dall'IA. Le versioni future aggiungeranno sovrapposizione di musica/audio, remix video, compilazione multi-clip, riformattazione verticale per TikTok/Reels/Shorts e reel di highlights automatici — tutto guidato dalla comprensione del contenuto da parte del tuo LLM.

---

### Sottoscrizioni ai Feed Live
Abbonati a news, Reddit, Hacker News, canali YouTube, profili Twitter/X, repository GitHub, articoli arXiv e podcast. I contenuti vengono recuperati, archiviati localmente in SQLite con ricerca full-text e resi disponibili al tuo LLM all'istante.

| Nuovo Strumento | Cosa Fa |
|----------|-------------|
| `subscribe` | Aggiungi qualsiasi fonte — news RSS, Reddit, HN, GitHub, arXiv, YouTube, podcast, Twitter/X |
| `unsubscribe` | Rimuovi una sottoscrizione e i suoi contenuti archiviati |
| `list_subscriptions` | Vedi tutti i feed attivi con il conteggio degli elementi |
| `check_feeds` | Scansiona tutte le sottoscrizioni, recupera nuovi contenuti, trascrivi automaticamente i video di YouTube |
| `search_feeds` | Ricerca full-text in tutto ciò che i tuoi feed hanno raccolto |
| `get_feed_items` | Sfoglia elementi recenti, filtrati per fonte o tipo |

**Fonti di notizie preconfigurate** — abbonati con una sola parola: `bbc`, `cnn`, `nyt`, `guardian`, `npr`, `aljazeera`, `techcrunch`, `ars`, `verge`, `wired`, `reuters`

**Scorciatoie arXiv** — `ai`, `ml`, `cv`, `nlp`, `robotics`, `crypto`, `systems`, `hci````
"Subscribe to BBC News, r/LocalLLaMA, and Hacker News"
"Follow @elonmusk on Twitter"
"Subscribe to the YouTube channel @3Blue1Brown"
"Watch anthropics/claude-code on GitHub for new releases"
"Subscribe to the machine learning arXiv category"
"Check my feeds"
"Search my feeds for transformer architecture"
"What's new in my Reddit feeds?"

**Zero dipendenze extra per i feed.** Costruito interamente sulla stdlib di Python — SQLite per l'archiviazione, FTS5 per la ricerca, urllib per il recupero, xml.etree per il parsing. YouTube e Twitter utilizzano il browser Playwright esistente. FFmpeg richiesto per `convert_media` (solitamente preinstallato).

---

## Tutti i 38 strumenti per categoria

### Abbonamenti ai feed in diretta
| Tool | Descrizione |
|------|-------------|
| `subscribe` | Abbonati a notizie, Reddit, HN, GitHub, arXiv, YouTube, podcast, Twitter/X |
| `unsubscribe` | Rimuovi un abbonamento e il suo contenuto archiviato |
| `list_subscriptions` | Elenca tutti gli abbonamenti attivi con il conteggio degli elementi |
| `check_feeds` | Recupera nuovi contenuti da tutte o da fonti specifiche |
| `search_feeds` | Ricerca full-text in tutti i contenuti dei feed archiviati |
| `get_feed_items` | Ottieni elementi recenti filtrati per fonte o tipo |

### Ricerca Google & Web
| Tool | Descrizione |
|------|-------------|
| `google_search` | Ricerca web con filtri temporali, per sito, paginazione, lingua/regione |
| `google_news` | Ricerca notizie con anteprime degli articoli in linea |
| `google_scholar` | Articoli accademici con citazioni |
| `google_images` | Ricerca immagini con risultati visualizzati in linea nella chat |
| `google_trends` | Interesse per un argomento nel tempo, query correlate |
| `visit_page` | Recupera qualsiasi URL ed estrai testo leggibile |

### Viaggi & Commercio
| Tool | Descrizione |
|------|-------------|
| `google_shopping` | Ricerca prodotti con prezzi, negozi, valutazioni, immagini |
| `google_flights` | Ricerca voli con prezzi e tempi di viaggio |
| `google_hotels` | Ricerca hotel con immagini, prezzi, valutazioni, URL di prenotazione |
| `google_translate` | Traduzione in oltre 100 lingue |
| `google_maps` | Ricerca luoghi con valutazioni, recensioni e screenshot della mappa |
| `google_maps_directions` | Indicazioni stradali con passaggi dettagliati e screenshot della mappa |

### Finanza & Informazioni
| Tool | Descrizione |
|------|-------------|
| `google_finance` | Prezzi azionari, dati di mercato, informazioni aziendali |
| `google_weather` | Condizioni attuali e previsioni per più giorni |
| `google_books` | Ricerca libri con autore, ISBN, frammenti |

### Visione & OCR
| Tool | Descrizione |
|------|-------------|
| `google_lens` | Ricerca inversa per immagini — identifica oggetti, prodotti, luoghi, testo |
| `google_lens_detect` | Rileva tutti gli oggetti in un'immagine (OpenCV) e identifica ciascuno tramite Lens |
| `ocr_image` | Estrai testo dalle immagini localmente (RapidOCR, completamente offline) |
| `list_images` | Elenca i file immagine in una directory per usarli con gli strumenti di visione |

### Intelligenza Video & Audio — Montaggio Video AI
| Tool | Descrizione |
|------|-------------|
| `transcribe_video` | Scarica e trascrivi qualsiasi video con timestamp (faster-whisper) |
| `transcribe_local` | Trascrivi file audio/video locali (mp3, wav, m4a, mp4, mkv, ecc.) |
| `search_transcript` | Cerca in un video trascritto argomenti per parola chiave |
| `extract_video_clip` | Estrazione clip potenziata dall'AI — dì al LLM cosa vuoi e lui taglia il video usando il contesto della trascrizione |
| `convert_media` | Converti tra formati audio/video tramite FFmpeg |

### Documenti & Dati
| Tool | Descrizione |
|------|-------------|
| `read_document` | Estrai testo da PDF, DOCX, HTML, CSV, JSON e oltre 30 formati |

### Email
| Tool | Descrizione |
|------|-------------|
| `fetch_emails` | Recupera email via IMAP — Gmail, Outlook, Yahoo, iCloud, qualsiasi server IMAP |

### Utility Web
| Tool | Descrizione |
|------|-------------|
| `paste_text` | Invia testo a un pastebin e ottieni un URL condivisibile |
| `shorten_url` | Accorcia qualsiasi URL tramite TinyURL |
| `generate_qr` | Genera immagini di codici QR (URL, Wi-Fi, contatti, qualsiasi dato) |
| `archive_webpage` | Archivia una pagina web su Wayback Machine |
| `wikipedia` | Consultazione articoli Wikipedia in qualsiasi lingua |

### Cloud Storage
| Tool | Descrizione |
|------|-------------|
| `upload_to_s3` | Carica file su MinIO, AWS S3, DigitalOcean Spaces, Cloudflare R2, Backblaze B2 |

---

## Formati file supportati

### Documenti (`read_document`)
| Categoria | Formati |
|----------|---------|
| Documenti | PDF (con fallback OCR per pagine scansionate), DOCX |
| Web | HTML, HTM |
| Dati | CSV, JSON, XML, YAML, YML, TOML |
| Testo | TXT, MD, LOG |
| Config | INI, CFG, CONF, ENV |
| Codice | PY, JS, TS, GO, RS, C, CPP, H, JAVA, KT, RB, SQL, R, M, SWIFT |
| Shell | SH, BASH, ZSH |

### Audio & Video (`transcribe_local`, `transcribe_video`, `convert_media`)
| Categoria | Formati |
|----------|---------|
| Audio | MP3, WAV, M4A, FLAC, OGG, AAC, WMA, OPUS |
| Video | MP4, MKV, WEBM, AVI, MOV |
| Speciale | GIF (output video-to-GIF) |
| Input | Qualsiasi formato decodificabile da FFmpeg (centinaia di formati) |

### Immagini (`google_lens`, `google_lens_detect`, `ocr_image`, `list_images`)
| Categoria | Formati |
|----------|---------|
| Standard | JPG, JPEG, PNG, GIF, BMP, WEBP |
| Professionale | TIFF, TIF, SVG |
| Metodi di input | Percorso file locale, URL pubblico, base64 (drag-and-drop nella chat) |

---

## Perché questo invece delle alternative basate su API?

| | **noapi-google-search-mcp** | Server MCP basati su API | OpenClaw integrato |
|---|---|---|---|
| Chiave API richiesta | **No** | Sì (API Google CSE) | Sì (Brave/Perplexity) |
| Costo | **Gratuito** | A pagamento dopo 100 query/giorno | Costi API |
| Tempo di configurazione | **`pip install` + via** | Crea progetto Cloud, abilita API, configura | Più chiavi API |
| Qualità dei risultati | **Risultati Google reali** | Motore di ricerca personalizzato | Indice Brave |
| Pagine JavaScript | **Le renderizza (Chromium)** | Non può renderizzare JS | Non può renderizzare JS |
| Numero strumenti | **38** | 1-3 | 2 (web_search, web_fetch) |
| Ricerca Google | Integrata (con filtri) | Solo base | Non disponibile |
| Google Shopping | Integrato | Non disponibile | Non disponibile |
| Google Flights | Integrato | Non disponibile | Non disponibile |
| Google Hotels | Integrato | Non disponibile | Non disponibile |
| Google Translate | Integrato | API separata necessaria | Non disponibile |
| Google Maps | Integrato (con screenshot) | Non disponibile | Non disponibile |
| Google Maps Directions | Integrato (con mappa del percorso) | Non disponibile | Non disponibile |
| Google Weather | Integrato | Non disponibile | Non disponibile |
| Google Finance | Integrato | Non disponibile | Non disponibile |
| Google News | Integrato | Di solito non disponibile | Non disponibile |
| Google Scholar | Integrato | Non disponibile | Non disponibile |
| Google Books | Integrato | Non disponibile | Non disponibile |
| Google Images | Integrato (in linea nella chat) | API separata necessaria | Non disponibile |
| Google Lens | Integrato (ricerca inversa immagini) | Non disponibile | Non disponibile |
| Rilevamento oggetti | Integrato (OpenCV + Lens) | Non disponibile | Non disponibile |
| OCR locale | Integrato (offline) | Non disponibile | Non disponibile |
| Trascrizione video | Integrato (Whisper locale) | Non disponibile | Non disponibile |
| Estrazione clip video | **Integrato (potenziato da AI/LLM)** | Non disponibile | Non disponibile |
| Pipeline RAG YouTube | **Integrato (abbonati → trascrivi → cerca)** | Non disponibile | Non disponibile |
| Google Trends | Integrato | API separata necessaria | Non disponibile |
| Abbonamenti feed | **Integrato (8 tipi di fonte)** | Non disponibile | Non disponibile |
| Ricerca full-text feed | **Integrato (SQLite FTS5)** | Non disponibile | Non disponibile |
| Trascrizione automatica feed | **Integrato (YouTube → Whisper)** | Non disponibile | Non disponibile |
| Trascrizione file locali | **Integrato (qualsiasi audio/video)** | Non disponibile | Non disponibile |
| Conversione formati multimediali | **Integrato (FFmpeg)** | Non disponibile | Non disponibile |
| Lettore documenti | **Integrato (PDF, DOCX, ecc.)** | Non disponibile | Non disponibile |
| Integrazione email | **Integrato (IMAP)** | Non disponibile | Non disponibile |
| Pastebin | **Integrato** | Non disponibile | Non disponibile |
| Accorciatore URL | **Integrato (TinyURL)** | Non disponibile | Non disponibile |
| Generazione codici QR | **Integrato (OpenCV)** | Non disponibile | Non disponibile |
| Archiviazione web | **Integrato (Wayback Machine)** | Non disponibile | Non disponibile |
| Wikipedia | **Integrato** | Non disponibile | Non disponibile |
| Caricamento S3/MinIO | **Integrato** | Non disponibile | Non disponibile |
| Recupero pagine | Integrato | Di solito separato | Base |

---

## Dettagli e parametri degli strumenti

### Strumenti per l'abbonamento ai feed

#### `subscribe` — Aggiungi una fonte di contenuti

| Parametro | Descrizione | Esempio |
|-----------|-------------|---------|
| `source_type` | Tipo di fonte (obbligatorio) | `"news"`, `"reddit"`, `"hackernews"`, `"github"`, `"arxiv"`, `"youtube"`, `"podcast"`, `"twitter"` |
| `identifier` | Identificatore della fonte (obbligatorio) | `"bbc"`, `"LocalLLaMA"`, `"top"`, `"anthropics/claude-code"`, `"ml"`, `"@3Blue1Brown"`, `"https://..."`, `"elonmusk"` |
| `name` | Nome visualizzato (opzionale) | `"My Custom Feed"` |

**Formati identificatore per tipo:**
- **news:** nome predefinito (`bbc`, `cnn`, `nyt`, `guardian`, `npr`, `aljazeera`, `techcrunch`, `ars`, `verge`, `wired`, `reuters`) o qualsiasi URL RSS
- **reddit:** nome subreddit (es. `LocalLLaMA`, `programming`)
- **hackernews:** `top`, `new` o `best`
- **github:** `proprietario/repo` (es. `anthropics/claude-code`)
- **arxiv:** scorciatoia (`ai`, `ml`, `cv`, `nlp`, `robotics`, `crypto`) o categoria come `cs.AI`
- **youtube:** handle del canale (`@3Blue1Brown`), URL o ID canale (`UCxxxx`)
- **podcast:** URL feed RSS
- **twitter:** nome utente con o senza `@`

#### `check_feeds` — Recupera nuovi contenuti

| Parametro | Descrizione | Esempio |
|-----------|-------------|---------|
| `source_type` | Limita a un tipo (opzionale) | `"news"`, `"reddit"` |

#### `search_feeds` — Ricerca full-text

| Parametro | Descrizione | Esempio |
|-----------|-------------|---------|
| `query` | Query di ricerca (obbligatoria) — supporta FTS5: AND, OR, NOT, "frasi tra virgolette" | `"machine learning"`, `"GPU NOT NVIDIA"` |
| `source_type` | Limita a un tipo (opzionale) | `"news"` |
| `limit` | Massimo risultati (default 20) | `10` |

#### `get_feed_items` — Sfoglia elementi recenti

| Parametro | Descrizione | Esempio |
|-----------|-------------|---------|
| `source` | Filtra per nome fonte (opzionale) | `"BBC"`, `"LocalLLaMA"` |
| `source_type` | Filtra per tipo (opzionale) | `"reddit"`, `"hackernews"` |
| `limit` | Massimo elementi (default 20) | `10` |

---

### Strumenti di Ricerca Google

#### `google_search` — Ricerca web

| Parametro | Descrizione | Esempio |
|-----------|-------------|---------|
| `query` | Query di ricerca (obbligatoria) | `"best python frameworks 2025"` |
| `num_results` | Numero di risultati (1-10, default 5) | `5` |
| `time_range` | Filtra per recentità | `"past_hour"`, `"past_day"`, `"past_week"`, `"past_month"`, `"past_year"` |
| `site` | Limita a un dominio | `"reddit.com"`, `"stackoverflow.com"`, `"github.com"` |
| `page` | Pagina dei risultati (1-10, default 1) | `2` |
| `language` | Codice lingua | `"en"`, `"de"`, `"fr"`, `"ja"` |
| `region` | Codice paese/regione | `"us"`, `"gb"`, `"de"`, `"jp"` |

#### `google_shopping` — Ricerca prodotti

| Parametro | Descrizione | Esempio |
|-----------|-------------|---------|
| `query` | Query di ricerca prodotti (obbligatoria) | `"Sony WH-1000XM5"` |
| `num_results` | Numero di risultati (1-10, default 5) | `5` |

#### `google_flights` — Ricerca voli

| Parametro | Descrizione | Esempio |
|-----------|-------------|---------|
| `origin` | Città o aeroporto di partenza (obbligatorio) | `"New York"`, `"LAX"` |
| `destination` | Città o aeroporto di arrivo (obbligatorio) | `"London"`, `"NRT"` |
| `date` | Data di partenza (opzionale) | `"March 15"` |
| `return_date` | Data di ritorno (opzionale) | `"March 22"` |

![Google Flights](https://assets.kitploit.com/production/public/readmes/11628/67fb0af7e11f84e8b9504bbe7059412222ac9ae30c6d58d025d7231b8ba71847.png)

#### `google_hotels` — Ricerca hotel

| Parametro | Descrizione | Esempio |
|-----------|-------------|---------|
| `query` | Ricerca hotel con località (obbligatoria) | `"Paris"`, `"Tokyo near Shibuya"` |
| `num_results` | Numero di risultati (1-10, default 5) | `5` |

![Google Hotels](https://assets.kitploit.com/production/public/readmes/11628/53a7c43d352a8f2fd9b23b088e7630504018f1b12b27347bdf1f1f6b58b81f89.png)

#### `google_translate` — Traduzione

| Parametro | Descrizione | Esempio |
|-----------|-------------|---------|
| `text` | Testo da tradurre (obbligatorio) | `"Hello, how are you?"` |
| `to_language` | Lingua di destinazione (obbligatoria) | `"Spanish"`, `"Japanese"` |
| `from_language` | Lingua di partenza (opzionale, rilevata automaticamente) | `"English"` |

#### `google_maps` — Ricerca luoghi con screenshot della mappa

| Parametro | Descrizione | Esempio |
|-----------|-------------|---------|
| `query` | Query di ricerca luoghi (obbligatoria) | `"pizza near Central Park"` |
| `num_results` | Numero di risultati (1-10, default 5) | `5` |

![Google Maps Places Search](https://assets.kitploit.com/production/public/readmes/11628/39e5dd84bee338e82944175aedc0097d3cc8d44d46937f90d43663013ec5c3aa.png)

#### `google_maps_directions` — Indicazioni stradali con mappa

| Parametro | Descrizione | Esempio |
|-----------|-------------|---------|
| `origin` | Località di partenza (obbligatoria) | `"Berlin"` |
| `destination` | Località di arrivo (obbligatoria) | `"Munich"` |
| `mode` | Mezzo di trasporto (default "driving") | `"driving"`, `"walking"`, `"transit"`, `"cycling"` |

![Google Maps Directions](https://assets.kitploit.com/production/public/readmes/11628/ef5c209452381347f03f6466093f97f7f22371bf6b8a1fd21f5c6277f94bc98d.png)

#### `google_weather` — Meteo

| Parametro | Descrizione | Esempio |
|-----------|-------------|---------|
| `location` | Città o località (obbligatoria) | `"Dubai"`, `"Tokyo"` |

#### `google_finance` — Dati azionari e di mercato

| Parametro | Descrizione | Esempio |
|-----------|-------------|---------|
| `query` | Ticker azionario o nome azienda (obbligatorio) | `"AAPL:NASDAQ"`, `"TSLA:NASDAQ"` |

![Google Finance](https://assets.kitploit.com/production/public/readmes/11628/6544467f145bd3721837fe07ebdc54fb6f18c0e16f7b92d3f2dc2a9ecd658946.png)

#### `google_news` — Ricerca notizie

| Parametro | Descrizione | Esempio |
|-----------|-------------|---------|
| `query` | Query di ricerca notizie (obbligatoria) | `"AI regulation"` |
| `num_results` | Numero di risultati (1-10, default 5) | `5` |

![Google News](https://assets.kitploit.com/production/public/readmes/11628/701222704b96a31e1bbdc17d02faea223a3c5f8c0fafe40f801d2bbf162769ae.png)

#### `google_scholar` — Ricerca accademica

| Parametro | Descrizione | Esempio |
|-----------|-------------|---------|
| `query` | Query di ricerca accademica (obbligatoria) | `"transformer attention mechanism"` |
| `num_results` | Numero di risultati (1-10, default 5) | `5` |

#### `google_books` — Ricerca libri

| Parametro | Descrizione | Esempio |
|-----------|-------------|---------|
| `query` | Query di ricerca libri (obbligatoria) | `"machine learning"` |
| `num_results` | Numero di risultati (1-10, default 5) | `5` |

#### `google_images` — Ricerca immagini (in linea nella chat)

| Parametro | Descrizione | Esempio |
|-----------|-------------|---------|
| `query` | Query di ricerca immagini (obbligatoria) | `"sunset over ocean"` |
| `num_results` | Numero di risultati (1-10, default 5) | `5` |

![Google Image Search](https://assets.kitploit.com/production/public/readmes/11628/a47d9623012e545b5ec8abbba297822a6cc981a11e3d1a0e5c1548582080aac2.png)

![Google Image Search](https://assets.kitploit.com/production/public/readmes/11628/56ce17724c1807a61362bdbd3d87e0ad510c049f50b49d17050ea08f59d23051.png)

#### `google_trends` — Tendenze

| Parametro | Descrizione | Esempio |
|-----------|-------------|---------|
| `query` | Argomento (obbligatorio) | `"artificial intelligence"` |

---

### Strumenti di Visione & OCR

#### `google_lens` — Ricerca inversa per immagini

Identifica oggetti, prodotti, marchi, luoghi e testo. Supporta URL, file locali e base64 drag-and-drop.

| Parametro | Descrizione | Esempio |
|-----------|-------------|---------|
| `image_source` | URL dell'immagine, percorso file o base64 (obbligatorio) | `"https://example.com/photo.jpg"` o `"/home/user/image.jpg"` |

![Google Lens Reverse Image Search](https://assets.kitploit.com/production/public/readmes/11628/6b741134ecd8334640efe8b8348169be84471943f64bd367479455510bca6e97.png)

#### `google_lens_detect` — Rilevamento + Identificazione oggetti

Rileva tutti gli oggetti (OpenCV), ritaglia ciascuno, identifica individualmente tramite Lens.

| Parametro | Descrizione | Esempio |
|-----------|-------------|---------|
| `image_source` | Percorso file locale o base64 (obbligatorio) | `"/home/user/photo.jpg"` |

#### `ocr_image` — OCR locale (offline)

Estrai testo dalle immagini usando RapidOCR. Nessuna connessione internet necessaria.

| Parametro | Descrizione | Esempio |
|-----------|-------------|---------|
| `image_source` | Percorso file locale o base64 (obbligatorio) | `"/home/user/screenshot.png"` |

![Local OCR](https://assets.kitploit.com/production/public/readmes/11628/f9c9a531abd64ce577d3cf9990b8187063828f83762a2e2ac2aaa5a232b21eb7.png)

#### `list_images` — Scoperta immagini

| Parametro | Descrizione | Esempio |
|-----------|-------------|---------|
| `directory` | Cartella da analizzare (default `~/lens/`) | `"/home/user/photos"` |

---

### Strumenti di Intelligenza Video

#### `transcribe_video` — Trascrizione video

Scarica e trascrivi qualsiasi video YouTube (o URL video) con timestamp usando faster-whisper.

| Parametro | Descrizione | Esempio |
|-----------|-------------|---------|
| `url` | URL YouTube o video (obbligatorio) | `"https://youtube.com/watch?v=..."` |
| `model_size` | Dimensione modello Whisper (default: tiny) | `"tiny"`, `"base"`, `"small"`, `"medium"`, `"large"` |
| `language` | Codice lingua (opzionale, rilevata automaticamente) | `"en"` |

#### `search_transcript` — Ricerca trascrizione

| Parametro | Descrizione | Esempio |
|-----------|-------------|---------|
| `url` | Stesso URL usato con transcribe_video (obbligatorio) | `"https://youtube.com/watch?v=..."` |
| `query` | Parola chiave o frase (obbligatoria) | `"memory bandwidth"` |
| `context_segments` | Segmenti circostanti (default: 2) | `3` |

#### `extract_video_clip` — Estrazione clip per argomento

Chiedi "estrai la parte su X" e il LLM trova i timestamp dalla trascrizione e taglia il clip.

| Parametro | Descrizione | Esempio |
|-----------|-------------|---------|
| `url` | URL YouTube o video locale (obbligatorio) | `"https://youtube.com/watch?v=..."` |
| `start_seconds` | Ora di inizio in secondi (obbligatoria) | `150` |
| `end_seconds` | Ora di fine in secondi (obbligatoria) | `315` |
| `buffer_seconds` | Secondi extra prima/dopo (default: 3) | `5.0` |
| `output_filename` | Nome file personalizzato (opzionale) | `"hardware_overview"` |

---

## Prompt di esempio

### Abbonamenti ai feed
| Cosa scrivi | Tool chiamato |
|--------------|-------------|
| *"Abbonati a BBC News e CNN"* | `subscribe` |
| *"Segui r/LocalLLaMA su Reddit"* | `subscribe` |
| *"Monitora le storie migliori di Hacker News"* | `subscribe` |
| *"Osserva anthropics/claude-code per nuovi rilasci"* | `subscribe` |
| *"Abbonati a @3Blue1Brown su YouTube"* | `subscribe` |
| *"Segui @elonmusk su Twitter"* | `subscribe` |
| *"Abbonati alla categoria arXiv ML"* | `subscribe` |
| *"Controlla i miei feed"* | `check_feeds` |
| *"Cosa c'è di nuovo nei miei abbonamenti?"* | `check_feeds` |
| *"Cerca nei miei feed 'transformer architecture'"* | `search_feeds` |
| *"Mostrami gli ultimi post di Reddit"* | `get_feed_items` |
| *"Quali sono i miei abbonamenti?"* | `list_subscriptions` |
| *"Disiscriviti da BBC News"* | `unsubscribe` |

### Ricerca Web
| Cosa scrivi | Tool chiamato | Parametri usati |
|--------------|-------------|-----------------|
| *"Cerca i migliori framework web Python"* | `google_search` | `query` |
| *"Trova discussioni Reddit su configurazioni home lab"* | `google_search` | `query` + `site="reddit.com"` |
| *"Cerca su Stack Overflow esempi async Python"* | `google_search` | `query` + `site="stackoverflow.com"` |
| *"Cosa c'è di nuovo nell'AI questa settimana?"* | `google_search` | `query` + `time_range="past_week"` |
| *"Cerca su Hacker News post su Rust"* | `google_search` | `query` + `site="news.ycombinator.com"` |
| *"Ottieni la pagina 2 dei risultati per tutorial ML"* | `google_search` | `query` + `page=2` |
| *"Cerca ristoranti a Tokyo in giapponese"* | `google_search` | `query` + `language="ja"` + `region="jp"` |

### Shopping & Viaggi
| Cosa scrivi | Tool chiamato |
|--------------|-------------|
| *"Trova il MacBook Air più economico"* | `google_shopping` |
| *"Trova voli da New York a Londra"* | `google_flights` |
| *"Trova hotel a Parigi per il prossimo weekend"* | `google_hotels` |
| *"Traduci 'hello world' in giapponese"* | `google_translate` |

### Mappe e Indicazioni
| Cosa scrivi | Tool chiamato |
|--------------|-------------|
| *"Trova ristoranti italiani vicino a Times Square"* | `google_maps` |
| *"Ottieni indicazioni da Berlino a Monaco"* | `google_maps_directions` |
| *"Indicazioni a piedi dalla Torre Eiffel al Louvre"* | `google_maps_directions` |

### Finanza, Meteo e Informazioni
| Cosa scrivi | Tool chiamato |
|--------------|-------------|
| *"Qual è il prezzo delle azioni Apple?"* | `google_finance` |
| *"Com'è il meteo a Dubai?"* | `google_weather` |
| *"Quali sono le prime notizie di oggi?"* | `google_news` |
| *"Trova articoli sui meccanismi di attenzione dei transformer"* | `google_scholar` |
| *"Trova libri sul machine learning"* | `google_books` |### Immagini e Visione
| Cosa scrivi | Strumento chiamato |
|--------------|-------------|
| *"Mostrami immagini dell'Aurora Boreale"* | `google_images` |
| *"Cos'è questo prodotto? /path/to/photo.jpg"* | `google_lens` |
| *"Rileva tutti gli oggetti in questa foto"* | `google_lens_detect` |
| *"Leggi il testo in questo screenshot"* | `ocr_image` |
| Trascina un'immagine nella chat + *"Cos'è questo?"* | `google_lens` |
| Trascina un'immagine nella chat + *"Leggi il testo"* | `ocr_image` |

> **Suggerimento:** Per abilitare il trascinamento di immagini con modelli solo testo in LM Studio, aggiungi un file `model.yaml` nella directory del modello con `metadataOverrides: { vision: true }`. L'immagine verrà inviata come base64 e gli strumenti MCP la gestiranno automaticamente.

### Intelligenza Video & Estrazione Clip Potenziata dall'IA
| Cosa scrivi | Strumento chiamato |
|--------------|-------------|
| *"Trascrivi questo video: https://youtube.com/watch?v=..."* | `transcribe_video` |
| *"Di cosa parlano in questo video?"* | `transcribe_video` |
| *"Trova dove parlano di larghezza di banda della memoria"* | `search_transcript` |
| *"Estrai la parte in cui discutono dei prezzi"* | `extract_video_clip` |
| *"Taglia un clip della sezione di confronto hardware"* | `extract_video_clip` |
| *"Trascrivi ~/meeting.mp3"* | `transcribe_local` |
| *"Converti video.mp4 in mp3"* | `convert_media` |
| *"Converti questo video in GIF"* | `convert_media` |

### Documenti e Email
| Cosa scrivi | Strumento chiamato |
|--------------|-------------|
| *"Leggi questo PDF: ~/report.pdf"* | `read_document` |
| *"Estrai testo da ~/contract.docx"* | `read_document` |
| *"Leggi questo articolo per me: https://..."* | `visit_page` |
| *"Controlla la mia email a [email protected] password: xxxx"* | `fetch_emails` |
| *"Prendi le ultime 10 email da Outlook"* | `fetch_emails` |

### Utility Web e Cloud
| Cosa scrivi | Strumento chiamato |
|--------------|-------------|
| *"Accorcia questo URL: https://very-long-url..."* | `shorten_url` |
| *"Genera un codice QR per https://mysite.com"* | `generate_qr` |
| *"Crea un codice QR per la mia rete Wi-Fi"* | `generate_qr` |
| *"Incolla questo codice su un pastebin"* | `paste_text` |
| *"Archivia questo articolo: https://news.example.com/story"* | `archive_webpage` |
| *"Wikipedia: quantum computing"* | `wikipedia` |
| *"Cerca la missione Apollo 11 su Wikipedia in tedesco"* | `wikipedia` |
| *"Carica report.pdf nel mio bucket MinIO"* | `upload_to_s3` |
| *"Archivia backup.tar.gz nel bucket S3 my-backups"* | `upload_to_s3` |

---

## Installazione

### Installazione Rapida (pipx - raccomandato)```bash
pipx install noapi-google-search-mcp
playwright install chromium

### Python 3.13 / OCR

Il pacchetto principale si installa su ogni Python supportato, incluso 3.13. L'OCR è opzionale perché `rapidocr-onnxruntime` non ha ancora rilasciato una wheel per Python 3.13 upstream ([RapidAI/RapidOCR#579](https://github.com/RapidAI/RapidOCR/issues/579)). Tutto tranne gli strumenti OCR (`ocr_image` e il fallback per PDF scansionati in `read_document`) funziona senza di esso.

Per abilitare l'OCR, aggiungi l'extra `[ocr]` su un Python compatibile (3.10–3.12):```bash
pipx install "noapi-google-search-mcp[ocr]"

Se installato in un venv, usa il percorso completo: `~/.local/share/noapi-google-search-mcp/bin/noapi-google-search-mcp`

### Claude Desktop

Aggiungi alla tua configurazione di Claude Desktop (`claude_desktop_config.json`):```json
{
  "mcpServers": {
    "google-search": {
      "command": "noapi-google-search-mcp"
    }
  }
}

Questo dà al tuo agente OpenClaw accesso a tutti i 38 strumenti — real Google search, live feeds, vision, OCR, e video intelligence — con zero API keys.

### As a CLI```bash
noapi-google-search-mcp

## Sviluppo```bash
git clone https://github.com/VincentKaufmann/noapi-google-search-mcp.git
cd google-search-mcp
pip install -e .
playwright install chromium