# Or using npx npx google-search-cli "search keywords" # Run in development mode pnpm dev "search keywords" # Run in debug mode (showing browser interface) pnpm debug "search keywords" # Get raw HTML of search result page google-search "search keywords" --get-html # Get HTML and save to file google-search "search keywords" --get-html --save-html # Get HTML and save to specific file google-search "search keywords" --get-html --save-html --html-output "./output.html" ``` #### Command Line Options - `-l, --limit `: Result count limit (default: 10) - `-t, --timeout `: Timeout in milliseconds (default: 60000) - `--no-headless`: Show browser interface (for debugging) - `--remote-debugging-port `: Enable remote debugging port (default: 9222) - `--state-file `: Browser state file path (default: ./browser-state.json) - `--no-save-state`: Don't save browser state - `--get-html`: Retrieve raw HTML of search result page instead of parsing results - `--save-html`: Save HTML to file (used with --get-html) - `--html-output `: Specify HTML output file path (used with --get-html and --save-html) - `-V, --version`: Display version number - `-h, --help`: Display help information #### Output Example ```json { "query": "deepseek", "results": [ { "title": "DeepSeek", "link": "https://www.deepseek.com/", "snippet": "DeepSeek-R1 is now live and open source, rivaling OpenAI's Model o1. Available on web, app, and API. Click for details. Into ..." }, { "title": "DeepSeek", "link": "https://www.deepseek.com/", "snippet": "DeepSeek-R1 is now live and open source, rivaling OpenAI's Model o1. Available on web, app, and API. Click for details. Into ..." }, { "title": "deepseek-ai/DeepSeek-V3", "link": "https://github.com/deepseek-ai/DeepSeek-V3", "snippet": "We present DeepSeek-V3, a strong Mixture-of-Experts (MoE) language model with 671B total parameters with 37B activated for each token." } // More results... ] } ``` #### HTML Output Example When using the `--get-html` option, the output will include information about the HTML content: ```json { "query": "playwright automation", "url": "https://www.google.com/", "originalHtmlLength": 1291733, "cleanedHtmlLength": 456789, "htmlPreview": "..." } ``` If you also use the `--save-html` option, the output will include the path where the HTML was saved: ```json { "query": "playwright automation", "url": "https://www.google.com/", "originalHtmlLength": 1292241, "cleanedHtmlLength": 458976, "savedPath": "./google-search-html/playwright_automation-2025-04-06T03-30-06-852Z.html", "screenshotPath": "./google-search-html/playwright_automation-2025-04-06T03-30-06-852Z.png", "htmlPreview": "..." } ``` ### MCP Server This project provides Model Context Protocol (MCP) server functionality, allowing AI assistants like Claude to directly use Google search capabilities. MCP is an open protocol that enables AI assistants to safely access external tools and data. ```bash # Build the project pnpm build ``` #### Integration with Claude Desktop 1. Edit the Claude Desktop configuration file: - Mac: `~/Library/Application Support/Claude/claude_desktop_config.json` - Windows: `%APPDATA%\Claude\claude_desktop_config.json` - Usually located at `C:\Users\username\AppData\Roaming\Claude\claude_desktop_config.json` - You can access it directly by entering `%APPDATA%\Claude` in Windows Explorer address bar 2. Add server configuration and restart Claude ```json { "mcpServers": { "google-search": { "command": "npx", "args": ["google-search-mcp"] } } } ``` For Windows environments, you can also use the following

Google Search Tool

Comments