mendableai/firecrawl-mcp-server

Запускает асинхронную задачу веб-исследования на основе запроса, необязательных стартовых URL и необязательной JSON-схемы. Используйте его, когда нужен синтез информации из нескольких источников и задача может дождаться асинхронного завершения. Агент умеет искать, переходить по ссылкам, читать страницы и собирать структурированный результат. Этот вызов возвращает только идентификатор задачи, без самого результата исследования. Следите за задачей через firecrawl_agent_status, пока она не достигнет статуса completed или failed; исследование обычно занимает несколько минут. Если задача не успевает завершиться в отведённое время, firecrawl_search и firecrawl_scrape могут собрать материалы синхронно.

Получает прогресс или итоговые результаты по идентификатору задания firecrawl_agent. Ответ processing не окончателен и не содержит итогового результата исследования. Проверяйте снова через 15–30 секунд, пока статус не станет completed или failed; сложные задания могут занимать несколько минут. Если задание не успевает завершиться за отведённое время, используйте firecrawl_search и firecrawl_scrape, чтобы получить запрошенный результат. Возвращает статус задания, информацию о прогрессе и данные результата после завершения.

Получает текущий статус, прогресс и доступные результаты для существующего crawl ID. Этот инструмент только считывает состояние задания Firecrawl и не запускает и не изменяет обход.

Запускает многопостраничный обход по URL веб-сайта, опрашивает его до конечного состояния и возвращает итоговый статус и собранные данные. Область обхода можно ограничить с помощью путей включения/исключения, глубины, лимита страниц, управления поддоменами и внешними ссылками, обработки sitemap, задержки и параметров парсинга. Результаты обхода могут быть большими; используйте консервативные лимиты, когда полное покрытие сайта не требуется. Вебхуки и интерактивные действия парсинга недоступны в безопасном режиме. Возвращает идентификатор обхода, статус и данные страниц.

Выполняет поиск по индексу, созданному для агентов кодирования, для вопросов разработчика: поведение кода, библиотека или фреймворк, контракт API, сообщение об ошибке или известная ошибка. Индекс охватывает issues GitHub, объединенные pull request, README-файлы репозиториев и курируемые сайты документации. Установите параметр skills в значение "only", чтобы ограничить поиск файлами agent-skill. Возвращает ранжированные результаты с ID, типом источника, URL, заголовком и совпадающими фрагментами в Markdown.

Устаревшая точка входа для совместимости. Используйте firecrawl_scrape по одному разу для каждого известного URL с форматами: ["json"] и jsonOptions, содержащими prompt и schema. Используйте firecrawl_search или firecrawl_agent перед Scrape, когда URL неизвестны.

Отправляет краткую оценку качества для завершённого задания поиска, скрейпинга, парсинга или картирования. Указывает endpoint, ID задания, оценку и релевантные коды проблем или небольшие контекстные поля; опускает большие фрагменты содержимого страниц и необработанные результаты. Возвращает статус отправки, ID отзыва и учётные поля.

Открывает или повторно использует активный сеанс браузера, чтобы перейти на страницу, нажать на элементы управления, заполнить поля или выполнить браузерный код. Укажите либо url, либо scrapeId, а также либо prompt на естественном языке, либо исполняемый code; код может выполняться как Bash, Python или Node с ограниченным таймаутом. Этот инструмент действует на реальном сайте, поэтому такие действия, как отправка формы, могут создавать постоянные внешние побочные эффекты. Возвращает результаты выполнения, stdout/stderr, код выхода и URL-адреса для просмотра сеанса.

Останавливает активную сессию взаимодействия, связанную с scrapeId, и освобождает её ресурсы. Возвращает подтверждение об успешном выполнении.

Перечисляет URL-адреса, проиндексированные на одном сайте, через Firecrawl, не загружая содержимое каждой страницы. Используйте этот инструмент, когда запрос требует перечень URL-адресов сайта, когда нужно найти несколько подходящих страниц или когда URL нужной страницы неизвестен. Необязательный параметр search сужает список URL-адресов, а опции sitemap, subdomain, query-parameter и result-limit управляют охватом. Возвращает подходящие URL-адреса, а не содержимое страниц. Получите одну страницу с помощью firecrawl_scrape; соберите содержимое с нескольких страниц с помощью firecrawl_crawl.

Получает одну проверку мониторинга и её результаты на уровне страниц, при необходимости фильтруя по статусу страницы. Страницы сообщают статус same, new, changed, removed или error; настроенная оценка целей может добавить решение о значимости изменения. Markdown-отслеживание возвращает единый текстовый diff, JSON-отслеживание возвращает пути полей с предыдущими и текущими значениями и текущий снимок, а смешанное отслеживание возвращает оба варианта. Возвращает одну страницу результатов и URL next, если есть ещё страницы.

Перечисляет исторические проверки монитора, при необходимости фильтруя их по статусу и ограничивая количество результатов. Возвращает одну страницу сводок проверок и метаданные пагинации.

Создаёт периодический монитор для скрейпинга, обхода или поиска, который сравнивает каждую проверку с предыдущей. Простая форма принимает page/pages или queries, а также goal, сформулированный обычным языком; расширенная форма body управляет целями, расписанием, форматами отслеживания изменений, оценкой, хранением, webhook и уведомлениями. В простой форме goal обязателен. Если queries содержит одно или несколько непустых значений и передаётся вместе с page/pages, то queries формируют цель поиска, а цели из page игнорируются. Монитор планирует будущие сетевые проверки и может отправлять настроенные уведомления по электронной почте или через webhook. Возвращает созданный монитор.

Окончательно удаляет монитор по ID и останавливает его запланированные запуски. Эту операцию нельзя отменить, и она возвращает статус удаления.

Получает один монитор по ID, включая его конфигурацию и текущее состояние. Не запускает и не изменяет монитор.

Выводит список мониторов для аутентифицированной учетной записи с опциональными параметрами управления пагинацией. Возвращает одну страницу записей мониторов и метаданные пагинации.

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

Вносит изменения в существующий монитор по ID. В теле запроса можно изменить его название, статус active/paused, расписание, цели, ориентиры (goal), критерии оценки (judging), вебхуки, уведомления или срок хранения данных; эти изменения влияют на будущие запланированные проверки. Возвращает обновлённый монитор.

Преобразует один поддерживаемый документ в markdown, HTML, ссылки, сводку, точечные ответы или JSON, соответствующий схеме. На вход принимаются распространённые файлы HTML, PDF, Word, RTF, OpenDocument и электронные таблицы; разбор PDF можно ограничить параметром pdfOptions.maxPages. Локальный MCP читает filePath из файловой системы сервера. Хостируемый MCP использует два вызова: сначала передайте filePath, чтобы получить инструкции по загрузке, загрузите файл локально, затем вызовите снова с возвращённым uploadRef; не отправляйте оба поля одновременно. Удалённые веб-URL относятся к firecrawl_scrape. Установите redactPII, чтобы запросить удаление персональных данных из возвращаемого содержимого. zeroDataRetention требует аутентифицированной учётной записи, отвечающей условиям; не указывайте его при анонимном использовании без ключа. Возвращает инструкции по загрузке для первого этапа хостируемого MCP или содержимое разобранного документа для финального вызова.

Получает канонические метаданные для одного идентификатора статьи, например arXiv, PMC, PMID или DOI. Возвращает заголовок, аннотацию, авторов, категории, идентификаторы источников и даты в формате Markdown.

Извлекает из одной статьи фрагменты основного текста, соответствующие конкретному вопросу. Полный текст доступен только для индексированных статей; k управляет количеством фрагментов. Возвращает соответствующие фрагменты или уведомление, если полный текст недоступен.

Находит кандидатов в графе цитирования, используя от одного до десяти seed_ids; первый ID - основной начальный узел, а последующие - якоря. mode по умолчанию принимает значение similar (ко-цитирование/библиографическая связь); citers возвращает статьи, цитирующие начальный узел, а references - статьи, цитируемые начальным узлом. intent ранжирует кандидатов. Возвращает ранжированных кандидатов и размер оценённого пула.

Ищет по проиндексированному публичному содержимому issues, pull-request'ов и README-файлов на GitHub. Возвращает ранжированные совпадения с репозиторием, URL, фрагментом и полным Markdown-текстом совпадения, когда он доступен.

Ищет метаданные статей и аннотации по запросу на естественном языке по индексированному корпусу, который охватывает биомедицинскую литературу, литературу по наукам о жизни и клиническую литературу (PubMed, bioRxiv, medRxiv), а также arXiv и другие научные источники. Необязательные фильтры по автору, категории и дате ограничивают результаты. Несколько разных формулировок одного и того же вопроса выдают другие статьи, чем один запрос. Возвращает ранжированные статьи с каноническими идентификаторами, названиями, авторами и аннотациями.

Получает и извлекает содержимое одного указанного URL через Firecrawl. Используйте этот инструмент, когда запрос указывает на страницу и нужны её содержимое или определённые поля. Он может вернуть Markdown, HTML, ссылки, скриншоты, данные о бренде, точечный ответ или JSON, соответствующий заданной схеме. JSON удобен, когда ожидаемый результат содержит определённые поля, а Markdown сохраняет читаемое содержимое страницы. Этот инструмент работает с известной страницей. Для набора страниц используйте firecrawl_crawl, а для поиска URL страниц используйте firecrawl_map или firecrawl_search. Среди опций: задержка рендеринга JavaScript, возраст кэша, фильтрация основного контента, маскирование PII и получение только из кэша в режиме lockdown. Действия браузера могут изменить живую страницу, если включены интерактивные действия. Firecrawl может повторно использовать недавно проиндексированный контент вместо повторной загрузки страницы, и окно повторного использования зависит от домена. Установите maxAge: 0, чтобы принудительно выполнить живую загрузку, или меньшее значение maxAge, чтобы ограничить, насколько устаревшим может быть повторно используемый контент. Успешный ответ сам по себе не подтверждает, что описанное в нём состояние всё ещё актуально. Возвращает выбранные форматы контента и метаданные страницы.

Ищет по вебу, новостям или изображениям и возвращает ранжированные результаты. Операторы включают фразы в кавычках, -term, site:host, inurl:term, intitle:term и related:host; список не исчерпывающий. includeDomains и excludeDomains - взаимоисключающие фильтры по имени хоста; категории ограничивают результаты источниками GitHub, research, PDF или developer. Для вопроса по программированию добавьте categories: ["developer"]. Инструмент ищет по индексу GitHub issues, объединённых pull request, README репозиториев и курируемых сайтов с документацией и возвращает совпадения в data.developer в дополнение к веб-результатам. categories: ["research"] ограничивает эти веб-результаты сайтами, связанными с исследованиями, и возвращает фрагменты страниц. Инструменты firecrawl_research_* - отдельный интерфейс, который ищет по аннотациям и полным текстам статей в биомедицинской литературе (PubMed, bioRxiv, medRxiv) и литературе arXiv. scrapeOptions может прикреплять извлечённое содержимое страниц; страницы, полученные таким способом, используют фиксированное окно повторного использования и игнорируют maxAge, поэтому используйте firecrawl_scrape, когда требуется актуальная загрузка. Возвращает группы результатов по типу источника и метаданные об использовании. Аутентифицированные ответы могут включать id для необязательной обратной связи по поиску.

Записывает валидированную по схеме обратную связь о качестве для предыдущего поиска firecrawl_search с UUID searchId. Оценка good требует ценного источника, partial - ценного источника или хотя бы одной записи missingContent, а bad - хотя бы одной записи missingContent или предложения по запросу; лимиты: 50 записей valuableSources и 20 записей missingContent. Допускаются только успешные поиски в пределах окна давности обратной связи. Запись идемпотентна для каждого ID поиска. Первая подходящая обратная связь для поиска может вернуть 1 кредит; на возвраты действует дневной лимит команды. Ответ сообщает, был ли применён возврат, а также статус отправки и дневного лимита.