auth-fetch-mcp

MCP-сервер, который позволяет ИИ-ассистентам получать контент с веб-страниц, требующих авторизации.

Когда ваш ИИ пытается прочитать URL, требующий входа в систему, этот инструмент открывает настоящий браузер, чтобы вы могли войти, а затем захватывает содержимое страницы в виде очищенного HTML. Сессии сохраняются локально, поэтому вы входите в систему только один раз для каждого сервиса.

Демонстрация

Related MCP server: byob

Быстрый старт

Claude Code

claude mcp add --scope user auth-fetch -- npx auth-fetch-mcp@latest

.mcp.json (Cursor, Windsurf и др.)

{
  "mcpServers": {
    "auth-fetch": {
      "command": "npx",
      "args": ["auth-fetch-mcp@latest"]
    }
  }
}

Chromium автоматически устанавливается при первом запуске, если он еще не установлен.

Как это работает

1. Попросите ваш ИИ прочитать любую страницу, требующую авторизации — просто вставьте URL.

2. Автоматически откроется окно браузера и перейдет на нужную страницу.

3. Войдите в систему как обычно (поддерживаются SSO, 2FA, CAPTCHA — что угодно).

4. Нажмите кнопку "📸 Capture" в правом нижнем углу, когда будете готовы.

5. Содержимое страницы будет захвачено в виде очищенного HTML (шумовые элементы удалены, медиа-теги сохранены), браузер закроется, и ваш ИИ получит контент.

Инструменты

auth_fetch

Основной инструмент. Получает содержимое страницы с помощью настоящего браузера, открывая окно для входа, если это необходимо. Возвращает очищенный HTML с удаленными шумовыми элементами (навигация, футер, скрипты и т. д.) и сохраненными медиа-тегами (<img>, <video>, <iframe>).

download_media

Загружает файлы по URL, используя сохраненные сессии браузера. Используйте это для отложенной загрузки изображений, видео или других файлов, найденных в результатах auth_fetch. Сохраненные файлы cookie браузера автоматически обрабатывают аутентификацию — нет необходимости входить в систему снова.

Пример использования:

1. auth_fetch("https://notion.so/my-page")
   → Returns HTML with <img src="https://s3.notion.so/signed-url..."/> tags

2. AI reads the HTML, identifies an image it needs

3. download_media(["https://s3.notion.so/signed-url..."])
   → Downloads the image using saved session cookies
   → Returns { localPath: "~/.auth-fetch-mcp/downloads/.../file-1.png" }

list_pages

Выводит список всех открытых вкладок в браузере с их URL и заголовками.

close_browser

Закрывает окно браузера. Сессии входа сохраняются и будут повторно использованы в следующий раз.

Хранение данных

Все данные хранятся локально в ~/.auth-fetch-mcp/. Ничего не отправляется на внешние серверы.

Чтобы очистить все данные:

# Clear login sessions only
rm -rf ~/.auth-fetch-mcp/browser-data/

# Clear downloaded files only
rm -rf ~/.auth-fetch-mcp/downloads/

# Clear everything
rm -rf ~/.auth-fetch-mcp/

Поддерживаемые ИИ-инструменты

• Claude Code

• Cursor

• Windsurf

• Любой MCP-совместимый клиент, использующий транспорт stdio

Ограничения

• Требуется локальная среда (не работает в веб-интерфейсах чатов)

• Первый доступ к каждому сервису требует ручного входа

• Очень длинные страницы обрезаются, чтобы соответствовать контекстным окнам LLM (100 тыс. символов)

• Некоторые сайты с агрессивной защитой от ботов могут не работать (попробуйте опцию wait_for)

Конфиденциальность

• Все данные остаются на вашем компьютере — ничего не отправляется на внешние серверы

• Захваченный HTML никогда не записывается на диск — он проходит только через канал stdio к инструменту ИИ

• Сессии браузера хранятся локально как стандартный профиль Chromium

• Загруженные файлы попадают в локальную директорию, которую вы контролируете

Участие в разработке

Вклад приветствуется! Пожалуйста, откройте issue или отправьте pull request.

git clone https://github.com/ymw0407/auth-fetch-mcp.git
cd auth-fetch-mcp
npm install
npm run build

Лицензия

MIT