Google WebMCP

Use this skill to operate Google Search and Gemini through the built-in --site google bridge preset in @webmcp-bridge/local-mcp.

For generic bridge setup patterns or non-Google sites, switch to $webmcp-bridge.

Prerequisites

• uxc is installed and available in PATH.
• npx is installed and available in PATH.
• Network access to https://www.google.com and https://gemini.google.com.
• On a fresh machine, or under an isolated HOME, install Playwright browsers first with npx playwright install.
• Gemini is auth-sensitive. Expect bootstrapthenattach behavior when the profile is not signed in yet.

Core Workflow

1. Ensure the fixed Google link exists:

- command -v google-webmcp-cli - if missing or pointed at the wrong profile, run skills/google-webmcp/scripts/ensure-links.sh

1. Inspect the bridge and tool schema before calling tools:

- google-webmcp-cli -h - google-webmcp-cli search.web -h - google-webmcp-cli gemini.chat -h - google-webmcp-cli gemini.image.download -h

1. Check authentication state first when Gemini may need sign-in:

- google-webmcp-cli bridge.session.status - google-webmcp-cli auth.get - if the session is not ready, start bootstrap or switch to headed: - google-webmcp-cli bridge.session.bootstrap - google-webmcp-cli bridge.session.mode.set '{"mode":"headed"}' - google-webmcp-cli bridge.open

1. Use search tools for public search results:

- google-webmcp-cli search.web '{"query":"playwright browser automation","limit":10}' - google-webmcp-cli page.get

1. Use Gemini through the same authenticated browser profile:

- text: google-webmcp-cli gemini.chat '{"prompt":"Summarize these results","mode":"text","timeoutMs":180000}' - image: google-webmcp-cli gemini.chat '{"prompt":"a watercolor fox reading documentation","mode":"image","timeoutMs":300000}' - download current visible images: google-webmcp-cli gemini.image.download '{"limit":4,"timeoutMs":120000}'

1. Use debug and navigation helpers only when necessary:

- google-webmcp-cli page.navigate '{"url":"https://gemini.google.com/app"}'; - google-webmcp-cli page.inspect '{"limit":20}'

1. Parse JSON output only:

- success path: .ok == true, consume .data - failure path: .ok == false, inspect .error.code and .error.message

Default Target

The built-in preset uses:

--site google

The default profile path is:

~/.uxc/webmcp-profile/google

Refresh the link with:

skills/google-webmcp/scripts/ensure-links.sh

Guardrails

• Keep the Google profile isolated from other sites.
• Google uses bootstrapthenattach; do not expect Gemini tools to work until the managed profile is authenticated.
• Prefer explicit bridge.session.mode.set over relaunching the command to change runtime mode.
• Long Gemini generations can legitimately take minutes. Increase timeoutMs instead of spawning parallel retries.
• gemini.image.download works on visible generated images in the current or target conversation. Do not assume it can recover images that are no longer visible.
• page.navigate must stay on Google-owned hosts only.
• If the user closes the visible Google window manually, the headed owner session ends. Run google-webmcp-cli bridge.open again if you still need a visible session on the same profile.

References

• Common command patterns:

- references/usage-patterns.md

• Link creation helper:

- scripts/ensure-links.sh