agentql-mcp
agentql-mcp — официальный MCP-сервер от tinyfish-io. Извлечение данных со страниц с помощью AgentQL. Ставится через npx. Лицензия MIT.
Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026
Кратко о сервере
- Разработчик
- tinyfish-io
- Лицензия
- MIT
- Транспорт
- stdio
- Авторизация
- api_key
- ОС
- Не указана
- Языки
- typescript
Уровень риска: medium
Отправляет адреса страниц и описания данных в сервис AgentQL, использует ключ API.
Настройка клиентов
{
"code": "env AGENTQL_API_KEY=YOUR_API_KEY npx -y agentql-mcp",
"lang": "bash",
"notes": "Тип command в настройках MCP",
"verified": "docs"
}
Что умеет
AgentQL MCP — сервер Model Context Protocol, который подключает к ИИ-агенту возможности извлечения данных сервиса AgentQL. Он даёт один инструмент:
extract-web-data— извлекает структурированные данные со страницы по адресуurl. В параметреpromptвы описываете, какие данные нужны и из каких полей они состоят.
То есть агенту не нужно самому открывать страницу и разбирать её разметку: вы описываете результат словами («список товаров с названием, ценой и ссылкой»), а сервер возвращает данные в структурированном виде. Страницу обрабатывает сервис AgentQL, поэтому нужен ключ API из его портала разработчика.
Кому подойдёт
- Аналитикам и маркетологам, которым нужно быстро собрать таблицу с веб-страницы: товары, цены, видео, отзывы.
- Разработчикам агентов, которым нужен готовый инструмент извлечения данных без своего парсера.
- Исследователям, превращающим страницы со списками в таблицы Markdown.
Похожие серверы — в категории браузер и парсинг.
Установка
- Установите пакет:
npm install -g agentql-mcp. - Получите ключ API в портале разработчика AgentQL (dev.agentql.com).
- Добавьте сервер в клиент и передайте ключ в переменной окружения
AGENTQL_API_KEY.
Для разработки сервера в репозитории есть команды npm run build, npm run watch и npm run inspector (MCP Inspector).
Подключение к клиентам
Конфиги приведены дословно из README. Подробнее — в инструкции как подключить MCP.
{
"mcpServers": {
"agentql": {
"command": "npx",
"args": ["-y", "agentql-mcp"],
"env": {
"AGENTQL_API_KEY": "YOUR_API_KEY"
}
}
}
}Для Claude Desktop откройте «Settings → Developer → Edit Config» и добавьте блок в claude_desktop_config.json, затем перезапустите приложение. Тот же блок подходит для Windsurf: файл ~/.codeium/windsurf/mcp_config.json. В VS Code конфиг кладётся в .vscode/mcp.json рабочей папки — ключ будет запрошен при запуске и не попадёт в файл. В Cursor откройте «Cursor Settings → MCP → Add new MCP Server», выберите тип command и вставьте команду, заменив YOUR_API_KEY своим ключом.
Проверка
Дайте агенту задачу, для которой нужно извлечь данные из веба, например собрать список видео со страницы поиска YouTube с названием, автором, числом просмотров и ссылкой. Если агент отвечает, что не может открыть страницу, добавьте в запрос подсказку «используй инструмент agentql».
Примеры задач
Извлеки со страницы каталога список товаров: название, цена, ссылка. Оформи таблицей Markdown.Собери с этой страницы все вакансии: должность, город, зарплата.Риски
- Ключ API. Храните
AGENTQL_API_KEYв переменных окружения или в запросе VS Code, не коммитьте его в репозиторий. - Сеть и сторонний сервис. Адреса страниц и ваши описания данных отправляются в AgentQL; запросы расходуют лимиты вашего аккаунта.
- Данные со страниц могут содержать недостоверный текст или скрытые инструкции — проверяйте результат.
Частые вопросы
Нужен ли платный аккаунт AgentQL?
Нужен ключ API из портала разработчика AgentQL; условия тарифов в README не описаны.
Сколько инструментов у сервера?
Один — extract-web-data.
Можно ли запустить сборку из исходников?
Да, после npm run build укажите в конфиге путь к dist/index.js вместо npx.
Основы протокола — на странице что такое MCP-сервер.
Похожие MCP-серверы
browser-use
Браузерные агенты и облачные браузеры для ИИ: выполнение задач на сайтах, заполнение форм и извлечение данных.
Fetch
Эталонный сервер для загрузки веб-страниц и их преобразования в удобный для модели текст.
Chrome DevTools MCP
Chrome DevTools для агентов: управление Chrome, отладка, сеть, консоль и замеры производительности.
browser
Безголовый браузер для ИИ и веб-автоматизации со встроенным MCP-сервером.