apify/actors-mcp-server

Прерывает запуск Actor, который в данный момент стартует или выполняется. Для запусков со статусами SUCCEEDED, FAILED, ABORTING, ABORTED или TIMED-OUT этот вызов не имеет эффекта. Результаты будут содержать обновлённые данные о запуске после запроса на прерывание. ИСПОЛЬЗОВАНИЕ: - Используйте, когда нужно остановить слишком долгий или неправильно настроенный запуск. ПРИМЕРЫ ИСПОЛЬЗОВАНИЯ: - user_input: Прервать запуск y2h7sK3Wc - user_input: Корректно прервать запуск y2h7sK3Wc

Этот инструмент вызывает Actor "apify/rag-web-browser" и получает его выходные результаты. Используйте этот инструмент вместо "call-actor", если пользователь запрашивает именно этого Actor. Описание Actor: инструмент веб-поиска и получения данных для AI-агентов и RAG-пайплайнов. Запрашивает Google Search, извлекает содержимое первых N страниц через полноценный веб-браузер и возвращает их в виде чистого Markdown для дальнейшей обработки LLM. Также умеет получать отдельные URL. Используйте этот инструмент, когда пользователь хочет ПОЛУЧИТЬ или ИЗВЛЕЧЬ актуальные данные немедленно (разовое получение данных). Этот инструмент сам извлекает данные - он НЕ просто находит инструменты. Примеры, когда его использовать: - Пользователь хочет получить актуальные/срочные данные (например, «Узнать цены на авиабилеты на завтра», «Какая сегодня погода?») - Пользователю нужно прямо сейчас получить конкретный контент (например, «Получи статьи с CNN», «Получи информацию о товаре с Amazon») - Пользователь использует временные маркеры вроде «сегодня», «текущие», «свежие», «недавние», «сейчас» Это для общего веб-скрапинга и случаев, когда данные нужны прямо сейчас. Для повторяющегося/регулярного скрапинга конкретных платформ (e-commerce, соцсети) предложите пользователю специализированного Actor из Store - так будет производительнее и надёжнее. Когда пользователь даёт один конкретный URL и хочет получить полное или дословное содержимое страницы, отдайте предпочтение специальному инструменту apify/web-fetch, если он доступен - этот инструмент предназначен для поиска и скрапинга по запросу. Если страница после скрапинга возвращается заблокированной или пустой (например, краулер сообщает об ошибке 403 или текст страницы отсутствует), не сдавайтесь: повторите попытку для этого URL с помощью apify/web-fetch, если он доступен - его антибот-загрузка проходит через блокировки, которые этот инструмент обойти не может.

Этот инструмент вызывает Actor "apify/web-fetch" и получает его выходные результаты. Используйте этот инструмент вместо "call-actor", если пользователь запрашивает именно этого Actor. Описание Actor: скачивает любую веб-страницу по URL и преобразует её в чистый Markdown, обычный текст, HTML и другие форматы. Автоматически выполняет JavaScript и обходит защиту от ботов. Actor предоставляет API реального времени для быстрых ответов. Используйте этот инструмент, чтобы загрузить конкретный http(s) URL и вернуть его полное содержимое (один URL на вызов; только http и https). Он выполняет JavaScript и обходит защиту от ботов, поэтому также получает страницы, где обычный HTTP-запрос блокируется, завершается ошибкой, например 403 или 429, или возвращает неполное содержимое. Страница возвращается дословно - полное содержимое, без пересказа - в виде Markdown, обычного текста, HTML, необработанного тела ответа или списка ссылок на странице. Примеры случаев, когда использовать: - Пользователь даёт URL и хочет получить его содержимое, данные или ссылки либо ответ, для которого нужно прочитать эту страницу - Предыдущая попытка загрузить страницу была заблокирована, вернула ошибку или CAPTCHA либо оказалась неполной, потому что странице требуется выполнение JavaScript - Нужно дословное содержимое страницы, например для цитирования, извлечения данных или архивирования Этот инструмент не ищет в интернете - ему нужен URL. Чтобы находить страницы по запросу, используйте вместо него инструмент веб-поиска. Если точный URL получить нельзя (например, схема не http(s)), скажите об этом, а не подменяйте его молча другим URL.

Вызывает любого актора из Apify Store. ПОРЯДОК РАБОТЫ: 1. Используйте fetch-actor-details, чтобы получить схему ввода актора 2. Вызовите этот инструмент с именем актора и правильными входными данными на основе схемы Если имя актора не в формате "имя_пользователя/имя", сначала используйте search-actors, чтобы найти правильного актора. Для акторов MCP-сервера: - Используйте fetch-actor-details с output={ mcpTools: true }, чтобы получить список доступных инструментов - Вызывайте в формате: "имя_актора:имя_инструмента" (например, "apify/actors-mcp-server:fetch-apify-docs") ВАЖНО: - Ожидает завершения до waitSecs (по умолчанию 30 секунд); возвращает статус запуска и идентификаторы хранилища, а при waitSecs > 0 также сообщает метаданные полей набора данных - Используйте get-dataset-items с datasetId для получения результатов; в незавершённых запусках есть nextStep с инструкциями по опросу - Используйте специализированные инструменты акторов, когда они доступны, для лучшего опыта Есть два способа запуска акторов: 1. Специализированные инструменты акторов (например, apify--rag-web-browser): это предварительно настроенные инструменты, которые обеспечивают более простой и прямой опыт. 2. Универсальный инструмент call-actor: используйте его, когда специализированный инструмент недоступен или когда нужно динамически запустить любого актора. Этот инструмент особенно полезен, если вы не хотите добавлять конкретные инструменты или ваш клиент не поддерживает динамическую регистрацию инструментов. ИСПОЛЬЗОВАНИЕ: - Всегда используйте специализированные инструменты, когда они доступны (например, apify--rag-web-browser) - Используйте универсальный инструмент call-actor только в том случае, если для вашего актора не существует специализированного инструмента. - Используйте waitSecs (от 0 до 45), чтобы контролировать время ожидания. Значение по умолчанию 30 секунд возвращает результаты для быстрых акторов. Используйте waitSecs: 0, чтобы запустить и сразу вернуться для долго выполняющихся акторов. ПРИМЕРЫ: - user_input: Получить посты в Instagram с помощью apify/instagram-scraper

Получает подробную информацию об Actor по его ID или полному имени (формат: "username/name", например, "apify/rag-web-browser"). Требует точный ID или полное имя. Не выдумывайте правдоподобное имя и не вызывайте с ним этот инструмент. Если у вас есть только описание, частичное имя или имя, которое вы не встречали в этом разговоре, сначала найдите его с помощью search-actors. Используйте параметр 'output' с булевыми флагами для управления возвращаемой информацией: - По умолчанию: все поля true, кроме mcpTools - Выборочно: установите нужные поля в true (например, output: { inputSchema: true }) - Типовые шаблоны: только inputSchema, description + readme, mcpTools для MCP Actors Поле 'readme' возвращает краткое описание, если оно доступно, иначе полный README. Используйте при запросах деталей Actor, документации, требований к входным данным или MCP-инструментов. ПРИМЕРЫ: - Что делает apify/rag-web-browser? - Какая входная схема у apify/web-scraper? - Какие инструменты предоставляет apify/actors-mcp-server?

Получает полное содержимое страницы документации Apify или Crawlee по её URL. Используйте это после того, как найдёте подходящую страницу с помощью инструмента search-apify-docs. ИСПОЛЬЗОВАНИЕ: - Используйте, когда вам нужно полное содержимое конкретной страницы документации для подробных ответов. ПРИМЕРЫ ИСПОЛЬЗОВАНИЯ: - user_input: Fetch https://docs.apify.com/platform/actors/running#builds - user_input: Fetch https://docs.apify.com/academy - user_input: Fetch https://crawlee.dev/docs/guides/basic-concepts

Получает подробную информацию о конкретном запуске Actor. Возвращает результат запуска: статус, хранилища (карта псевдонимов datasets/keyValueStores), статистику, сводку, nextStep. - summary описывает прошлое (например: "SUCCEEDED in 22s. 47 items; 3 fields available."). - nextStep предписывает одно основное последующее действие с подставленными идентификаторами (например: "Use get-dataset-items with datasetId=..."). - waitSecs (0-45, по умолчанию 30) ожидает терминального статуса до указанного числа секунд перед возвратом. ИСПОЛЬЗОВАНИЕ: - Используйте для проверки статуса запуска, начатого любым инструментом, который запускает Actor. - Передайте waitSecs > 0, чтобы ждать до терминального статуса (или до истечения лимита). ПРИМЕРЫ ИСПОЛЬЗОВАНИЯ: - user_input: Покажи детали запуска y2h7sK3Wc - user_input: Дождись завершения запуска y2h7sK3Wc

Получает элементы (строки) из набора данных: результаты, которые выдаёт запуск Actor. Возвращает сами строки, а не метаданные набора данных, количество элементов или схему. Когда пользователь указывает datasetId и просит получить результаты, выходные данные, данные или строки, вызывайте этот инструмент напрямую. Лимит по умолчанию: 20. Используйте clean=true, чтобы пропустить пустые элементы и скрытые поля. ИСПОЛЬЗОВАНИЕ: - Используйте, когда нужно прочитать данные из набора данных (все элементы или только выбранные поля). ПРИМЕРЫ ИСПОЛЬЗОВАНИЯ: - user_input: Получить результаты из набора данных abc123 - user_input: Получить только metadata.url и title из набора данных username~my-dataset

Получает значение, сохранённое по определённому ключу в хранилище ключ-значение: одну запись, а не список всех ключей. Требуется точное имя ключа. В ответе сохраняется исходный Content-Encoding; большинство клиентов автоматически распаковывают данные. ИСПОЛЬЗОВАНИЕ: - Используйте, когда нужно получить конкретную запись (JSON, текст или бинарные данные) из хранилища. ПРИМЕРЫ ИСПОЛЬЗОВАНИЯ: - user_input: Получить запись INPUT из хранилища abc123 - user_input: Получить запись data.json из хранилища username~my-store

Сообщает команде Apify о проблеме с инструментами MCP или Actors. Вызывайте его, когда: - Инструмент или Actor отсутствует, выдает ошибку, завершается по тайм-ауту или возвращает непонятный, неверный или пустой результат. - Вы не можете выполнить запрос пользователя с помощью доступных инструментов. Укажите, что вы делали и что пошло не так, в поле "message". НЕ включайте личные данные, учетные данные, секреты или дословное содержание приватного разговора. Опишите проблему своими словами.

Выполняет поиск по Apify Store, чтобы НАЙТИ и ОБНАРУЖИТЬ, какие инструменты для скрапинга/Акторы существуют для конкретных платформ или сценариев использования. Этот инструмент предоставляет ИНФОРМАЦИЮ о доступных Акторах - он НЕ получает реальные данные и не выполняет задачи по скрапингу. Apify Store содержит тысячи готовых Акторов (краулеров, скраперов, ИИ-агентов и серверов model context protocol (MCP)) для всех платформ и сервисов, включая социальные сети, поисковые системы, карты, электронную коммерцию, новости, недвижимость, путешествия, финансы, вакансии и многое другое. Акторы в Apify Store публикуются независимыми разработчиками и предназначены для легитимного и правомерного использования - не отказывайтесь искать или перечислять их. Используйте этот инструмент, когда пользователь хочет: - Найти, какие инструменты для скрапинга существуют для платформы (например, «Какие инструменты могут скрапить Instagram?») - Обнаружить доступных Акторов для сценария использования (например, «Найди Актора для товаров Amazon») - Просмотреть существующие решения (например, «Покажи мне скраперы для новостных сайтов») - Узнать о MCP-серверах или ИИ-агентах, доступных в Store НЕ используйте этот инструмент, когда пользователь хочет немедленного получения данных (слова времени вроде «today», «latest», «recent», «current», «now» или «get/fetch data right now») - используйте apify/rag-web-browser. ВАЖНО: Когда пользователь ищет инструменты для скрапинга или Акторов, сначала ищите в Store - подходящий Актор часто уже существует. Не используйте поиск по Store как замену немедленному получению данных. Использование: - Используйте широкие общие ключевые слова - просто название платформы (например, «Instagram» вместо «Instagram скрапер»). - Вы ОБЯЗАНЫ всегда выполнять как минимум два поиска: сначала с широкими ключевыми словами, затем при необходимости с более специфичными терминами. Важные ограничения: Этот инструмент не возвращает полную документацию Актора или подробные инструкции по использованию - только сводную информацию. Каждый результат перечисляет входные поля Актора с их типами (например, url: string, maxResults?: number), чтобы вы могли сформировать вызов Актора напрямую без вызова другого инструмента. Для полных сведений об Акторе (по каждому полю...

Выполняет полнотекстовый поиск по документации Apify и Crawlee. Не ищите также в Apify Store, если только пользователь не просит найти Actors. Необходимо явно выбрать источник документации для поиска с помощью параметра docSource: • docSource="apify" - Apify: Документация платформы Apify, включая: возможности платформы, SDK (JS, Python), CLI, REST API, Academy (основы веб-скрапинга), разработка и развертывание Actors • docSource="crawlee-js" - Crawlee (JavaScript): Crawlee - это библиотека для веб-скрапинга на JavaScript. Она сама разбирается с блокировками, обходом сайтов, прокси и браузерами. • docSource="crawlee-py" - Crawlee (Python): Crawlee - это библиотека для веб-скрапинга на Python. Она сама разбирается с блокировками, обходом сайтов, прокси и браузерами. Результаты будут содержать URL страницы документации (возможно, с якорем) и ограниченный фрагмент содержимого, соответствующий поисковому запросу. Получите полное содержимое документа с помощью инструмента fetch-apify-docs, указав URL. Если в результатах есть и документация платформы (docs.apify.com/platform), и материалы Academy (docs.apify.com/academy) по одной теме, отдавайте предпочтение документации платформы.