Официальный MCP-сервер Apify для AI-агентов, позволяющий запускать Actors, извлекать данные с веб-сайтов и автоматизировать процессы веб-скрапинга и краулинга.
Поиск в Apify Store — Попросите вашего ассистента найти скраперы и инструменты автоматизации для любого сайта или платформы с помощью search-actors.
Запуск любого Apify Actor — Попросите вашего ассистента выполнить конкретный Actor, например, для скрапинга Google Maps или Instagram, и вернуть результаты.
Получение деталей Actor — Получите схему ввода, README и цены Actor, чтобы понять, как его использовать, через fetch-actor-details.
Просмотр веб-страниц — Используйте встроенный инструмент apify--rag-web-browser для поиска в интернете и обобщения лучших результатов.
Загрузка любого URL — Попросите вашего ассистента получить содержимое веб-страницы в формате Markdown или текста с помощью инструмента apify--web-fetch.
Управление запусками Actor — Проверяйте статус запуска, получайте логи или прерывайте выполняемые задачи с помощью таких инструментов, как get-actor-run и abort-actor-run.
Сервер Apify Model Context Protocol (MCP) по адресу mcp.apify.com позволяет вашим ИИ-агентам извлекать данные из социальных сетей, поисковых систем, карт, сайтов электронной коммерции и любых других веб-сайтов с помощью тысяч готовых скраперов, краулеров и инструментов автоматизации из Apify Store. Он поддерживает OAuth, что позволяет подключаться из таких клиентов, как Claude.ai или Visual Studio Code, используя только URL-адрес.
🚀 Используйте размещенный Apify MCP Server!
Для наилучшего опыта подключите вашего ИИ-ассистента к нашему размещенному серверу по адресу https://mcp.apify.com. Размещенный сервер поддерживает новейшие функции — включая вывод схемы выходных данных для структурированных результатов Actor — которые недоступны при локальном запуске через stdio.
⚠️ Устаревший SSE-транспорт удален. Конечная точка https://mcp.apify.com/sse была удалена в пользу Streamable HTTP. Перенесите вашего клиента на https://mcp.apify.com — уберите суффикс /sse из вашей конфигурации.
💰 Сервер также поддерживает агентные платежи: купите токен на AGI, чтобы запускать любого Actor, или платите за каждый запрос через прямой x402 (только для Pay Per Event Actors) или Skyfire.
Apify MCP Server совместим с Claude Code, Claude.ai, Cursor, VS Code и любым клиентом, который соответствует Model Context Protocol.
Ознакомьтесь с разделом о MCP-клиентах для получения дополнительных сведений или посетите страницу конфигурации MCP.
Использовать Instagram Scraper для скрапинга постов, профилей, мест, фотографий и комментариев Instagram.
Использовать RAG Web Browser для поиска в интернете, скрапинга первых N URL-адресов и возврата их содержимого.
Использовать Web Fetch для получения любого URL-адреса и возврата его содержимого в формате Markdown, обычного текста, HTML или ссылок — с рендерингом JavaScript и защитой от ботов.
Видеоурок: Интеграция 8000+ Apify Actors и агентов с Claude
🚀 Быстрый старт
Вы можете использовать Apify MCP Server двумя способами:
HTTPS-конечная точка (mcp.apify.com): Подключение из вашего MCP-клиента через OAuth или путем включения заголовка Authorization: Bearer <APIFY_TOKEN> в ваши запросы. Это рекомендуемый метод для большинства случаев использования. Поскольку он поддерживает OAuth, вы можете подключаться из таких клиентов, как Claude.ai или Visual Studio Code, используя только URL-адрес: https://mcp.apify.com.
https://mcp.apify.com streamable transport
Стандартный ввод/вывод (stdio): Идеально подходит для локальных интеграций и инструментов командной строки, таких как клиент Claude for Desktop.
Установите команду сервера MCP-клиента на npx @apify/actors-mcp-server и переменную окружения APIFY_TOKEN на ваш Apify API-токен.
См. npx @apify/actors-mcp-server --help для получения дополнительных параметров.
Подробные инструкции по настройке MCP-сервера вы найдете в документации Apify.
🤖 MCP-клиенты
Apify MCP Server совместим с любым MCP-клиентом, который соответствует Model Context Protocol, но уровень поддержки динамического обнаружения инструментов и других функций может различаться в зависимости от клиента.
Этот интерактивный интерфейс в виде чата предоставляет простой способ изучить возможности Apify MCP без локальной настройки.
Войдите в свою учетную запись Apify и начните экспериментировать с веб-скрапингом, извлечением данных и инструментами автоматизации!
Или используйте файл пакета MCP (ранее известный как файл расширения Anthropic Desktop, или DXT) для установки в один клик: Apify MCP Server MCPB file
💰 Агентные платежи
Вы можете оплачивать запуски Actor без Apify API-токена, используя AGI, прямой x402 или Skyfire.
AGI (agi.apify.com) выпускает предоплаченный Apify API-токен в обмен на платеж x402 или MPP. Используйте токен как обычный API-токен для mcp.apify.com и api.apify.com — работает для любого Actor, а не только для Pay Per Event. Рекомендуется для новых интеграций; см. AGI (рекомендуется) ниже.
Прямой x402 оплачивает USDC на Base за каждый запрос и не требует отдельной учетной записи платформы. Полностью поддерживается mcpc (brew install apify/tap/mcpc или npm install -g @apify/mcpc). Мы используем mcpc, потому что это один из немногих MCP-клиентов, который поддерживает новейшие функции и протокол x402 нативно.
Skyfire оплачивает токенами PAY и требует учетную запись Skyfire с пополненным кошельком. Не требует специального MCP-клиента; весь процесс оплаты обрабатывается напрямую через параметры вызова MCP-инструмента.
ℹ️ Область применения: Как прямой x402, так и Skyfire ограничены Pay Per Event Actors, не поддерживают Standby Actors и рассчитываются за каждый запуск вместо выпуска токена.
Как работают агентные платежи
Стоимость запуска Actor варьируется, поэтому оба метода оплаты используют модель предоплаченного баланса. Процесс оплаты состоит из четырех шагов:
Обнаружение: Агент обнаруживает Actors с помощью search-actors или fetch-actor-details. Эти вызовы бесплатны.
Предоплата: Перед запуском платного инструмента Actor агент пополняет предоплаченный баланс.
Прямой x402: mcpc автоматически подписывает транзакцию на $1.00 USDC.
Skyfire: Агент создает токен PAY (минимум $5.00) с помощью инструмента Skyfire create-pay-token.
Выполнение: Агент вызывает инструмент Actor.
Прямой x402: Обрабатывается автоматически mcpc с использованием предоплаченного баланса.
Skyfire: Агент явно передает токен PAY в свойстве ввода skyfire-pay-id.
Завершение: Инструмент возвращает результаты Actor. Неиспользованные средства остаются доступными для последующих запусков.
Прямой x402: После 60 минут бездействия сервер возвращает неиспользованный баланс на кошелек на Base.
Skyfire: Skyfire возвращает неиспользованные средства по истечении срока действия токена.
🪙 AGI (рекомендуется)
AGI (Apify Agent General Interface) — рекомендуемый способ для автономных агентов оплачивать использование Apify без учетной записи. Оплатите один раз через x402 или MPP, получите предоплаченный Apify API-токен с лимитом расходов и используйте его напрямую для mcp.apify.com и api.apify.com (Authorization: Bearer <token>) — для любого Actor.
Полный протокол, поддерживаемые способы оплаты и текущие условия (минимальная сумма, срок действия токена, политика возврата) задокументированы на agi.apify.com/AGENTS.md — считайте это единственным источником истины.
💸 Прямой x402
Протокол x402 обеспечивает прямые платежи между машинами. Ваш MCP-клиент может использовать его для оплаты запусков Actor в USDC на блокчейне Base, полностью обходя необходимость в Apify API-токене.
# Create a new wallet
mcpc x402 init
# Import an existing wallet
mcpc x402 import <private-key>
# Show the wallet address and a funding QR code, so you can fund it with USDC on Base (https://base.org)
mcpc x402
mcpc @apify tools-call call-actor actor:="apify/rag-web-browser" input:='{"query": "latest AI news"}'
🔥 Skyfire
Skyfire предоставляет управляемую платежную инфраструктуру для ИИ-агентов. Вместо аутентификации с Apify API-токеном ваш агент передает платежный токен Skyfire для покрытия стоимости каждого вызова инструмента с использованием токенов PAY.
MCP-сервер предоставляет набор инструментов для взаимодействия с Apify Actors.
Поскольку Apify Store велик и быстро растет, MCP-сервер предоставляет способ динамического обнаружения и использования новых Actors.
Actors
Любой Apify Actor может использоваться как инструмент.
По умолчанию сервер предварительно настроен с двумя Actors, apify/rag-web-browser и apify/web-fetch, и несколькими вспомогательными инструментами.
MCP-сервер загружает входную схему Actor и создает соответствующий MCP-инструмент.
Это позволяет ИИ-агенту точно знать, какие аргументы передавать Actor и что ожидать в ответ.
Например, для Actor apify/rag-web-browser входные параметры:
{
"query": "restaurants in San Francisco",
"maxResults": 3
}
Вам не нужно вручную указывать, какой Actor вызывать или его входные параметры; LLM обрабатывает это автоматически.
Когда инструмент вызывается, аргументы автоматически передаются Actor через LLM.
Вы можете обратиться к документации конкретного Actor для получения списка доступных аргументов.
Вспомогательные инструменты
Одна из самых мощных функций использования MCP с Apify — динамическое обнаружение инструментов.
Оно позволяет ИИ-агенту находить новые инструменты (Actors) по мере необходимости и включать их в работу.
Вот некоторые специальные операции MCP и то, как Apify MCP Server их поддерживает:
Акторы Apify: Поиск акторов, список акторов в вашем аккаунте, просмотр их деталей, использование их в качестве инструментов для ИИ и удаление собственных акторов.
Документация Apify: Поиск по документации Apify и получение конкретных документов для предоставления контекста ИИ.
Запуски акторов: Получение списков ваших запусков акторов, просмотр их деталей и получение журналов.
Хранилище Apify: Доступ к данным из ваших наборов данных и хранилищ ключ-значение.
Задачи акторов: Создание, просмотр и обновление сохранённых задач акторов, а также публикация или снятие с публикации их публичных целевых страниц.
Расписания: Создание, просмотр, обновление и удаление расписаний, которые автоматически запускают ваших акторов и задачи.
Сборки: Сборка версии актора, список сборок, проверка статуса сборки и получение её журнала сборки.
Исходный код актора: Чтение файлов версии актора с хэшем для каждого файла и ревизией для всего набора.
API Apify: Поиск по справочнику API Apify, просмотр операции и отправка запросов к API для чтения или изменения данных.
Обзор доступных инструментов
Ниже приведён обзорный список всех инструментов, предоставляемых MCP-сервером Apify.
Обозначения для столбца Включено по умолчанию:
✅ — в стандартном наборе инструментов.
⚡ — автоматически внедряется, когда присутствует call-actor, инструмент актора или get-actor-run (что верно в стандартной конфигурации).
✅¹ — предоставляется по умолчанию, но только когда телеметрия включена, а клиент не скрыт: поверхности Anthropic (Claude.ai / Claude Desktop / Claude Code) или local-agent-mode-apify. Чтобы отключить, передайте явный список tools=, который его исключает. Явный выбор (tools=report-problem или tools=dev) предоставляет его независимо от клиента — телеметрия всё равно должна быть включена.
Имя инструмента
Категория
Описание
Включено по умолчанию
search-actors
акторы
Поиск акторов в Apify Store.
✅
fetch-actor-details
акторы
Получение подробной информации о конкретном акторе, включая его входную схему, README (краткое описание, если доступно, иначе полное), цены и выходную схему актора.
✅
call-actor
акторы
Вызов актора и получение результатов его запуска. Сначала используйте fetch-actor-details, чтобы получить входную схему актора.
✅
get-actor-run
запуски
Получение подробной информации о конкретном запуске актора.
⚡
get-dataset-items
хранилище
Получение элементов из набора данных с поддержкой фильтрации и постраничного вывода.
⚡
get-key-value-store-record
хранилище
Получение значения, связанного с конкретным ключом в хранилище ключ-значение.
⚡
abort-actor-run
запуски
Прерывание запущенного запуска актора, при необходимости корректно.
⚡
delete-actor
нет (выбор по имени: tools=delete-actor)
Удаление актора из вашего аккаунта навсегда. Публичные акторы должны быть сначала сняты с публикации.
search-apify-docs
документация
Поиск по документации Apify для получения соответствующих страниц.
✅
fetch-apify-docs
документация
Получение полного содержимого страницы документации Apify по её URL.
Инструмент актора для получения URL и возврата его содержимого.
✅
report-problem
разработка
Сообщение о проблеме с инструментом или актором Apify команде Apify.
✅¹
get-actor-list
нет (выбор по имени: tools=get-actor-list)
Список акторов, которыми вы владеете и которые доступны вам, включая частные.
get-actor-run-list
запуски
Получение списка запусков акторов с фильтрацией по актору и статусу.
get-actor-run-log
запуски
Получение журналов для конкретного запуска актора.
get-dataset
хранилище
Получение метаданных о конкретном наборе данных.
get-dataset-schema
хранилище
Генерация JSON-схемы из элементов набора данных.
get-key-value-store
хранилище
Получение метаданных о конкретном хранилище ключ-значение.
get-key-value-store-keys
хранилище
Список ключей в конкретном хранилище ключ-значение.
get-dataset-list
хранилище
Список всех доступных наборов данных для пользователя.
get-key-value-store-list
хранилище
Список всех доступных хранилищ ключ-значение для пользователя.
create-actor-task
задачи
Создание сохранённой задачи актора (именованной, многократно используемой конфигурации актора).
get-actor-task
задачи
Получение сохранённой задачи актора, её состояния публикации и публичной конфигурации отображения.
update-actor-task
задачи
Обновление входных данных задачи, параметров запуска или публичной конфигурации отображения.
publish-actor-task
задачи
Публикация задачи на её публичной целевой странице.
unpublish-actor-task
задачи
Снятие задачи с публикации с её публичной целевой страницы.
create-schedule
расписания
Создание расписания, которое запускает акторов или задачи по cron-расписанию.
get-schedule
расписания
Получение расписания, его cron-выражения, состояния и действий, которые оно запускает.
update-schedule
расписания
Обновление расписания: cron-выражение, часовой пояс, состояние включения или действия.
delete-schedule
расписания
Удаление расписания.
get-actor-build
сборки
Получение статуса сборки актора.
get-actor-build-log
сборки
Получение журналов для конкретной сборки актора.
get-actor-build-list
сборки
Список сборок аккаунта или одного актора во всех статусах, сначала новые.
build-actor
сборки
Сборка версии актора и ожидание в течение ограниченного времени завершения сборки.
get-actor-version
исходный код
Получение списка файлов версии актора с хэшами и содержимого запрошенных файлов.
apify-api-search
api
Поиск по справочнику API Apify для операций по ключевым словам. Возвращает метод, путь и страницу документации для каждой операции.
apify-api-details
api
Получение параметров и схемы тела запроса операций API Apify по пути.
apify-api-read
api
Отправка GET-запроса к пути API Apify, например actor-runs или /v2/actor-runs, как apify api в Apify CLI. Только для чтения: отклоняет параметр запроса method и GET к синхронным конечным точкам запуска, которые запускают платный запуск.
apify-api-write
нет (выбор по имени: tools=apify-api-write)
Отправка POST, PUT, PATCH или DELETE-запроса к любому пути API Apify с JSON-телом, как apify api в Apify CLI. Отклоняет параметр запроса method.
Примечание:
Когда присутствует call-actor, инструмент актора или get-actor-run, сервер автоматически внедряет get-actor-run, get-dataset-items, get-key-value-store-record и abort-actor-run.
Когда вы вызываете актора — через call-actor или напрямую через инструмент актора (например, apify--rag-web-browser) — ответ содержит метаданные запуска, идентификаторы хранилища и summary + nextStep, но не элементы набора данных. Чтобы получить элементы, следуйте nextStep и вызовите get-dataset-items (автоматически внедряемый), передав datasetId, возвращённый из вызова.
Аннотации инструментов
Все инструменты включают аннотации метаданных, чтобы помочь MCP-клиентам и LLM понять поведение инструментов:
title: Короткое отображаемое имя инструмента (например, "Search Actors", "Call Actor", "apify/rag-web-browser")
readOnlyHint: true для инструментов, которые только читают данные без изменения состояния (например, get-dataset, fetch-actor-details). Инструменты акторов получают его только для акторов, поддерживаемых Apify, с ограниченными разрешениями и без секретного, записываемого хранилища, MCP-коннектора или ввода кода (например, apify--web-fetch); другие инструменты акторов помечены как разрушительные.
openWorldHint: true для инструментов, которые обращаются к внешним ресурсам за пределами платформы Apify (например, call-actor выполняет внешних акторов). Инструменты, которые взаимодействуют только с платформой Apify (например, search-actors или fetch-apify-docs), не имеют этой подсказки.
Конфигурация инструментов
Параметр конфигурации tools используется для указания загруженных инструментов — либо категорий, либо конкретных инструментов напрямую, а также акторов Apify. Например, tools=storage,runs загружает две категории; tools=call-actor загружает только один инструмент.
Когда параметры запроса не предоставлены, MCP-сервер загружает следующие tools по умолчанию:
actors
docs
apify/rag-web-browser
apify/web-fetch
Если параметр инструментов указан, будут включены только перечисленные инструменты или категории — инструменты по умолчанию не будут включены.
report-problem предоставляется по умолчанию (с учётом ограничений в сноске выше), но находится в категории dev, поэтому явный tools=dev также выбирает его. Чтобы отключить его, передайте явный список tools=, который его исключает (например, tools=actors,docs).
Простая конфигурация:
Используйте UI-конфигуратор для настройки вашего сервера, затем скопируйте конфигурацию в ваш клиент.
Настройка размещённого сервера:
Размещённый сервер можно настроить с помощью параметров запроса в URL. Например, чтобы загрузить инструменты по умолчанию, используйте:
Для минимальной конфигурации, если вы хотите использовать только один инструмент актора — без каких-либо инструментов обнаружения или универсального вызова, сервер можно настроить следующим образом:
https://mcp.apify.com?tools=apify/my-actor
Эта настройка предоставляет только указанного актора (apify/my-actor) как инструмент. Никакие другие инструменты не будут доступны.
Настройка CLI:
CLI можно настроить с помощью флагов командной строки. Например, чтобы загрузить те же инструменты, что и в конфигурации размещённого сервера, используйте:
Как указано выше, это предоставляет только указанного актора (apify/my-actor) как инструмент. Никакие другие инструменты не будут доступны.
⚠️ Важная рекомендация
Конфигурация инструментов по умолчанию может измениться в будущих версиях. Когда параметр tools не указан, сервер в настоящее время загружает инструменты по умолчанию, но это поведение может измениться.
Для производственного использования и стабильных интерфейсов всегда явно указывайте параметр tools, чтобы ваша конфигурация оставалась согласованной при обновлениях.
Конфигурация режима пользовательского интерфейса
Параметр ui включает рендеринг виджетов MCP Apps в ответах инструментов. Когда он включён, такие инструменты, как search-actors, возвращают интерактивные ответы MCP App.
Настройка размещённого сервера:
Включите режим пользовательского интерфейса с помощью параметра запроса ui:
https://mcp.apify.com?ui=true
Вы можете комбинировать его с другими параметрами:
https://mcp.apify.com?tools=actors,docs&ui=true
Настройка CLI:
CLI можно настроить с помощью флагов командной строки. Например, чтобы включить режим пользовательского интерфейса:
npx @apify/actors-mcp-server --ui true
Вы также можете установить его через переменную окружения UI_MODE:
export UI_MODE=true
npx @apify/actors-mcp-server
Обратная совместимость
Конфигурация v2 сохраняет обратную совместимость с использованием v1. Примечания:
actors параметр (URL) и --actors флаг (CLI) по-прежнему поддерживаются.
enableAddingActors (URL), enable-adding-actors (CLI) и устаревший псевдоним enableActorAutoLoading были удалены. Для динамического вызова Акторов используйте tools=call-actor (включен по умолчанию через категорию actors). Любое оставшееся необработанное значение игнорируется.
Значения по умолчанию остаются совместимыми: если не указаны tools, сервер загружает actors, docs, apify/rag-web-browser и apify/web-fetch.
Если указаны какие-либо tools, значения по умолчанию не добавляются (как и предполагалось в v1 для явного выбора).
call-actor теперь включен по умолчанию через категорию actors (аддитивное изменение). Чтобы исключить его, укажите явный список tools без actors.
tools=add-actor, tools=experimental и tools=preview выведены из эксплуатации: они игнорируются и не загружают инструменты. Вместо них используйте tools=call-actor (или категорию по умолчанию actors).
tools=get-actor-log выведен из эксплуатации: инструмент переименован в get-actor-run-log. Старый селектор игнорируется и не загружает инструменты. Вместо него используйте tools=get-actor-run-log (или категорию runs).
Существующие URL-адреса и команды, использующие ?actors=... или --actors, продолжают работать без изменений.
Промпты
Сервер объявляет возможность prompts, но в настоящее время промпты не зарегистрированы — prompts/list возвращает пустой список.
Ресурсы
Ваши данные Apify не перечисляются в resources/list — чтение происходит по запросу: передайте любой URL-адрес GET Apify API (https://api.apify.com/v2/...) в resources/read, и сервер подставит токен Apify из сессии и вернет тело ответа. resources/templates/list перечисляет распространенные формы — элементы датасета, записи и ключи хранилища ключ-значение, метаданные запуска, журнал запуска — с их параметрами пагинации. Ответы встраиваются до 256 КБ; все, что больше, возвращает короткое уведомление с URL-адресом для скачивания вместо тела ответа. Чтение через API требует токен Apify, поэтому сессия только с оплатой (x402 или Skyfire) получит ошибку JSON-RPC для таких запросов.
💬 Примеры использования
Ниже приведены реалистичные примеры, показывающие, как ИИ-ассистент использует инструменты Apify MCP Server.
Пример 1: Поиск в интернете с помощью RAG Web Browser
Запрос пользователя:
Найди последние новости об автономных ИИ-агентах и кратко изложи ключевые события.
ИИ-ассистент вызывает предварительно настроенный инструмент Актора apify--rag-web-browser для поиска в интернете и возврата содержимого из лучших результатов.
Инструмент возвращает содержимое в формате Markdown из первых 3 результатов поиска, которое ИИ-ассистент затем обобщает для пользователя.
Пример 2: Поиск и запуск Актора из Apify Store
Запрос пользователя:
Собери данные о 10 лучших ресторанах Праги с Google Maps, включая контактные данные.
ИИ-ассистент сначала ищет подходящего Актора, проверяет его входную схему, а затем выполняет его.
Инструмент возвращает предварительный просмотр собранных данных, включая названия ресторанов, адреса, рейтинги, номера телефонов и веб-сайты.
Пример 3: Получение и постраничный просмотр результатов запуска Актора
Запрос пользователя:
Покажи следующие 10 результатов из этого запуска.
ИИ-ассистент использует идентификатор датасета из предыдущего запуска Актора, чтобы получить дополнительные элементы.
Ожидаемый результат: инструмент возвращает следующую страницу структурированных данных из выходного датасета Актора.
📡 Телеметрия
Apify MCP Server собирает данные телеметрии о вызовах инструментов, чтобы помочь Apify понять модели использования и улучшить сервис.
По умолчанию телеметрия включена для всех вызовов инструментов.
Транспорт stdio также использует Sentry для отслеживания ошибок, что помогает нам быстрее выявлять и исправлять проблемы.
Sentry автоматически отключается, когда телеметрия отключена.
Отказ от телеметрии
Вы можете отказаться от телеметрии (включая отслеживание ошибок Sentry), установив флаг CLI --telemetry-enabled в значение false или переменную окружения TELEMETRY_ENABLED в значение false.
Флаги CLI имеют приоритет над переменными окружения.
Примеры
Для удаленного сервера (mcp.apify.com):
# Disable via URL parameter
https://mcp.apify.com?telemetry-enabled=false
Для локального сервера stdio:
# Disable via CLI flag
npx @apify/actors-mcp-server --telemetry-enabled=false
# Or set environment variable
export TELEMETRY_ENABLED=false
npx @apify/actors-mcp-server
⚙️ Разработка
Пожалуйста, ознакомьтесь с руководством CONTRIBUTING.md для получения информации о правилах внесения вклада и соглашениях о сообщениях коммитов.
Подробные инструкции по настройке разработки, структуре проекта и локальному тестированию см. в руководстве DEVELOPMENT.md.
После запуска Inspector отобразит URL-адрес, который вы можете открыть в браузере, чтобы начать отладку.
Доступ без аутентификации
Когда параметр запроса tools включает только инструменты, явно разрешенные для использования без аутентификации, размещенный сервер разрешает доступ без токена API.
В настоящее время разрешенные инструменты: search-actors, fetch-actor-details, search-apify-docs, fetch-apify-docs, apify-api-search, apify-api-details.
Пример: https://mcp.apify.com?tools=search-actors.
🐦 Canary-релизы PR
Apify MCP разделен на два репозитория: этот репозиторий для основной логики MCP и частный apify-mcp-server-internal для размещенного сервера.
Изменения должны быть синхронизированы между обоими.
Чтобы создать canary-релиз, добавьте метку beta к вашему pull request.
Это публикует пакет на pkg.pr.new для промежуточного тестирования перед слиянием.
Подробности см. в файле рабочего процесса.
🐋 Интеграция с Docker Hub
Apify MCP Server также доступен на Docker Hub, зарегистрирован через репозиторий mcp-registry. Запись в servers/apify-mcp-server/server.yaml должна развертываться автоматически реестром MCP Docker Hub (частота развертывания неизвестна). Перед внесением серьезных изменений в версию сервера stdio протестируйте ее локально, чтобы убедиться, что сборка Docker проходит. Для тестирования измените source.branch на вашу ветку PR и запустите task build -- apify-mcp-server. Дополнительные сведения см. в CONTRIBUTING.md.
Входная схема Актора обрабатывается для совместимости с большинством MCP-клиентов при соблюдении стандартов JSON Schema. Обработка включает:
Описания длиннее 500 символов (как определено в ACTOR_MAX_DESCRIPTION_LENGTH) обрезаются на последнем полном предложении в этом окне или на последнем полном слове, если нет разрыва предложения, и помечаются как [Description truncated].
Поля перечислений, которые укладываются в 2000 объединенных символов (как определено в ACTOR_ENUM_MAX_LENGTH), сохраняются полностью; более крупные перечисления опускаются, а в описание добавляется краткое примечание и несколько примеров значений.
Обязательные поля явно помечаются префиксом REQUIRED в их описаниях для совместимости с фреймворками, которые могут неправильно обрабатывать JSON-схему.
Вложенные свойства создаются для особых случаев, таких как конфигурация прокси и источники списков запросов, чтобы обеспечить правильную структуру ввода.
Типы элементов массива выводятся, когда они явно не определены в схеме, с использованием приоритетного порядка: явный тип в элементах > тип предзаполнения > тип значения по умолчанию > тип редактора.
Значения перечислений и примеры добавляются в описания свойств, чтобы обеспечить их видимость, даже если клиент не полностью поддерживает JSON-схему.
Арендованные Акторы доступны только для использования с размещенным MCP-сервером по адресу https://mcp.apify.com.. При локальном запуске сервера через stdio вы можете получить доступ только к Акторам, уже добавленным в ваш локальный набор инструментов. Чтобы динамически искать и использовать любого Актора из Apify Store, включая арендованных, подключитесь к размещенной конечной точке.
🔒 Политика конфиденциальности
При использовании этого сервера ваши запросы и входные данные Акторов отправляются в Apify API для выполнения.
Данные не передаются третьим лицам, кроме случаев, необходимых для запуска запрошенных Акторов.
Полные сведения о сборе, использовании, передаче и хранении данных см. в Apify Legal.
🤝 Вклад в проект
Мы приветствуем сообщения об ошибках, запросы функций и исправления документации. Присылайте нам проблему, а не патч — точное описание проблемы с воспроизведением полезнее, чем pull request.
🐛 Сообщить об ошибке: Откройте issue с воспроизведением. Это самое полезное, что вы можете нам отправить.
💡 Предложить функцию: Откройте issue — опишите проблему и тех, кто с ней сталкивается, а не реализацию.
🔧 Код: Работайте только над issue, на которое пригласил мейнтейнер. Открытый issue не является приглашением взяться за него; несанкционированные pull request закрываются.
📚 Документация: Опечатки, битые ссылки и неправильные команды отправляются сразу в PR.
