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.

Настройка клиентов

cursor
{
    "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.

Похожие серверы — в категории браузер и парсинг.

Установка

  1. Установите пакет: npm install -g agentql-mcp.
  2. Получите ключ API в портале разработчика AgentQL (dev.agentql.com).
  3. Добавьте сервер в клиент и передайте ключ в переменной окружения 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

Браузерные агенты и облачные браузеры для ИИ: выполнение задач на сайтах, заполнение форм и извлечение данных.

Риск: medium Лицензия: MIT ★ 121 451

Fetch

Эталонный сервер для загрузки веб-страниц и их преобразования в удобный для модели текст.

Риск: medium Лицензия: NOASSERTION ★ 92 089

Chrome DevTools MCP

Chrome DevTools для агентов: управление Chrome, отладка, сеть, консоль и замеры производительности.

Риск: medium Лицензия: Apache-2.0 ★ 55 015

browser

Безголовый браузер для ИИ и веб-автоматизации со встроенным MCP-сервером.

Риск: medium Лицензия: AGPL-3.0 ★ 41 461

Источники