gsearch — MCP-сервер для Claude Code: поиск и установка
MCP-сервер подключает Google Search к ИИ-агенту и возвращает реальные URL, AI Overview и People also ask в JSON. Пригодится для поиска по актуальному индексу Google.
claude mcp add --env GSEARCH_PROXY=<GSEARCH_PROXY> --env GSEARCH_DATA_LIMIT_MB=<GSEARCH_DATA_LIMIT_MB> --transport stdio gsearch -- uvx gsearch-agentЧто делает gsearch
gsearch запускает Google Search через MCP-инструмент google_search. Агент получает ссылки с реальными URL, блок AI Overview, блок People also ask и связанные запросы в JSON. Сервер работает локально, использует браузер Camoufox и не требует API-ключа.
Для установки нужны Python 3.12+ и uvx; браузер загружается отдельно через gsearch setup и занимает около ~1 GB. Без прокси запросы идут с вашего IP и ограничены 20 поисками в час. Автоматический доступ к Google может нарушать Terms of Service, поэтому это ограничение касается самого запуска.
Какие задачи решает
- найти страницы через индекс Google
- получить реальные URL из результатов поиска
- передать агенту блок AI Overview
- собрать вопросы из People also ask
- найти страницы домена за последний год
Примеры запросов агенту
- Поищи в Google, что такое asyncio, и дай первые три ссылки.
- Покажи, о чём люди спрашивают в блоке People also ask по asyncio.
- Найди страницы про asyncio на
python.orgза последний год.
Как установить gsearch
Командой платформы
claude mcp add --env GSEARCH_PROXY=<GSEARCH_PROXY> --env GSEARCH_DATA_LIMIT_MB=<GSEARCH_DATA_LIMIT_MB> --transport stdio gsearch -- uvx gsearch-agentВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from gsearch-agent <команда>
Командой платформы
codex mcp add gsearch --env GSEARCH_PROXY=<GSEARCH_PROXY> --env GSEARCH_DATA_LIMIT_MB=<GSEARCH_DATA_LIMIT_MB> -- uvx gsearch-agentВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from gsearch-agent <команда>
Файл настроек
{
"mcpServers": {
"gsearch": {
"command": "uvx",
"args": [
"gsearch-agent"
],
"env": {
"GSEARCH_PROXY": "<GSEARCH_PROXY>",
"GSEARCH_DATA_LIMIT_MB": "<GSEARCH_DATA_LIMIT_MB>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from gsearch-agent <команда>
Файл настроек
{
"servers": {
"gsearch": {
"type": "stdio",
"command": "uvx",
"args": [
"gsearch-agent"
],
"env": {
"GSEARCH_PROXY": "<GSEARCH_PROXY>",
"GSEARCH_DATA_LIMIT_MB": "<GSEARCH_DATA_LIMIT_MB>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from gsearch-agent <команда>
Командой платформы
gemini mcp add -e GSEARCH_PROXY=<GSEARCH_PROXY> -e GSEARCH_DATA_LIMIT_MB=<GSEARCH_DATA_LIMIT_MB> gsearch uvx gsearch-agentВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from gsearch-agent <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о gsearch
Как установить gsearch в Claude Code?
Выполните claude mcp add gsearch -e GSEARCH_PROXY=<GSEARCH_PROXY> -- uvx gsearch-agent.
Что делает gsearch?
Он даёт агенту доступ к Google Search через MCP и возвращает результаты с реальными URL, AI Overview и People also ask в JSON.
Нужен ли gsearch API-ключ или прокси?
API-ключ не нужен. Прокси необязателен, но без него сервер использует ваш IP и допускает не более 20 поисков в час.
