google-surf-mcp-search — Claude Code skill: setup and tools
google-surf-mcp-search — a skill configuring Google search without API keys alongside PDF extraction for academic papers. It strips search ads and handles CAPTCHAs via browser profiles.
no license 212 installs ★ 9 updated 2026-10-09
npx skills add reason-machines/mcp-skills --skill google-surf-mcp-search -a claude-codeWhat google-surf-mcp-search does
This skill integrates an MCP engine that queries Google directly through a real browser session. It strips sponsored links and search widgets using geometric layout checks. Results stay clean. You can also run batch queries across a worker pool supporting up to 10 queries simultaneously.
Web page scraping handles standard HTML alongside research PDFs from sources like arXiv, Nature, or PubMed. A dedicated triage mode limits output to roughly 1500 characters. That saves tokens. Full text mode remains available when complete document text is needed.
Execution depends on a local Chrome installation. The path is set through the CHROME_PATH variable. Persistent browser sessions live under ~/.google-surf-mcp, preventing recurring bot verification blocks.
What it helps with
- query Google search without managing paid API tokens
- pull text directly from online academic PDFs and arXiv papers
- strip sponsored ads and widget panels from search responses
- run up to 10 search queries in parallel within one step
Example prompts for the agent
- Search Google for recent papers on context window optimization and extract 1500-character abstracts
- Fetch the full article text from https://arxiv.org/pdf/2301.12345.pdf
- Run a parallel search for three different TypeScript caching strategies
How to install google-surf-mcp-search
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill google-surf-mcp-search -a claude-code2Manually: put the files in place
~/.claude/skills/google-surf-mcp-search/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/google-surf-mcp-search/
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill google-surf-mcp-search -a codex2Manually: put the files in place
.agents/skills/google-surf-mcp-search/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill google-surf-mcp-search -a cursor2Manually: put the files in place
.cursor/skills/google-surf-mcp-search/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install reason-machines/mcp-skills skills/google-surf-mcp-search2Manually: put the files in place
.github/skills/google-surf-mcp-search/SKILL.md1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill google-surf-mcp-search -a gemini-cli2Platform CLI
gemini skills install https://github.com/reason-machines/mcp-skills --path skills/google-surf-mcp-searchManually: put the files in place
.devin/skills/google-surf-mcp-search/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill google-surf-mcp-search -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about google-surf-mcp-search
How to install google-surf-mcp-search in Claude Code?
Run npx skills add reason-machines/mcp-skills --skill google-surf-mcp-search -a claude-code in your terminal. It stores the skill file at ~/.claude/skills/google-surf-mcp-search/SKILL.md.
Does this search require an official Google API key?
No API key is needed. The server automates live browser lookups and removes sponsored elements on its own.
What happens if Google triggers a CAPTCHA challenge?
Browser profiles persist inside ~/.google-surf-mcp. Setting SURF_HEADLESS=false opens a visible browser window so you can solve checks manually.