# Gsearch

> This skill should be used when the user asks to "search google", "find information online", "search the web", or needs real-time, grounded information from the internet.

- Skill: `dqtx760/gsearch` (Agent Skill)
- Install (CLI): `npx skillmds@latest add dqtx760/gsearch`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dqtx760/gsearch/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: dqtx760 (https://skillmd.com/u/dqtx760)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/dqtx760/gsearch

---


# Google Web Search CLI

A lightweight Rust binary for executing grounded Google Web Searches via the Gemini API. Use this instead of MCP-based search servers — it connects using the shared `gemini-cli` OAuth credentials, requires no background server process, and consumes very few tokens.

## Prerequisites

If no valid OAuth token is found, the CLI will automatically trigger the login flow and open Chrome for authentication.
```bash
# To force a login flow manually:
gsearch --login
```

## Core workflow

Run the `gsearch` command followed by your search query. Do not use quotes around the query unless necessary; the CLI handles spaced arguments automatically.

```bash
gsearch latest news about rust programming language
```

## Commands

### Search
```bash
gsearch <query...>          # Search Google and return summarized results
```

### Authentication
```bash
gsearch --login            # Refresh or initiate OAuth authentication
```

## Output Format

The binary returns a concise, summarized answer generated by Gemini, followed by a list of source citations mapping directly to markers in the text (e.g. `[1]`, `[2]`).

## Typical task pattern

1. Determine that external, up-to-date information is needed.
2. Formulate a precise search query.
3. `gsearch <query>` — execute the search.
4. Read the resulting summary and citations.
5. Use the provided information to fulfill the user's request, referencing the citations if helpful.