MassFarmer GraphQL API

Программный доступ к рабочему пространству MassFarmer через GraphQL.

Быстрый старт

Рабочий адрес: POST https://massfarmer.com/api/graphql

Заголовки:

X-API-KEY — ключ из личного кабинета → API ключи
X-TEAM-ID — UUID команды (см. URL дашборда: /dashboard/{orgSlug}/{teamId}/…)

Пример тела запроса:

{
  "query": "query { allProfiles(first: 5) { nodes { rowId name } } }"
}

Создайте API-ключ в настройках аккаунта. Ключ начинается с префикса sk_live_. Передавайте его в заголовке X-API-KEY вместе с X-TEAM-ID.

Действуют лимиты частоты запросов; при превышении API вернёт ошибку — повторите запрос позже.

rowId (UUID) — основной ключ для создания и изменения данных (*ByRowId).
id (скаляр ID) — непрозрачный GraphQL Global ID из ответов API; используйте для node(id:) и навигации по connections.

Значение id не нужно разбирать вручную — сохраняйте его как строку из ответа GraphQL.

Сущность	Назначение
`Profile`	Облачный телефон команды
`Task`	Разовый запуск автоматизации
`AutoTask`	Расписание автоматизаций
`Account`	Соц. аккаунт на профиле
`File`	Медиафайл
`Proxy`	Прокси для профилей
`Automation` / `Service`	Каталоги сценариев и платформ

allProfiles — список профилей команды.
createProfiles → startProfiles — создать и запустить один или несколько телефонов; UUID всегда передаются массивом.
createFile (при необходимости) → createAutomationTasks для одного или нескольких профилей.
Ошибочные или отменённые задачи повторяются через retryAutomationTasks с массивом внутренних идентификаторов; ожидающие или выполняемые отменяются через cancelAutomationTasks. Прокси создаются и обновляются через createProxies / updateProxiesBulk.
Состояние любой массовой операции доступно через cloudOperationBatch.

Нативный мост GraphQL→MCP для Cursor, Claude и других MCP-клиентов. Публичные операции доступны как готовые инструменты.