FrankenSurf — MCP-сервер для Claude Code: что делает и как установить
Читает любую страницу и ищет в вебе через 28 инструментов. Пробует сначала бесплатные, переходит к платным только если сайт блокирует, проверяет каждую страницу и возвращает чистые данные с чеком попыток.
claude mcp add frankensurf -- uvx frankensurfЧто делает FrankenSurf
FrankenSurf пробует 41 способ извлечь контент: обычный HTTP, Jina Reader, локальный браузер, стелс-браузеры, хостинговые сервисы и платные API — в порядке возрастания цены. Каждый результат проверяется: страница с капчей, логином или пустая выдача поиска считается провалом. Вызов read() возвращает текст или markdown, JSON-LD, изображения и детальный отчёт — какие инструменты запустились, сколько времени заняли, что стоили и почему остановились.
Работает как MCP-сервер для агентов, как Python-библиотека (fs.read(url), fs.search(), fs.crawl()), как Docker-контейнер и как замена Firecrawl API для LangChain, n8n, Dify и других систем. Без Docker: pip install "frankensurf[mcp]", затем frankensurf install ставит браузеры, стелс-инструменты и Crawl4AI локально. Для работы нужен Python 3.12+ на Linux, macOS или WSL.
Бенчмарк на 150 сайтах: бесплатные инструменты прочли 88%, FrankenSurf с платными фоллбэками — 96%, Zyte — 86%, Firecrawl — 85%. Стоимость на 1000 прочтённых страниц с бесплатными инструментами $0 комиссий плюс около $0,01 серверного времени, с платными — $0,22.
Какие задачи решает
- прочесть страницу с капчей или антиботом
- найти в вебе свежие данные за последний месяц или неделю
- обойти 41 способом блокировку и вернуть детальный отчёт попыток
- запустить поиск и извлечение контента из Python, Docker или как MCP-сервер
- заменить Firecrawl API в LangChain, n8n или Dify
Примеры запросов агенту
- Прочти
https://www.walmart.com/search?q=air+fryerи покажи заголовок - Найди свежие статьи по запросу «playwright python tutorial» за последнюю неделю
- Обойди эту страницу через все доступные инструменты и покажи чек попыток
Как установить FrankenSurf
Командой платформы
claude mcp add frankensurf -- uvx frankensurfuvx запускает команду с именем пакета; если в README она другая — uvx --from frankensurf <команда>
Командой платформы
codex mcp add frankensurf -- uvx frankensurfuvx запускает команду с именем пакета; если в README она другая — uvx --from frankensurf <команда>
Файл настроек
{
"mcpServers": {
"frankensurf": {
"command": "uvx",
"args": [
"frankensurf"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from frankensurf <команда>
Файл настроек
{
"servers": {
"frankensurf": {
"type": "stdio",
"command": "uvx",
"args": [
"frankensurf"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from frankensurf <команда>
Командой платформы
gemini mcp add frankensurf uvx frankensurfuvx запускает команду с именем пакета; если в README она другая — uvx --from frankensurf <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о FrankenSurf
Как установить FrankenSurf в Claude Code?
Выполни claude mcp add frankensurf -- uvx frankensurf. Команда добавит MCP-сервер в конфигурацию Claude Code и запустит его через uvx.
Что делает FrankenSurf?
Читает веб-страницы и ищет в интернете через 28 инструментов — от простого HTTP до платных API. Пробует сначала самые дешёвые, проверяет каждую страницу на капчи и пустые результаты, переходит к следующему инструменту только при блокировке. Возвращает текст, markdown, JSON и отчёт — какие инструменты запустились, сколько стоили и почему остановились.
Какие зависимости нужны для FrankenSurf?
Python 3.12 или выше на Linux, macOS или Windows через WSL. После pip install "frankensurf[mcp]" запусти frankensurf install, чтобы поставить браузеры, стелс-инструменты и Crawl4AI локально. Для работы платных фоллбэков понадобятся ключи API (но они опциональны).
