Skip to content
Back to search

noapi-google-search-mcp

MCP server for Google search and page fetching using headless Chromium

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/engram-ae--noapi-google-search-mcp/badge.svg)](/listings/engram-ae--noapi-google-search-mcp)

HTML

<a href="/listings/engram-ae--noapi-google-search-mcp"><img src="/api/listings/engram-ae--noapi-google-search-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Quick Install (pipx - recommended)

pipx install noapi-google-search-mcp
playwright install chromium

Install in a Virtual Environment

python3 -m venv ~/.local/share/noapi-google-search-mcp
~/.local/share/noapi-google-search-mcp/bin/pip install noapi-google-search-mcp
~/.local/share/noapi-google-search-mcp/bin/playwright install chromium

Python 3.13 / OCR

The core package installs on every supported Python, including 3.13. OCR is opt-in because `rapidocr-onnxruntime` does not yet ship a Python 3.13 wheel upstream ([RapidAI/RapidOCR#579](https://github.com/RapidAI/RapidOCR/issues/579)). Everything except the OCR tools (`ocr_image` and the scanned-PDF fallback in `read_document`) works without it.

To enable OCR, add the `[ocr]` extra on a compatible Python (3.10–3.12):

pipx install "noapi-google-search-mcp[ocr]"

If you install the core package and later call an OCR tool without the extra, the tool returns a short message telling you to install `"noapi-google-search-mcp[ocr]"` instead of crashing.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 771 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # noapi-google-search-mcp
  2. vincentkaufmann@protonmail.com
  3. If you want to support noapi-google-mcp or gpt-oss-20B/120B-Vision and other open source models in the pipeline please add to my GPU compute fund: around $3000 are needed.
  4. > <img src="images/btc-donate-qr.jpeg" alt="BTC" width="80" align="left" style="margin-right:12px"> If you find this useful, consider supporting continued development and new features.<br>**BTC:** `16DT4AHemLyn7C6P116YepjY518gu9wUUH`<br clear="all">
  5. > <img src="images/eth-donate-qr.png" alt="ETH" width="80" align="left" style="margin-right:12px"> **ETH:** `0x7287D1F9c77832cFF246937af0443622bFdACD04`<br clear="all">
  6. **38 tools. Zero API keys. Give any local LLM real Google search, live feeds, vision, OCR, and full video understanding.**
  7. An MCP server that turns your local LLM into a fully connected assistant. Real Google results, live news and social feeds, reverse image search, offline OCR, YouTube transcription and clip extraction — all running locally through headless Chromium and open-source ML models. No API keys, no usage limits, no cloud dependency.
  8. Works with **LM Studio**, **Claude Desktop**, **OpenClaw**, **Ollama**, and any MCP-compatible client.
  9. ---
  10. ## What's New in v0.3.1 — Anti-Bot Detection & Neural Net CAPTCHA Solver
  11. Google started catching headless Chromium browsers and serving CAPTCHAs instead of search results ([#2](https://github.com/VincentKaufmann/noapi-google-search-mcp/issues/2)). Fixed it properly and then added a neural net CAPTCHA solver just for the hell of it.
  12. **Stealth patches:**
  13. - JavaScript injection before every page load patches `navigator.webdriver`, fake browser plugins, `chrome.runtime`, and removes Playwright fingerprints
  14. - Fixed User-Agent mismatch (was `aarch64`, now matches the actual Chromium binary)
  15. - Cookie persistence between sessions so Google sees a returning browser, not a fresh bot
  16. - Human-like random delays between page interactions
  17. - Clear error messages when rate-limited instead of cryptic timeouts
  18. **Neural net CAPTCHA solver (MobileNetV2 + OpenCV):**
  19. - When Google serves a reCAPTCHA image challenge ("Select all images with traffic lights"), the server now attempts to solve it automatically
  20. - Uses MobileNetV2 (ImageNet classifier, ~13MB ONNX model, auto-downloads on first encounter)
  21. - OpenCV splits the CAPTCHA grid into cells, each cell is classified by the neural net and matched against the prompt
  22. - Covers 22 common CAPTCHA categories: traffic lights, buses, bicycles, motorcycles, cars, bridges, boats, trains, trucks, fire hydrants, parking meters, tractors, and more
  23. - Human-like mouse movement for clicking cells and the verify button
  24. - Falls back gracefully if the challenge type isn't supported
  25. Will it solve every CAPTCHA? No. But it'll get through some of them, and honestly we mostly built it because we could.
  26. ---
  27. ## What's New in v0.3.0 — 16 New Tools
  28. ## YouTube RAG — Subscribe, Transcribe, Search, Clip
  29. A full local retrieval-augmented pipeline for YouTube. Subscribe to any channel, and when you check feeds the server automatically downloads the audio, transcribes it with Whisper, and stores the full transcript in SQLite with FTS5 full-text search. Every word from every video becomes searchable — ask your LLM a question and it pulls the answer from the right video.
  30. Found something interesting? Ask the LLM to extract that segment as a clip. It reads the transcript, finds the exact timestamps, and cuts the video for you. This is the beginning of **AI/LLM-powered video editing** — your LLM understands the content and cuts clips based on what's being said, not just timestamps.
  31. **How it works:**
  32. 1. `subscribe` to a YouTube channel — by handle (`@3Blue1Brown`), URL, or channel ID
  33. 2. `check_feeds` — new videos are fetched and **auto-transcribed** locally with faster-whisper. Transcripts are written into the database for instant search. Up to 5 videos per check, cached so nothing gets re-downloaded.
  34. 3. `search_feeds` — full-text search across all transcripts. Supports AND, OR, NOT, and quoted phrases. Your LLM finds the exact video and passage that answers your question.
  35. 4. `extract_video_clip` — tell the LLM what you're interested in and it cuts the clip from the video. The LLM uses the transcript to find the right segment and extracts it automatically.
  36. ```
  37. "Subscribe to @AndrejKarpathy on YouTube"
  38. "Check my feeds"
  39. "Search my feeds for backpropagation explained"
  40. "What did Karpathy say about tokenization?"
  41. "Extract the part where he explains gradient descent"
  42. "Cut a clip of the hardware comparison section"
  43. ```
  44. No embeddings, no vector database, no API — just Whisper + SQLite FTS5 running on your machine.
  45. > **Roadmap:** The clip extraction is the first step toward full AI-driven video editing. Future releases will add music/audio overlay, video remixing, multi-clip compilation, vertical reformat for TikTok/Reels/Shorts, and automated highlight reels — all driven by your LLM understanding the content.
  46. ---
  47. ### Live Feed Subscriptions
  48. Subscribe to news, Reddit, Hacker News, YouTube channels, Twitter/X profiles, GitHub repos, arXiv papers, and podcasts. Content is fetched, stored locally in SQLite with full-text search, and available to your LLM instantly.
  49. | New Tool | What It Does |
  50. |----------|-------------|
  51. | `subscribe` | Add any source — news RSS, Reddit, HN, GitHub, arXiv, YouTube, podcasts, Twitter/X |
  52. | `unsubscribe` | Remove a subscription and its stored content |
  53. | `list_subscriptions` | See all active feeds with item counts |
  54. | `check_feeds` | Poll all subscriptions, fetch new content, auto-transcribe YouTube videos |
  55. | `search_feeds` | Full-text search across everything your feeds have collected |
  56. | `get_feed_items` | Browse recent items, filtered by source or type |
  57. **Pre-configured news sources** — subscribe with one word: `bbc`, `cnn`, `nyt`, `guardian`, `npr`, `aljazeera`, `techcrunch`, `ars`, `verge`, `wired`, `reuters`
  58. **arXiv shortcuts** — `ai`, `ml`, `cv`, `nlp`, `robotics`, `crypto`, `systems`, `hci`
  59. ```
  60. "Subscribe to BBC News, r/LocalLLaMA, and Hacker News"
  61. "Follow @elonmusk on Twitter"
  62. "Subscribe to the YouTube channel @3Blue1Brown"
  63. "Watch anthropics/claude-code on GitHub for new releases"
  64. "Subscribe to the machine learning arXiv category"
  65. "Check my feeds"
  66. "Search my feeds for transformer architecture"
  67. "What's new in my Reddit feeds?"
  68. ```
  69. ### Local File Processing
  70. Transcribe meetings, convert formats, read documents — all local, no cloud.
  71. | New Tool | What It Does |
  72. |----------|-------------|
  73. | `transcribe_local` | Transcribe any local audio or video file with Whisper (mp3, wav, mp4, mkv, etc.) |
  74. | `convert_media` | FFmpeg format conversion — video to audio, format to format, video to GIF |
  75. | `read_document` | Extract text from PDF, DOCX, HTML, CSV, JSON, and 30+ text formats |
  76. ### Email, Web Utilities & Cloud
  77. Pull emails, generate QR codes, shorten URLs, archive pages, look up Wikipedia, upload to S3.
  78. | New Tool | What It Does |
  79. |----------|-------------|
  80. | `fetch_emails` | Pull emails via IMAP — Gmail, Outlook, Yahoo, any IMAP server |
  81. | `paste_text` | Post text to a pastebin and get a shareable link |
  82. | `shorten_url` | Shorten any URL via TinyURL |
  83. | `generate_qr` | Generate QR code images for URLs, Wi-Fi, contacts, any data |
  84. | `archive_webpage` | Save a webpage snapshot to the Wayback Machine |
  85. | `wikipedia` | Look up any Wikipedia article, any language, with summary support |
  86. | `upload_to_s3` | Upload files to MinIO, AWS S3, DigitalOcean Spaces, Cloudflare R2 |
  87. ```
  88. "Transcribe this recording: ~/meeting.mp3"
  89. "Convert video.mp4 to mp3"
  90. "Read this PDF: ~/report.pdf"
  91. "Check my email: user@gmail.com password: xxxx"
  92. "Shorten this URL: https://very-long-url..."
  93. "Generate a QR code for https://mysite.com"
  94. "Archive this article: https://news.example.com/story"
  95. "Wikipedia: quantum computing"
  96. "Upload report.pdf to my MinIO bucket"
  97. ```
  98. **Zero extra dependencies for feeds.** Built entirely on Python stdlib — SQLite for storage, FTS5 for search, urllib for fetching, xml.etree for parsing. YouTube and Twitter use the existing Playwright browser. FFmpeg required for `convert_media` (commonly pre-installed).
  99. ---
  100. ## All 38 Tools by Category
  101. ### Live Feed Subscriptions
  102. | Tool | Description |
  103. |------|-------------|
  104. | `subscribe` | Subscribe to news, Reddit, HN, GitHub, arXiv, YouTube, podcasts, Twitter/X |
  105. | `unsubscribe` | Remove a subscription and its stored content |
  106. | `list_subscriptions` | List all active subscriptions with item counts |
  107. | `check_feeds` | Fetch new content from all or specific sources |
  108. | `search_feeds` | Full-text search across all stored feed content |
  109. | `get_feed_items` | Get recent items filtered by source or type |
  110. ### Google Search & Web
  111. | Tool | Description |
  112. |------|-------------|
  113. | `google_search` | Web search with time filters, site filters, pagination, language/region |
  114. | `google_news` | News search with article thumbnails inline |
  115. | `google_scholar` | Academic papers with citations |
  116. | `google_images` | Image search with results displayed inline in chat |
  117. | `google_trends` | Topic interest over time, related queries |
  118. | `visit_page` | Fetch any URL and extract readable text |
  119. ### Travel & Commerce
  120. | Tool | Description |
  121. |------|-------------|
  122. | `google_shopping` | Product search with prices, stores, ratings, images |
  123. | `google_flights` | Flight search with prices and travel times |
  124. | `google_hotels` | Hotel search with images, prices, ratings, booking URLs |
  125. | `google_translate` | Translation across 100+ languages |
  126. | `google_maps` | Places search with ratings, reviews, and map screenshots |
  127. | `google_maps_directions` | Route directions with step-by-step and map screenshot |
  128. ### Finance & Info
  129. | Tool | Description |
  130. |------|-------------|
  131. | `google_finance` | Stock prices, market data, company info |
  132. | `google_weather` | Current conditions and multi-day forecast |
  133. | `google_books` | Book search with author, ISBN, snippets |
  134. ### Vision & OCR
  135. | Tool | Description |
  136. |------|-------------|
  137. | `google_lens` | Reverse image search — identify objects, products, landmarks, text |
  138. | `google_lens_detect` | Detect all objects in an image (OpenCV) and identify each via Lens |
  139. | `ocr_image` | Extract text from images locally (RapidOCR, fully offline) |
  140. | `list_images` | List image files in a directory for use with vision tools |
  141. ### Video & Audio Intelligence — AI-Powered Video Editing
  142. | Tool | Description |
  143. |------|-------------|
  144. | `transcribe_video` | Download and transcribe any video with timestamps (faster-whisper) |
  145. | `transcribe_local` | Transcribe local audio/video files (mp3, wav, m4a, mp4, mkv, etc.) |
  146. | `search_transcript` | Search a transcribed video for topics by keyword |
  147. | `extract_video_clip` | AI-powered clip extraction — tell the LLM what you want and it cuts the video using transcript context |
  148. | `convert_media` | Convert between audio/video formats via FFmpeg |
  149. ### Documents & Data
  150. | Tool | Description |
  151. |------|-------------|
  152. | `read_document` | Extract text from PDF, DOCX, HTML, CSV, JSON, and 30+ formats |
  153. ### Email
  154. | Tool | Description |
  155. |------|-------------|
  156. | `fetch_emails` | Pull emails via IMAP — Gmail, Outlook, Yahoo, iCloud, any IMAP server |
  157. ### Web Utilities
  158. | Tool | Description |
  159. |------|-------------|
  160. | `paste_text` | Post text to a pastebin and get a shareable URL |
  161. | `shorten_url` | Shorten any URL via TinyURL |
  162. | `generate_qr` | Generate QR code images (URLs, Wi-Fi, contacts, any data) |
  163. | `archive_webpage` | Archive a webpage on the Wayback Machine |
  164. | `wikipedia` | Wikipedia article lookup in any language |
  165. ### Cloud Storage
  166. | Tool | Description |
  167. |------|-------------|
  168. | `upload_to_s3` | Upload files to MinIO, AWS S3, DigitalOcean Spaces, Cloudflare R2, Backblaze B2 |
  169. ---
  170. ## Supported File Formats
  171. ### Documents (`read_document`)
  172. | Category | Formats |
  173. |----------|---------|
  174. | Documents | PDF (with OCR fallback for scanned pages), DOCX |
  175. | Web | HTML, HTM |
  176. | Data | CSV, JSON, XML, YAML, YML, TOML |
  177. | Text | TXT, MD, LOG |
  178. | Config | INI, CFG, CONF, ENV |
  179. | Code | PY, JS, TS, GO, RS, C, CPP, H, JAVA, KT, RB, SQL, R, M, SWIFT |
  180. | Shell | SH, BASH, ZSH |
  181. ### Audio & Video (`transcribe_local`, `transcribe_video`, `convert_media`)
  182. | Category | Formats |
  183. |----------|---------|
  184. | Audio | MP3, WAV, M4A, FLAC, OGG, AAC, WMA, OPUS |
  185. | Video | MP4, MKV, WEBM, AVI, MOV |
  186. | Special | GIF (video-to-GIF output) |
  187. | Input | Any format FFmpeg can decode (hundreds of formats) |
  188. ### Images (`google_lens`, `google_lens_detect`, `ocr_image`, `list_images`)
  189. | Category | Formats |
  190. |----------|---------|
  191. | Standard | JPG, JPEG, PNG, GIF, BMP, WEBP |
  192. | Professional | TIFF, TIF, SVG |
  193. | Input methods | Local file path, public URL, base64 (drag-and-drop into chat) |
  194. ---
  195. ## Why This Instead of API-Based Alternatives?
  196. | | **noapi-google-search-mcp** | API-based MCP servers | OpenClaw built-in |
  197. |---|---|---|---|
  198. | API key required | **No** | Yes (Google CSE API) | Yes (Brave/Perplexity) |
  199. | Cost | **Free** | Paid after 100 queries/day | API fees |
  200. | Setup time | **`pip install` + go** | Create Cloud project, enable API, configure | Multiple API keys |
  201. | Results quality | **Real Google results** | Custom Search Engine | Brave index |
  202. | JavaScript pages | **Renders them (Chromium)** | Cannot render JS | Cannot render JS |
  203. | Tools count | **38** | 1-3 | 2 (web_search, web_fetch) |
  204. | Google Search | Built-in (with filters) | Basic only | Not available |
  205. | Google Shopping | Built-in | Not available | Not available |
  206. | Google Flights | Built-in | Not available | Not available |
  207. | Google Hotels | Built-in | Not available | Not available |
  208. | Google Translate | Built-in | Separate API needed | Not available |
  209. | Google Maps | Built-in (with screenshots) | Not available | Not available |
  210. | Google Maps Directions | Built-in (with route map) | Not available | Not available |
  211. | Google Weather | Built-in | Not available | Not available |
  212. | Google Finance | Built-in | Not available | Not available |
  213. | Google News | Built-in | Usually not available | Not available |
  214. | Google Scholar | Built-in | Not available | Not available |
  215. | Google Books | Built-in | Not available | Not available |
  216. | Google Images | Built-in (inline in chat) | Separate API needed | Not available |
  217. | Google Lens | Built-in (reverse image search) | Not available | Not available |
  218. | Object detection | Built-in (OpenCV + Lens) | Not available | Not available |
  219. | Local OCR | Built-in (offline) | Not available | Not available |
  220. | Video transcription | Built-in (local Whisper) | Not available | Not available |
  221. | Video clip extraction | **Built-in (AI/LLM-powered)** | Not available | Not available |
  222. | YouTube RAG pipeline | **Built-in (subscribe → transcribe → search)** | Not available | Not available |
  223. | Google Trends | Built-in | Separate API needed | Not available |
  224. | Feed subscriptions | **Built-in (8 source types)** | Not available | Not available |
  225. | Full-text feed search | **Built-in (SQLite FTS5)** | Not available | Not available |
  226. | Auto-transcribe feeds | **Built-in (YouTube → Whisper)** | Not available | Not available |
  227. | Local file transcription | **Built-in (any audio/video)** | Not available | Not available |
  228. | Media format conversion | **Built-in (FFmpeg)** | Not available | Not available |
  229. | Document reader | **Built-in (PDF, DOCX, etc.)** | Not available | Not available |
  230. | Email integration | **Built-in (IMAP)** | Not available | Not available |
  231. | Pastebin | **Built-in** | Not available | Not available |
  232. | URL shortener | **Built-in (TinyURL)** | Not available | Not available |
  233. | QR code generation | **Built-in (OpenCV)** | Not available | Not available |
  234. | Web archiving | **Built-in (Wayback Machine)** | Not available | Not available |
  235. | Wikipedia | **Built-in** | Not available | Not available |
  236. | S3/MinIO upload | **Built-in** | Not available | Not available |
  237. | Page fetching | Built-in | Usually separate | Basic |
  238. ---
  239. ## Tool Details & Parameters
  240. ### Feed Subscription Tools
  241. #### `subscribe` — Add a Content Source
  242. | Parameter | Description | Example |
  243. |-----------|-------------|---------|
  244. | `source_type` | Source type (required) | `"news"`, `"reddit"`, `"hackernews"`, `"github"`, `"arxiv"`, `"youtube"`, `"podcast"`, `"twitter"` |
  245. | `identifier` | Source identifier (required) | `"bbc"`, `"LocalLLaMA"`, `"top"`, `"anthropics/claude-code"`, `"ml"`, `"@3Blue1Brown"`, `"https://..."`, `"elonmusk"` |
  246. | `name` | Display name (optional) | `"My Custom Feed"` |
  247. **Identifier formats by type:**
  248. - **news:** preset name (`bbc`, `cnn`, `nyt`, `guardian`, `npr`, `aljazeera`, `techcrunch`, `ars`, `verge`, `wired`, `reuters`) or any RSS URL
  249. - **reddit:** subreddit name (e.g. `LocalLLaMA`, `programming`)
  250. - **hackernews:** `top`, `new`, or `best`
  251. - **github:** `owner/repo` (e.g. `anthropics/claude-code`)
  252. - **arxiv:** shortcut (`ai`, `ml`, `cv`, `nlp`, `robotics`, `crypto`) or category like `cs.AI`
  253. - **youtube:** channel handle (`@3Blue1Brown`), URL, or channel ID (`UCxxxx`)
  254. - **podcast:** RSS feed URL
  255. - **twitter:** username with or without `@`
  256. #### `check_feeds` — Fetch New Content
  257. | Parameter | Description | Example |
  258. |-----------|-------------|---------|
  259. | `source_type` | Limit to one type (optional) | `"news"`, `"reddit"` |
  260. #### `search_feeds` — Full-Text Search
  261. | Parameter | Description | Example |
  262. |-----------|-------------|---------|
  263. | `query` | Search query (required) — supports FTS5: AND, OR, NOT, "quoted phrases" | `"machine learning"`, `"GPU NOT NVIDIA"` |
  264. | `source_type` | Limit to one type (optional) | `"news"` |
  265. | `limit` | Max results (default 20) | `10` |
  266. #### `get_feed_items` — Browse Recent Items
  267. | Parameter | Description | Example |
  268. |-----------|-------------|---------|
  269. | `source` | Filter by source name (optional) | `"BBC"`, `"LocalLLaMA"` |
  270. | `source_type` | Filter by type (optional) | `"reddit"`, `"hackernews"` |
  271. | `limit` | Max items (default 20) | `10` |
  272. ---
  273. ### Google Search Tools
  274. #### `google_search` — Web Search
  275. | Parameter | Description | Example |
  276. |-----------|-------------|---------|
  277. | `query` | Search query (required) | `"best python frameworks 2025"` |
  278. | `num_results` | Number of results (1-10, default 5) | `5` |
  279. | `time_range` | Filter by recency | `"past_hour"`, `"past_day"`, `"past_week"`, `"past_month"`, `"past_year"` |
  280. | `site` | Limit to a domain | `"reddit.com"`, `"stackoverflow.com"`, `"github.com"` |
  281. | `page` | Results page (1-10, default 1) | `2` |
  282. | `language` | Language code | `"en"`, `"de"`, `"fr"`, `"ja"` |
  283. | `region` | Country/region code | `"us"`, `"gb"`, `"de"`, `"jp"` |
  284. #### `google_shopping` — Product Search
  285. | Parameter | Description | Example |
  286. |-----------|-------------|---------|
  287. | `query` | Product search query (required) | `"Sony WH-1000XM5"` |
  288. | `num_results` | Number of results (1-10, default 5) | `5` |
  289. #### `google_flights` — Flight Search
  290. | Parameter | Description | Example |
  291. |-----------|-------------|---------|
  292. | `origin` | Departure city or airport (required) | `"New York"`, `"LAX"` |
  293. | `destination` | Arrival city or airport (required) | `"London"`, `"NRT"` |
  294. | `date` | Departure date (optional) | `"March 15"` |
  295. | `return_date` | Return date (optional) | `"March 22"` |
  296. ![Google Flights](images/google_flights.png)
  297. #### `google_hotels` — Hotel Search
  298. | Parameter | Description | Example |
  299. |-----------|-------------|---------|
  300. | `query` | Hotel search with location (required) | `"Paris"`, `"Tokyo near Shibuya"` |
  301. | `num_results` | Number of results (1-10, default 5) | `5` |
  302. ![Google Hotels](images/google_hotels.png)
  303. #### `google_translate` — Translation
  304. | Parameter | Description | Example |
  305. |-----------|-------------|---------|
  306. | `text` | Text to translate (required) | `"Hello, how are you?"` |
  307. | `to_language` | Target language (required) | `"Spanish"`, `"Japanese"` |
  308. | `from_language` | Source language (optional, auto-detected) | `"English"` |
  309. #### `google_maps` — Places Search with Map Screenshot
  310. | Parameter | Description | Example |
  311. |-----------|-------------|---------|
  312. | `query` | Place search query (required) | `"pizza near Central Park"` |
  313. | `num_results` | Number of results (1-10, default 5) | `5` |
  314. ![Google Maps Places Search](images/google_maps_places.png)
  315. #### `google_maps_directions` — Route Directions with Map
  316. | Parameter | Description | Example |
  317. |-----------|-------------|---------|
  318. | `origin` | Starting location (required) | `"Berlin"` |
  319. | `destination` | Ending location (required) | `"Munich"` |
  320. | `mode` | Travel mode (default "driving") | `"driving"`, `"walking"`, `"transit"`, `"cycling"` |
  321. ![Google Maps Directions](images/google_maps.png)
  322. #### `google_weather` — Weather
  323. | Parameter | Description | Example |
  324. |-----------|-------------|---------|
  325. | `location` | City or location (required) | `"Dubai"`, `"Tokyo"` |
  326. #### `google_finance` — Stock & Market Data
  327. | Parameter | Description | Example |
  328. |-----------|-------------|---------|
  329. | `query` | Stock ticker or company name (required) | `"AAPL:NASDAQ"`, `"TSLA:NASDAQ"` |
  330. ![Google Finance](images/google_stocks.png)
  331. #### `google_news` — News Search
  332. | Parameter | Description | Example |
  333. |-----------|-------------|---------|
  334. | `query` | News search query (required) | `"AI regulation"` |
  335. | `num_results` | Number of results (1-10, default 5) | `5` |
  336. ![Google News](images/google_news.png)
  337. #### `google_scholar` — Academic Search
  338. | Parameter | Description | Example |
  339. |-----------|-------------|---------|
  340. | `query` | Academic search query (required) | `"transformer attention mechanism"` |
  341. | `num_results` | Number of results (1-10, default 5) | `5` |
  342. #### `google_books` — Book Search
  343. | Parameter | Description | Example |
  344. |-----------|-------------|---------|
  345. | `query` | Book search query (required) | `"machine learning"` |
  346. | `num_results` | Number of results (1-10, default 5) | `5` |
  347. #### `google_images` — Image Search (inline in chat)
  348. | Parameter | Description | Example |
  349. |-----------|-------------|---------|
  350. | `query` | Image search query (required) | `"sunset over ocean"` |
  351. | `num_results` | Number of results (1-10, default 5) | `5` |
  352. ![Google Image Search](images/google_image_search.png)
  353. ![Google Image Search](images/google_image_search2.png)
  354. #### `google_trends` — Trends
  355. | Parameter | Description | Example |
  356. |-----------|-------------|---------|
  357. | `query` | Topic (required) | `"artificial intelligence"` |
  358. ---
  359. ### Vision & OCR Tools
  360. #### `google_lens` — Reverse Image Search
  361. Identify objects, products, brands, landmarks, and text. Supports URLs, local files, and base64 drag-and-drop.
  362. | Parameter | Description | Example |
  363. |-----------|-------------|---------|
  364. | `image_source` | Image URL, file path, or base64 (required) | `"https://example.com/photo.jpg"` or `"/home/user/image.jpg"` |
  365. ![Google Lens Reverse Image Search](images/google_reverse_image_search.png)
  366. #### `google_lens_detect` — Object Detection + Identification
  367. Detect all objects (OpenCV), crop each one, identify individually via Lens.
  368. | Parameter | Description | Example |
  369. |-----------|-------------|---------|
  370. | `image_source` | Local file path or base64 (required) | `"/home/user/photo.jpg"` |
  371. #### `ocr_image` — Local OCR (offline)
  372. Extract text from images using RapidOCR. No internet needed.
  373. | Parameter | Description | Example |
  374. |-----------|-------------|---------|
  375. | `image_source` | Local file path or base64 (required) | `"/home/user/screenshot.png"` |
  376. ![Local OCR](images/local_OCR.png)
  377. #### `list_images` — Image Discovery
  378. | Parameter | Description | Example |
  379. |-----------|-------------|---------|
  380. | `directory` | Folder to scan (default `~/lens/`) | `"/home/user/photos"` |
  381. ---
  382. ### Video Intelligence Tools
  383. #### `transcribe_video` — Video Transcription
  384. Download and transcribe any YouTube video (or video URL) with timestamps using faster-whisper.
  385. | Parameter | Description | Example |
  386. |-----------|-------------|---------|
  387. | `url` | YouTube or video URL (required) | `"https://youtube.com/watch?v=..."` |
  388. | `model_size` | Whisper model size (default: tiny) | `"tiny"`, `"base"`, `"small"`, `"medium"`, `"large"` |
  389. | `language` | Language code (optional, auto-detected) | `"en"` |
  390. #### `search_transcript` — Transcript Search
  391. | Parameter | Description | Example |
  392. |-----------|-------------|---------|
  393. | `url` | Same URL used with transcribe_video (required) | `"https://youtube.com/watch?v=..."` |
  394. | `query` | Keyword or phrase (required) | `"memory bandwidth"` |
  395. | `context_segments` | Surrounding segments (default: 2) | `3` |
  396. #### `extract_video_clip` — Clip Extraction by Topic
  397. Ask "extract the part about X" and the LLM finds timestamps from the transcript and cuts the clip.
  398. | Parameter | Description | Example |
  399. |-----------|-------------|---------|
  400. | `url` | YouTube URL or local video (required) | `"https://youtube.com/watch?v=..."` |
  401. | `start_seconds` | Start time in seconds (required) | `150` |
  402. | `end_seconds` | End time in seconds (required) | `315` |
  403. | `buffer_seconds` | Extra seconds before/after (default: 3) | `5.0` |
  404. | `output_filename` | Custom filename (optional) | `"hardware_overview"` |
  405. ---
  406. ## Sample Prompts
  407. ### Feed Subscriptions
  408. | What you type | Tool called |
  409. |--------------|-------------|
  410. | *"Subscribe to BBC News and CNN"* | `subscribe` |
  411. | *"Follow r/LocalLLaMA on Reddit"* | `subscribe` |
  412. | *"Monitor Hacker News top stories"* | `subscribe` |
  413. | *"Watch anthropics/claude-code for new releases"* | `subscribe` |
  414. | *"Subscribe to @3Blue1Brown on YouTube"* | `subscribe` |
  415. | *"Follow @elonmusk on Twitter"* | `subscribe` |
  416. | *"Subscribe to the ML arXiv category"* | `subscribe` |
  417. | *"Check my feeds"* | `check_feeds` |
  418. | *"What's new in my subscriptions?"* | `check_feeds` |
  419. | *"Search my feeds for transformer architecture"* | `search_feeds` |
  420. | *"Show me the latest Reddit posts"* | `get_feed_items` |
  421. | *"What are my subscriptions?"* | `list_subscriptions` |
  422. | *"Unsubscribe from BBC News"* | `unsubscribe` |
  423. ### Web Search
  424. | What you type | Tool called | Parameters used |
  425. |--------------|-------------|-----------------|
  426. | *"Search for the best Python web frameworks"* | `google_search` | `query` |
  427. | *"Find Reddit discussions about home lab setups"* | `google_search` | `query` + `site="reddit.com"` |
  428. | *"Search Stack Overflow for async Python examples"* | `google_search` | `query` + `site="stackoverflow.com"` |
  429. | *"What's new in AI this week?"* | `google_search` | `query` + `time_range="past_week"` |
  430. | *"Search Hacker News for posts about Rust"* | `google_search` | `query` + `site="news.ycombinator.com"` |
  431. | *"Get page 2 of results for ML tutorials"* | `google_search` | `query` + `page=2` |
  432. | *"Search for restaurants in Tokyo in Japanese"* | `google_search` | `query` + `language="ja"` + `region="jp"` |
  433. ### Shopping & Travel
  434. | What you type | Tool called |
  435. |--------------|-------------|
  436. | *"Find the cheapest MacBook Air"* | `google_shopping` |
  437. | *"Find flights from New York to London"* | `google_flights` |
  438. | *"Find hotels in Paris for next weekend"* | `google_hotels` |
  439. | *"Translate 'hello world' to Japanese"* | `google_translate` |
  440. ### Maps & Directions
  441. | What you type | Tool called |
  442. |--------------|-------------|
  443. | *"Find Italian restaurants near Times Square"* | `google_maps` |
  444. | *"Get directions from Berlin to Munich"* | `google_maps_directions` |
  445. | *"Walking directions from the Eiffel Tower to the Louvre"* | `google_maps_directions` |
  446. ### Finance, Weather & Info
  447. | What you type | Tool called |
  448. |--------------|-------------|
  449. | *"What's Apple's stock price?"* | `google_finance` |
  450. | *"What's the weather in Dubai?"* | `google_weather` |
  451. | *"What are today's top headlines?"* | `google_news` |
  452. | *"Find papers on transformer attention mechanisms"* | `google_scholar` |
  453. | *"Find books about machine learning"* | `google_books` |
  454. ### Images & Vision
  455. | What you type | Tool called |
  456. |--------------|-------------|
  457. | *"Show me images of the Northern Lights"* | `google_images` |
  458. | *"What is this product? /path/to/photo.jpg"* | `google_lens` |
  459. | *"Detect all objects in this photo"* | `google_lens_detect` |
  460. | *"Read the text in this screenshot"* | `ocr_image` |
  461. | Drag image into chat + *"What is this?"* | `google_lens` |
  462. | Drag image into chat + *"Read the text"* | `ocr_image` |
  463. > **Tip:** To enable drag-and-drop images with text-only models in LM Studio, add a `model.yaml` file in the model directory with `metadataOverrides: { vision: true }`. The image will be sent as base64 and the MCP tools handle it automatically.
  464. ### Video Intelligence & AI-Powered Clip Extraction
  465. | What you type | Tool called |
  466. |--------------|-------------|
  467. | *"Transcribe this video: https://youtube.com/watch?v=..."* | `transcribe_video` |
  468. | *"What do they discuss in this video?"* | `transcribe_video` |
  469. | *"Find where they talk about memory bandwidth"* | `search_transcript` |
  470. | *"Extract the part where they discuss pricing"* | `extract_video_clip` |
  471. | *"Cut a clip of the hardware comparison section"* | `extract_video_clip` |
  472. | *"Transcribe ~/meeting.mp3"* | `transcribe_local` |
  473. | *"Convert video.mp4 to mp3"* | `convert_media` |
  474. | *"Convert this video to a GIF"* | `convert_media` |
  475. ### Documents & Email
  476. | What you type | Tool called |
  477. |--------------|-------------|
  478. | *"Read this PDF: ~/report.pdf"* | `read_document` |
  479. | *"Extract text from ~/contract.docx"* | `read_document` |
  480. | *"Read this article for me: https://..."* | `visit_page` |
  481. | *"Check my email at user@gmail.com password: xxxx"* | `fetch_emails` |
  482. | *"Pull my latest 10 emails from Outlook"* | `fetch_emails` |
  483. ### Web Utilities & Cloud
  484. | What you type | Tool called |
  485. |--------------|-------------|
  486. | *"Shorten this URL: https://very-long-url..."* | `shorten_url` |
  487. | *"Generate a QR code for https://mysite.com"* | `generate_qr` |
  488. | *"Make a QR code for my Wi-Fi network"* | `generate_qr` |
  489. | *"Post this code to a pastebin"* | `paste_text` |
  490. | *"Archive this article: https://news.example.com/story"* | `archive_webpage` |
  491. | *"Wikipedia: quantum computing"* | `wikipedia` |
  492. | *"Look up the Apollo 11 mission on Wikipedia in German"* | `wikipedia` |
  493. | *"Upload report.pdf to my MinIO bucket"* | `upload_to_s3` |
  494. | *"Store backup.tar.gz in S3 bucket my-backups"* | `upload_to_s3` |
  495. ---
  496. ## Installation
  497. ### Quick Install (pipx - recommended)
  498. ```bash
  499. pipx install noapi-google-search-mcp
  500. playwright install chromium
  501. ```
  502. ### Install in a Virtual Environment
  503. ```bash
  504. python3 -m venv ~/.local/share/noapi-google-search-mcp
  505. ~/.local/share/noapi-google-search-mcp/bin/pip install noapi-google-search-mcp
  506. ~/.local/share/noapi-google-search-mcp/bin/playwright install chromium
  507. ```
  508. ### Python 3.13 / OCR
  509. The core package installs on every supported Python, including 3.13. OCR is
  510. opt-in because `rapidocr-onnxruntime` does not yet ship a Python 3.13 wheel
  511. upstream ([RapidAI/RapidOCR#579](https://github.com/RapidAI/RapidOCR/issues/579)).
  512. Everything except the OCR tools (`ocr_image` and the scanned-PDF fallback in
  513. `read_document`) works without it.
  514. To enable OCR, add the `[ocr]` extra on a compatible Python (3.10–3.12):
  515. ```bash
  516. pipx install "noapi-google-search-mcp[ocr]"
  517. ```
  518. If you install the core package and later call an OCR tool without the extra,
  519. the tool returns a short message telling you to install
  520. `"noapi-google-search-mcp[ocr]"` instead of crashing.
  521. ## Configuration
  522. ### LM Studio
  523. Add to `~/.lmstudio/mcp.json`:
  524. ```json
  525. {
  526. "mcpServers": {
  527. "google-search": {
  528. "command": "noapi-google-search-mcp",
  529. "env": {
  530. "PYTHONUNBUFFERED": "1"
  531. }
  532. }
  533. }
  534. }
  535. ```
  536. If installed in a venv, use the full path: `~/.local/share/noapi-google-search-mcp/bin/noapi-google-search-mcp`
  537. ### How much page text `visit_page` returns
  538. `visit_page` truncates at **8000 characters** by default. That suits a small
  539. local model and is not enough for reading long documentation, so it is
  540. settable from the same `env` block:
  541. ```json
  542. {
  543. "mcpServers": {
  544. "google-search": {
  545. "command": "noapi-google-search-mcp",
  546. "env": {
  547. "PYTHONUNBUFFERED": "1",
  548. "MAX_PAGE_CHARS": "20000"
  549. }
  550. }
  551. }
  552. }
  553. ```
  554. `max_characters` is accepted as an alias. Values are clamped to 200000 —
  555. this text goes into a model's context window, and a tool that can return a
  556. megabyte turns one careless page visit into a blown context. A value that
  557. is not a positive number is ignored and the default is used, so a typo here
  558. cannot stop the server from starting.
  559. ### Claude Desktop
  560. Add to your Claude Desktop config (`claude_desktop_config.json`):
  561. ```json
  562. {
  563. "mcpServers": {
  564. "google-search": {
  565. "command": "noapi-google-search-mcp"
  566. }
  567. }
  568. }
  569. ```
  570. ### OpenClaw
  571. Add to your agent configuration:
  572. ```yaml
  573. mcp_servers:
  574. google-search:
  575. command: "noapi-google-search-mcp"
  576. env:
  577. PYTHONUNBUFFERED: "1"
  578. ```
  579. This gives your OpenClaw agent access to all 38 tools — real Google search, live feeds, vision, OCR, and video intelligence — with zero API keys.
  580. ### As a CLI
  581. ```bash
  582. noapi-google-search-mcp
  583. ```
  584. Or:
  585. ```bash
  586. python -m google_search_mcp
  587. ```
  588. ## Development
  589. ```bash
  590. git clone https://github.com/VincentKaufmann/noapi-google-search-mcp.git
  591. cd google-search-mcp
  592. pip install -e .
  593. playwright install chromium
  594. ```
  595. ## License
  596. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.