Firecrawl MCP

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

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

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

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

Если у разработчика есть вопрос про поведение кода, библиотеку или фреймворк, контракт API, сообщение об ошибке или известный баг, выполняет поиск по индексу, созданному для агентов, пишущих код. Индекс охватывает GitHub issues, объединённые пул-реквесты, README репозиториев и курируемые сайты документации. Установите параметр skills в значение «only», чтобы ограничить поиск только файлами навыков агента. Возвращает ранжированные результаты с 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, поддомена, query-параметры и ограничение количества результатов управляют охватом. Возвращает соответствующие URL, а не содержимое страниц. Извлекайте одну страницу с помощью firecrawl_scrape; собирайте содержимое с нескольких страниц с помощью firecrawl_crawl.

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

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

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

Навсегда удаляет монитор по ID и останавливает его будущее расписание. Эта операция необратима и возвращает статус удаления.

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

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

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

Обновляет существующий монитор по ID. Тело запроса может изменить его имя, статус «активен/приостановлен», расписание, объекты мониторинга, цель, критерии оценки, вебхук, уведомления или срок хранения; эти изменения влияют на будущие запланированные проверки. Возвращает обновлённый монитор.

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

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

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

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

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

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

Получает и извлекает контент из одного переданного URL через Firecrawl. Используйте его, когда в запросе указана страница и нужно её содержимое или заданные поля. Он возвращает Markdown, HTML, ссылки, скриншоты, данные брендинга, точечный ответ или JSON, соответствующий заданной схеме; JSON удобен, когда у запрашиваемого результата есть заданные поля, а Markdown сохраняет читаемый контент страницы. Этот инструмент работает с уже известной страницей. Для набора страниц используйте firecrawl_crawl, а для поиска URL страниц - firecrawl_map или firecrawl_search. Параметры включают задержку рендеринга JavaScript, возраст кэша, фильтрацию основного контента, удаление персональных данных (PII) и строгий режим получения данных только из кэша. Действия браузера могут менять живую страницу, когда включены интерактивные действия. 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. Записать обратную связь можно только для успешных поисков в пределах окна давности обратной связи. Запись идемпотентна для каждого идентификатора поиска. Первая подходящая обратная связь для поиска может вернуть 1 кредит; возвраты ограничены дневным лимитом команды. Ответ сообщает, был ли применён возврат, а также статус отправки и статус дневного лимита.