Sem embeddings, sem banco de dados vetorial, sem API — apenas Whisper + SQLite FTS5 rodando na sua máquina.

> **Roteiro:** A extração de clipes é o primeiro passo para a edição de vídeo totalmente orientada por IA. Versões futuras adicionarão sobreposição de música/áudio, remix de vídeo, compilação de múltiplos clipes, reformatação vertical para TikTok/Reels/Shorts e resumos automáticos de destaques — tudo impulsionado pela sua LLM entender o conteúdo.

---

### Assinaturas de Feeds ao Vivo
Inscreva-se em notícias, Reddit, Hacker News, canais do YouTube, perfis do Twitter/X, repositórios do GitHub, artigos do arXiv e podcasts. O conteúdo é buscado, armazenado localmente no SQLite com pesquisa de texto completo e disponível para sua LLM instantaneamente.

| Nova Ferramenta | O Que Faz |
|----------|-------------|
| `subscribe` | Adicionar qualquer fonte — RSS de notícias, Reddit, HN, GitHub, arXiv, YouTube, podcasts, Twitter/X |
| `unsubscribe` | Remover uma assinatura e seu conteúdo armazenado |
| `list_subscriptions` | Ver todos os feeds ativos com contagens de itens |
| `check_feeds` | Consultar todas as assinaturas, buscar novo conteúdo, transcrever automaticamente vídeos do YouTube |
| `search_feeds` | Pesquisa de texto completo em tudo que seus feeds coletaram |
| `get_feed_items` | Navegar por itens recentes, filtrados por fonte ou tipo |

**Fontes de notícias pré-configuradas** — inscreva-se com uma palavra: `bbc`, `cnn`, `nyt`, `guardian`, `npr`, `aljazeera`, `techcrunch`, `ars`, `verge`, `wired`, `reuters`

**Atalhos do 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 dependências extras para feeds.** Construído inteiramente com a stdlib do Python — SQLite para armazenamento, FTS5 para busca, urllib para busca, xml.etree para análise. YouTube e Twitter usam o navegador Playwright existente. FFmpeg necessário para `convert_media` (comumente pré-instalado).

---

## Todas as 38 Ferramentas por Categoria

### Assinaturas de Feed ao Vivo
| Ferramenta | Descrição |
|------|-------------|
| `subscribe` | Inscrever-se em notícias, Reddit, HN, GitHub, arXiv, YouTube, podcasts, Twitter/X |
| `unsubscribe` | Remover uma assinatura e seu conteúdo armazenado |
| `list_subscriptions` | Listar todas as assinaturas ativas com contagem de itens |
| `check_feeds` | Buscar novo conteúdo de todas ou fontes específicas |
| `search_feeds` | Busca de texto completo em todo o conteúdo de feed armazenado |
| `get_feed_items` | Obter itens recentes filtrados por fonte ou tipo |

### Google Search & Web
| Ferramenta | Descrição |
|------|-------------|
| `google_search` | Pesquisa na web com filtros de tempo, filtros de site, paginação, idioma/região |
| `google_news` | Pesquisa de notícias com miniaturas de artigos embutidas |
| `google_scholar` | Artigos acadêmicos com citações |
| `google_images` | Pesquisa de imagens com resultados exibidos embutidos no chat |
| `google_trends` | Interesse no tópico ao longo do tempo, consultas relacionadas |
| `visit_page` | Buscar qualquer URL e extrair texto legível |

### Viagens & Comércio
| Ferramenta | Descrição |
|------|-------------|
| `google_shopping` | Pesquisa de produtos com preços, lojas, avaliações, imagens |
| `google_flights` | Pesquisa de voos com preços e horários de viagem |
| `google_hotels` | Pesquisa de hotéis com imagens, preços, avaliações, URLs de reserva |
| `google_translate` | Tradução em mais de 100 idiomas |
| `google_maps` | Pesquisa de lugares com avaliações, comentários e capturas de tela do mapa |
| `google_maps_directions` | Rotas com instruções passo a passo e captura de tela do mapa |

### Finanças & Informações
| Ferramenta | Descrição |
|------|-------------|
| `google_finance` | Preços de ações, dados de mercado, informações da empresa |
| `google_weather` | Condições atuais e previsão de vários dias |
| `google_books` | Pesquisa de livros com autor, ISBN, trechos |

### Visão & OCR
| Ferramenta | Descrição |
|------|-------------|
| `google_lens` | Pesquisa reversa de imagens — identificar objetos, produtos, marcos, texto |
| `google_lens_detect` | Detectar todos os objetos em uma imagem (OpenCV) e identificar cada um via Lens |
| `ocr_image` | Extrair texto de imagens localmente (RapidOCR, totalmente offline) |
| `list_images` | Listar arquivos de imagem em um diretório para uso com ferramentas de visão |

### Inteligência de Vídeo & Áudio — Edição de Vídeo com IA
| Ferramenta | Descrição |
|------|-------------|
| `transcribe_video` | Baixar e transcrever qualquer vídeo com timestamps (faster-whisper) |
| `transcribe_local` | Transcrever arquivos de áudio/vídeo locais (mp3, wav, m4a, mp4, mkv, etc.) |
| `search_transcript` | Pesquisar em um vídeo transcrito por tópicos via palavra-chave |
| `extract_video_clip` | Extração de clipes com IA — diga ao LLM o que você quer e ele corta o vídeo usando o contexto da transcrição |
| `convert_media` | Converter entre formatos de áudio/vídeo via FFmpeg |

### Documentos & Dados
| Ferramenta | Descrição |
|------|-------------|
| `read_document` | Extrair texto de PDF, DOCX, HTML, CSV, JSON e mais de 30 formatos |

### E-mail
| Ferramenta | Descrição |
|------|-------------|
| `fetch_emails` | Puxar e-mails via IMAP — Gmail, Outlook, Yahoo, iCloud, qualquer servidor IMAP |

### Utilitários da Web
| Ferramenta | Descrição |
|------|-------------|
| `paste_text` | Postar texto em um pastebin e obter um URL compartilhável |
| `shorten_url` | Encurtar qualquer URL via TinyURL |
| `generate_qr` | Gerar imagens de QR code (URLs, Wi-Fi, contatos, qualquer dado) |
| `archive_webpage` | Arquivar uma página web no Wayback Machine |
| `wikipedia` | Consulta de artigo da Wikipedia em qualquer idioma |

### Armazenamento na Nuvem
| Ferramenta | Descrição |
|------|-------------|
| `upload_to_s3` | Enviar arquivos para MinIO, AWS S3, DigitalOcean Spaces, Cloudflare R2, Backblaze B2 |

---

## Formatos de Arquivo Suportados

### Documentos (`read_document`)
| Categoria | Formatos |
|----------|---------|
| Documentos | PDF (com fallback de OCR para páginas escaneadas), DOCX |
| Web | HTML, HTM |
| Dados | CSV, JSON, XML, YAML, YML, TOML |
| Texto | TXT, MD, LOG |
| Config | INI, CFG, CONF, ENV |
| Código | PY, JS, TS, GO, RS, C, CPP, H, JAVA, KT, RB, SQL, R, M, SWIFT |
| Shell | SH, BASH, ZSH |

### Áudio & Vídeo (`transcribe_local`, `transcribe_video`, `convert_media`)
| Categoria | Formatos |
|----------|---------|
| Áudio | MP3, WAV, M4A, FLAC, OGG, AAC, WMA, OPUS |
| Vídeo | MP4, MKV, WEBM, AVI, MOV |
| Especial | GIF (saída de vídeo-para-GIF) |
| Entrada | Qualquer formato que o FFmpeg possa decodificar (centenas de formatos) |

### Imagens (`google_lens`, `google_lens_detect`, `ocr_image`, `list_images`)
| Categoria | Formatos |
|----------|---------|
| Padrão | JPG, JPEG, PNG, GIF, BMP, WEBP |
| Profissional | TIFF, TIF, SVG |
| Métodos de entrada | Caminho de arquivo local, URL público, base64 (arrastar e soltar no chat) |

---

## Por que Isso em Vez de Alternativas Baseadas em API?

| | **noapi-google-search-mcp** | Servidores MCP baseados em API | OpenClaw integrado |
|---|---|---|---|
| Chave de API necessária | **Não** | Sim (API Google CSE) | Sim (Brave/Perplexity) |
| Custo | **Grátis** | Pago após 100 consultas/dia | Taxas de API |
| Tempo de configuração | **`pip install` + pronto** | Criar projeto Cloud, ativar API, configurar | Múltiplas chaves de API |
| Qualidade dos resultados | **Resultados reais do Google** | Mecanismo de Busca Personalizado | Índice Brave |
| Páginas JavaScript | **Renderiza (Chromium)** | Não renderiza JS | Não renderiza JS |
| Quantidade de ferramentas | **38** | 1-3 | 2 (web_search, web_fetch) |
| Google Search | Integrado (com filtros) | Apenas básico | Não disponível |
| Google Shopping | Integrado | Não disponível | Não disponível |
| Google Flights | Integrado | Não disponível | Não disponível |
| Google Hotels | Integrado | Não disponível | Não disponível |
| Google Translate | Integrado | API separada necessária | Não disponível |
| Google Maps | Integrado (com capturas de tela) | Não disponível | Não disponível |
| Google Maps Directions | Integrado (com mapa de rota) | Não disponível | Não disponível |
| Google Weather | Integrado | Não disponível | Não disponível |
| Google Finance | Integrado | Não disponível | Não disponível |
| Google News | Integrado | Geralmente não disponível | Não disponível |
| Google Scholar | Integrado | Não disponível | Não disponível |
| Google Books | Integrado | Não disponível | Não disponível |
| Google Images | Integrado (embutido no chat) | API separada necessária | Não disponível |
| Google Lens | Integrado (pesquisa reversa de imagens) | Não disponível | Não disponível |
| Detecção de objetos | Integrado (OpenCV + Lens) | Não disponível | Não disponível |
| OCR local | Integrado (offline) | Não disponível | Não disponível |
| Transcrição de vídeo | Integrado (Whisper local) | Não disponível | Não disponível |
| Extração de clipes de vídeo | **Integrado (com IA/LLM)** | Não disponível | Não disponível |
| Pipeline RAG do YouTube | **Integrado (inscrever-se → transcrever → pesquisar)** | Não disponível | Não disponível |
| Google Trends | Integrado | API separada necessária | Não disponível |
| Assinaturas de feed | **Integrado (8 tipos de fonte)** | Não disponível | Não disponível |
| Busca de texto completo em feeds | **Integrado (SQLite FTS5)** | Não disponível | Não disponível |
| Transcrição automática de feeds | **Integrado (YouTube → Whisper)** | Não disponível | Não disponível |
| Transcrição de arquivo local | **Integrado (qualquer áudio/vídeo)** | Não disponível | Não disponível |
| Conversão de formato de mídia | **Integrado (FFmpeg)** | Não disponível | Não disponível |
| Leitor de documentos | **Integrado (PDF, DOCX, etc.)** | Não disponível | Não disponível |
| Integração de e-mail | **Integrado (IMAP)** | Não disponível | Não disponível |
| Pastebin | **Integrado** | Não disponível | Não disponível |
| Encurtador de URL | **Integrado (TinyURL)** | Não disponível | Não disponível |
| Geração de QR code | **Integrado (OpenCV)** | Não disponível | Não disponível |
| Arquivamento web | **Integrado (Wayback Machine)** | Não disponível | Não disponível |
| Wikipedia | **Integrado** | Não disponível | Não disponível |
| Upload para S3/MinIO | **Integrado** | Não disponível | Não disponível |
| Busca de páginas | Integrado | Geralmente separado | Básico |

---

## Detalhes das Ferramentas e Parâmetros

### Ferramentas de Assinatura de Feed

#### `subscribe` — Adicionar uma Fonte de Conteúdo

| Parâmetro | Descrição | Exemplo |
|-----------|-------------|---------|
| `source_type` | Tipo de fonte (obrigatório) | `"news"`, `"reddit"`, `"hackernews"`, `"github"`, `"arxiv"`, `"youtube"`, `"podcast"`, `"twitter"` |
| `identifier` | Identificador da fonte (obrigatório) | `"bbc"`, `"LocalLLaMA"`, `"top"`, `"anthropics/claude-code"`, `"ml"`, `"@3Blue1Brown"`, `"https://..."`, `"elonmusk"` |
| `name` | Nome de exibição (opcional) | `"My Custom Feed"` |

**Formatos de identificador por tipo:**
- **news:** nome predefinido (`bbc`, `cnn`, `nyt`, `guardian`, `npr`, `aljazeera`, `techcrunch`, `ars`, `verge`, `wired`, `reuters`) ou qualquer URL RSS
- **reddit:** nome do subreddit (ex.: `LocalLLaMA`, `programming`)
- **hackernews:** `top`, `new` ou `best`
- **github:** `owner/repo` (ex.: `anthropics/claude-code`)
- **arxiv:** atalho (`ai`, `ml`, `cv`, `nlp`, `robotics`, `crypto`) ou categoria como `cs.AI`
- **youtube:** identificador do canal (`@3Blue1Brown`), URL ou ID do canal (`UCxxxx`)
- **podcast:** URL do feed RSS
- **twitter:** nome de usuário com ou sem `@`

#### `check_feeds` — Buscar Novo Conteúdo

| Parâmetro | Descrição | Exemplo |
|-----------|-------------|---------|
| `source_type` | Limitar a um tipo (opcional) | `"news"`, `"reddit"` |

#### `search_feeds` — Busca de Texto Completo

| Parâmetro | Descrição | Exemplo |
|-----------|-------------|---------|
| `query` | Consulta de busca (obrigatório) — suporta FTS5: AND, OR, NOT, "frases entre aspas" | `"machine learning"`, `"GPU NOT NVIDIA"` |
| `source_type` | Limitar a um tipo (opcional) | `"news"` |
| `limit` | Máximo de resultados (padrão 20) | `10` |

#### `get_feed_items` — Navegar por Itens Recentes

| Parâmetro | Descrição | Exemplo |
|-----------|-------------|---------|
| `source` | Filtrar por nome da fonte (opcional) | `"BBC"`, `"LocalLLaMA"` |
| `source_type` | Filtrar por tipo (opcional) | `"reddit"`, `"hackernews"` |
| `limit` | Máximo de itens (padrão 20) | `10` |

---

### Ferramentas do Google Search

#### `google_search` — Pesquisa na Web

| Parâmetro | Descrição | Exemplo |
|-----------|-------------|---------|
| `query` | Consulta de pesquisa (obrigatório) | `"best python frameworks 2025"` |
| `num_results` | Número de resultados (1-10, padrão 5) | `5` |
| `time_range` | Filtrar por recência | `"past_hour"`, `"past_day"`, `"past_week"`, `"past_month"`, `"past_year"` |
| `site` | Limitar a um domínio | `"reddit.com"`, `"stackoverflow.com"`, `"github.com"` |
| `page` | Página de resultados (1-10, padrão 1) | `2` |
| `language` | Código do idioma | `"en"`, `"de"`, `"fr"`, `"ja"` |
| `region` | Código do país/região | `"us"`, `"gb"`, `"de"`, `"jp"` |

#### `google_shopping` — Pesquisa de Produtos

| Parâmetro | Descrição | Exemplo |
|-----------|-------------|---------|
| `query` | Consulta de pesquisa de produto (obrigatório) | `"Sony WH-1000XM5"` |
| `num_results` | Número de resultados (1-10, padrão 5) | `5` |

#### `google_flights` — Pesquisa de Voos

| Parâmetro | Descrição | Exemplo |
|-----------|-------------|---------|
| `origin` | Cidade ou aeroporto de partida (obrigatório) | `"New York"`, `"LAX"` |
| `destination` | Cidade ou aeroporto de chegada (obrigatório) | `"London"`, `"NRT"` |
| `date` | Data de partida (opcional) | `"March 15"` |
| `return_date` | Data de retorno (opcional) | `"March 22"` |

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

#### `google_hotels` — Pesquisa de Hotéis

| Parâmetro | Descrição | Exemplo |
|-----------|-------------|---------|
| `query` | Pesquisa de hotel com localização (obrigatório) | `"Paris"`, `"Tokyo near Shibuya"` |
| `num_results` | Número de resultados (1-10, padrão 5) | `5` |

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

#### `google_translate` — Tradução

| Parâmetro | Descrição | Exemplo |
|-----------|-------------|---------|
| `text` | Texto a ser traduzido (obrigatório) | `"Hello, how are you?"` |
| `to_language` | Idioma de destino (obrigatório) | `"Spanish"`, `"Japanese"` |
| `from_language` | Idioma de origem (opcional, detectado automaticamente) | `"English"` |

#### `google_maps` — Pesquisa de Lugares com Captura de Tela do Mapa

| Parâmetro | Descrição | Exemplo |
|-----------|-------------|---------|
| `query` | Consulta de pesquisa de lugar (obrigatório) | `"pizza near Central Park"` |
| `num_results` | Número de resultados (1-10, padrão 5) | `5` |

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

#### `google_maps_directions` — Rotas com Mapa

| Parâmetro | Descrição | Exemplo |
|-----------|-------------|---------|
| `origin` | Local de partida (obrigatório) | `"Berlin"` |
| `destination` | Local de chegada (obrigatório) | `"Munich"` |
| `mode` | Modo de viagem (padrão "driving") | `"driving"`, `"walking"`, `"transit"`, `"cycling"` |

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

#### `google_weather` — Clima

| Parâmetro | Descrição | Exemplo |
|-----------|-------------|---------|
| `location` | Cidade ou local (obrigatório) | `"Dubai"`, `"Tokyo"` |

#### `google_finance` — Ações e Dados de Mercado

| Parâmetro | Descrição | Exemplo |
|-----------|-------------|---------|
| `query` | Ticker da ação ou nome da empresa (obrigatório) | `"AAPL:NASDAQ"`, `"TSLA:NASDAQ"` |

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

#### `google_news` — Pesquisa de Notícias

| Parâmetro | Descrição | Exemplo |
|-----------|-------------|---------|
| `query` | Consulta de pesquisa de notícias (obrigatório) | `"AI regulation"` |
| `num_results` | Número de resultados (1-10, padrão 5) | `5` |

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

#### `google_scholar` — Pesquisa Acadêmica

| Parâmetro | Descrição | Exemplo |
|-----------|-------------|---------|
| `query` | Consulta de pesquisa acadêmica (obrigatório) | `"transformer attention mechanism"` |
| `num_results` | Número de resultados (1-10, padrão 5) | `5` |

#### `google_books` — Pesquisa de Livros

| Parâmetro | Descrição | Exemplo |
|-----------|-------------|---------|
| `query` | Consulta de pesquisa de livros (obrigatório) | `"machine learning"` |
| `num_results` | Número de resultados (1-10, padrão 5) | `5` |

#### `google_images` — Pesquisa de Imagens (embutida no chat)

| Parâmetro | Descrição | Exemplo |
|-----------|-------------|---------|
| `query` | Consulta de pesquisa de imagens (obrigatório) | `"sunset over ocean"` |
| `num_results` | Número de resultados (1-10, padrão 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` — Tendências

| Parâmetro | Descrição | Exemplo |
|-----------|-------------|---------|
| `query` | Tópico (obrigatório) | `"artificial intelligence"` |

---

### Ferramentas de Visão & OCR

#### `google_lens` — Pesquisa Reversa de Imagens

Identificar objetos, produtos, marcas, marcos e texto. Suporta URLs, arquivos locais e base64 arrastar e soltar.

| Parâmetro | Descrição | Exemplo |
|-----------|-------------|---------|
| `image_source` | URL da imagem, caminho do arquivo ou base64 (obrigatório) | `"https://example.com/photo.jpg"` ou `"/home/user/image.jpg"` |

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

#### `google_lens_detect` — Detecção + Identificação de Objetos

Detectar todos os objetos (OpenCV), recortar cada um, identificar individualmente via Lens.

| Parâmetro | Descrição | Exemplo |
|-----------|-------------|---------|
| `image_source` | Caminho do arquivo local ou base64 (obrigatório) | `"/home/user/photo.jpg"` |

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

Extrair texto de imagens usando RapidOCR. Sem necessidade de internet.

| Parâmetro | Descrição | Exemplo |
|-----------|-------------|---------|
| `image_source` | Caminho do arquivo local ou base64 (obrigatório) | `"/home/user/screenshot.png"` |

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

#### `list_images` — Descoberta de Imagens

| Parâmetro | Descrição | Exemplo |
|-----------|-------------|---------|
| `directory` | Pasta a ser escaneada (padrão `~/lens/`) | `"/home/user/photos"` |

---

### Ferramentas de Inteligência de Vídeo

#### `transcribe_video` — Transcrição de Vídeo

Baixar e transcrever qualquer vídeo do YouTube (ou URL de vídeo) com timestamps usando faster-whisper.

| Parâmetro | Descrição | Exemplo |
|-----------|-------------|---------|
| `url` | URL do YouTube ou de vídeo (obrigatório) | `"https://youtube.com/watch?v=..."` |
| `model_size` | Tamanho do modelo Whisper (padrão: tiny) | `"tiny"`, `"base"`, `"small"`, `"medium"`, `"large"` |
| `language` | Código do idioma (opcional, detectado automaticamente) | `"en"` |

#### `search_transcript` — Busca na Transcrição

| Parâmetro | Descrição | Exemplo |
|-----------|-------------|---------|
| `url` | Mesmo URL usado com transcribe_video (obrigatório) | `"https://youtube.com/watch?v=..."` |
| `query` | Palavra-chave ou frase (obrigatório) | `"memory bandwidth"` |
| `context_segments` | Segmentos ao redor (padrão: 2) | `3` |

#### `extract_video_clip` — Extração de Clipe por Tópico

Pergunte "extraia a parte sobre X" e o LLM encontra os timestamps a partir da transcrição e corta o clipe.

| Parâmetro | Descrição | Exemplo |
|-----------|-------------|---------|
| `url` | URL do YouTube ou vídeo local (obrigatório) | `"https://youtube.com/watch?v=..."` |
| `start_seconds` | Tempo de início em segundos (obrigatório) | `150` |
| `end_seconds` | Tempo de fim em segundos (obrigatório) | `315` |
| `buffer_seconds` | Segundos extras antes/depois (padrão: 3) | `5.0` |
| `output_filename` | Nome de arquivo personalizado (opcional) | `"hardware_overview"` |

---

## Exemplos de Prompts

### Assinaturas de Feed
| O que você digita | Ferramenta chamada |
|--------------|-------------|
| *"Inscrever-se na BBC News e CNN"* | `subscribe` |
| *"Seguir r/LocalLLaMA no Reddit"* | `subscribe` |
| *"Monitorar as principais histórias do Hacker News"* | `subscribe` |
| *"Observar anthropics/claude-code para novos lançamentos"* | `subscribe` |
| *"Inscrever-se no @3Blue1Brown no YouTube"* | `subscribe` |
| *"Seguir @elonmusk no Twitter"* | `subscribe` |
| *"Inscrever-se na categoria arXiv de ML"* | `subscribe` |
| *"Verificar meus feeds"* | `check_feeds` |
| *"O que há de novo nas minhas assinaturas?"* | `check_feeds` |
| *"Pesquisar em meus feeds por arquitetura transformer"* | `search_feeds` |
| *"Mostrar-me as postagens mais recentes do Reddit"* | `get_feed_items` |
| *"Quais são minhas assinaturas?"* | `list_subscriptions` |
| *"Cancelar inscrição da BBC News"* | `unsubscribe` |

### Web Search
| O que você digita | Ferramenta chamada | Parâmetros usados |
|--------------|-------------|-----------------|
| *"Pesquisar pelos melhores frameworks web Python"* | `google_search` | `query` |
| *"Encontrar discussões no Reddit sobre configurações de home lab"* | `google_search` | `query` + `site="reddit.com"` |
| *"Pesquisar no Stack Overflow exemplos de Python assíncrono"* | `google_search` | `query` + `site="stackoverflow.com"` |
| *"O que há de novo em IA esta semana?"* | `google_search` | `query` + `time_range="past_week"` |
| *"Pesquisar no Hacker News postagens sobre Rust"* | `google_search` | `query` + `site="news.ycombinator.com"` |
| *"Obter a página 2 dos resultados para tutoriais de ML"* | `google_search` | `query` + `page=2` |
| *"Pesquisar restaurantes em Tóquio em japonês"* | `google_search` | `query` + `language="ja"` + `region="jp"` |

### Shopping & Travel
| O que você digita | Ferramenta chamada |
|--------------|-------------|
| *"Encontrar o MacBook Air mais barato"* | `google_shopping` |
| *"Encontrar voos de Nova York para Londres"* | `google_flights` |
| *"Encontrar hotéis em Paris para o próximo fim de semana"* | `google_hotels` |
| *"Traduzir 'hello world' para japonês"* | `google_translate` |

### Maps & Directions
| O que você digita | Ferramenta chamada |
|--------------|-------------|
| *"Encontrar restaurantes italianos perto da Times Square"* | `google_maps` |
| *"Obter direções de Berlim para Munique"* | `google_maps_directions` |
| *"Direções a pé da Torre Eiffel para o Louvre"* | `google_maps_directions` |

### Finance, Weather & Info
| O que você digita | Ferramenta chamada |
|--------------|-------------|
| *"Qual é o preço das ações da Apple?"* | `google_finance` |
| *"Como está o clima em Dubai?"* | `google_weather` |
| *"Quais são as principais manchetes de hoje?"* | `google_news` |
| *"Encontrar artigos sobre mecanismos de atenção transformer"* | `google_scholar` |
| *"Encontrar livros sobre machine learning"* | `google_books` |### Imagens & Visão
| O que você digita | Ferramenta chamada |
|--------------|-------------|
| *"Mostre-me imagens da Aurora Boreal"* | `google_images` |
| *"O que é este produto? /path/to/photo.jpg"* | `google_lens` |
| *"Detecte todos os objetos nesta foto"* | `google_lens_detect` |
| *"Leia o texto nesta captura de tela"* | `ocr_image` |
| Arraste imagem para o chat + *"O que é isto?"* | `google_lens` |
| Arraste imagem para o chat + *"Leia o texto"* | `ocr_image` |

> **Dica:** Para ativar imagens arrastar e soltar com modelos somente de texto no LM Studio, adicione um arquivo `model.yaml` no diretório do modelo com `metadataOverrides: { vision: true }`. A imagem será enviada como base64 e as ferramentas MCP lidam com isso automaticamente.

### Inteligência de Vídeo e Extração de Clipes com IA
| O que você digita | Ferramenta chamada |
|--------------|-------------|
| *"Transcreva este vídeo: https://youtube.com/watch?v=..."* | `transcribe_video` |
| *"O que eles discutem neste vídeo?"* | `transcribe_video` |
| *"Encontre onde eles falam sobre largura de banda de memória"* | `search_transcript` |
| *"Extraia a parte onde eles discutem preços"* | `extract_video_clip` |
| *"Corte um clipe da seção de comparação de hardware"* | `extract_video_clip` |
| *"Transcreva ~/meeting.mp3"* | `transcribe_local` |
| *"Converta video.mp4 para mp3"* | `convert_media` |
| *"Converta este vídeo para um GIF"* | `convert_media` |

### Documentos e E-mail
| O que você digita | Ferramenta chamada |
|--------------|-------------|
| *"Leia este PDF: ~/report.pdf"* | `read_document` |
| *"Extraia texto de ~/contract.docx"* | `read_document` |
| *"Leia este artigo para mim: https://..."* | `visit_page` |
| *"Verifique meu e-mail em [email protected] senha: xxxx"* | `fetch_emails` |
| *"Puxe meus últimos 10 e-mails do Outlook"* | `fetch_emails` |

### Utilitários da Web e Nuvem
| O que você digita | Ferramenta chamada |
|--------------|-------------|
| *"Encurte esta URL: https://very-long-url..."* | `shorten_url` |
| *"Gere um código QR para https://mysite.com"* | `generate_qr` |
| *"Faça um código QR para minha rede Wi-Fi"* | `generate_qr` |
| *"Publique este código em um pastebin"* | `paste_text` |
| *"Arquive este artigo: https://news.example.com/story"* | `archive_webpage` |
| *"Wikipedia: computação quântica"* | `wikipedia` |
| *"Consulte a missão Apollo 11 na Wikipedia em alemão"* | `wikipedia` |
| *"Envie report.pdf para meu bucket MinIO"* | `upload_to_s3` |
| *"Armazene backup.tar.gz no bucket S3 my-backups"* | `upload_to_s3` |

---

## Instalação

### Instalação Rápida (pipx - recomendado)```bash
pipx install noapi-google-search-mcp
playwright install chromium

### Python 3.13 / OCR

O pacote principal instala em todos os Pythons suportados, incluindo o 3.13. O OCR é opcional porque o `rapidocr-onnxruntime` ainda não disponibiliza um wheel para Python 3.13 upstream ([RapidAI/RapidOCR#579](https://github.com/RapidAI/RapidOCR/issues/579)). Tudo exceto as ferramentas de OCR (`ocr_image` e o fallback de PDF escaneado em `read_document`) funciona sem ele.

Para ativar o OCR, adicione o extra `[ocr]` em um Python compatível (3.10–3.12):```bash
pipx install "noapi-google-search-mcp[ocr]"

Se instalado em um venv, use o caminho completo: `~/.local/share/noapi-google-search-mcp/bin/noapi-google-search-mcp`

### Claude Desktop

Adicione na sua configuração do Claude Desktop (`claude_desktop_config.json`):```json
{
  "mcpServers": {
    "google-search": {
      "command": "noapi-google-search-mcp"
    }
  }
}

Isto dá ao seu agente OpenClaw acesso a todas as 38 ferramentas — pesquisa real do Google, feeds ao vivo, visão, OCR e inteligência de vídeo — sem chaves de API.

### Como uma CLI```bash
noapi-google-search-mcp

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