PageMap

PageMap

Retio-aiNOASSERTION
32 звёзд5 форков
PageMap — это MCP-сервер для работы с веб-страницами. Он перерабатывает сырой HTML (100 000+ токенов) в компактную структурированную карту размером 2–5 тысяч токенов. Это снижает расход токенов на 97% по сравнению с прямым чтением HTML или использованием снапшотов Playwright. Сервер создан для разработчиков, которые строят ИИ-агентов на базе Claude, Copilot, Cursor или других LLM. PageMap даёт агенту не только зрение — умение читать страницу, но и руки: кликать по кнопкам, заполнять формы и переходить по ссылкам. Контекстное окно агента не переполняется даже после десятков шагов. Эффективность подтверждена бенчмарком на 11 сайтах: 84,7% успешных выполнений задач при средней стоимости $1,06 за 94 сценария.
Ai-mlBrowserPlaywright
Открыть на GitHub

Установка

uvx retio-pagemap

Характеристики

Общее

  • СтатусСообщество
  • РазработчикRetio-ai
  • ЛицензияNOASSERTION

Технологии

  • Языки
    Python
  • Транспорт
    stdio

Описание

Возможности

  • Сжимает HTML страницы в структурированную карту размером 2–5K токенов (снижение на 97%).
  • Распознаёт 16 типов страниц и корректно обрабатывает 30+ сайтов электронной коммерции.
  • Включает 13 MCP-инструментов: чтение контента, клик, ввод текста, выбор элементов, наведение мыши.
  • Не ограничивает число страниц в сессии — контекст не переполняется.
  • Достигает 84,7% успешности в тестовом запуске 94 задач на 11 сайтах.
  • Сокращает средний расход токенов на задачу до 2 710 — в 5 раз меньше, чем Playwright MCP (13 737).
  • Стоимость выполнения 94 задач — $1,06 (у Firecrawl — $3,98, у Playwright MCP — $4,09).
  • Автоматически устанавливает Chromium при первом запуске — не требует ручной команды playwright install.
  • Работает как MCP-сервер, Python SDK и CLI-утилита — гибкие варианты интеграции.
  • Поддерживает транспорты stdio и HTTP (через Docker).

Как подключить

Установите пакет через менеджер пакетов uv:

pip install retio-pagemap

Добавьте сервер в конфигурацию вашего MCP-клиента. Пример для Claude Desktop:

{ "mcpServers": { "pagemap": { "command": "uvx", "args": ["retio-pagemap"] } } }

В VS Code (Copilot) используйте файл .vscode/mcp.json и замените "mcpServers" на "servers". В macOS укажите абсолютный путь к uvx — его можно узнать командой which uvx.

Если предпочитаете Docker, запустите контейнер и подключитесь по HTTP:

docker run -p 8000:8000 retio1001/pagemap --transport http

После обновления конфигурации перезапустите клиент. Сервер готов к работе.

Примеры запросов

  • «Открой сайт example.com и извлеки заголовки всех карточек товаров на странице.»
  • «Перейди в корзину на сайте example.com и скажи, какая итоговая сумма заказа.»
  • «Проверь форму поиска: введи запрос 'ноутбук' и убедись, что страница результатов загрузилась.»
  • «Собери все контактные данные из футера: телефон, email, ссылки на соцсети.»

Технические детали

  • Язык: Python
  • Транспорт: stdio (также доступен HTTP через Docker)
  • Лицензия: AGPL-3.0
  • Совместимые клиенты: Claude Desktop, VS Code (Copilot), Cursor, Windsurf
  • Разработчик: Retio-ai
  • Форматы: MCP-сервер, Python SDK, CLI

Поделиться