Gemlead в вашей CRM, стеке и ИИ.

API для лидогенерации в X позволяет вашим собственным инструментам получать покупателей, найденных в X, и работать с ними без ручной выгрузки списков. API Gemlead отдаёт вам лидов, которых его агенты находят и оценивают в X, каждого с оценкой и её причиной, а также персоны, кампании, диалоги и DM, которые за ними стоят. Подписанные вебхуки вызывают ваш сервер, как только лид становится горячим или отвечает, а MCP-сервер позволяет Claude, ChatGPT или Cursor управлять вашим Gemlead простыми словами. Все три инструмента входят в тариф Business и работают на одном ключе.

Всё дело в скорости: горячий лид, который ждёт во вкладке, пока кто-нибудь перенесёт его в CRM, остывает. Ниже: во что обходится эта задержка, что делает каждый инструмент и как выглядит настоящий запрос.

Почему лиды из X должны попадать в ваш стек

Лиды, которые остаются в отдельном инструменте, обрабатывают поздно или не обрабатывают вовсе.

• Разрозненные инструменты тормозят всё. Больше половины руководителей продаж, использующих ИИ, а именно 51%, говорят, что несвязанные системы замедляют их ИИ-инициативы, а 74% специалистов по продажам сосредоточены на очистке данных, согласно Salesforce State of Sales 2026, опросу 4 050 специалистов по продажам.
• Копирование данных съедает время продаж. Средний продавец тратит на продажи 40% времени. У менеджеров поколения Z это 35%, и они теряют около двух полных часов в неделю на ручной ввод данных, по данным того же отчёта.
• Горячие лиды быстро остывают. В исследовании Harvard Business Review на 1,25 млн лидов компании, которые пытались связаться с лидом в течение часа, почти в семь раз чаще квалифицировали его, чем те, кто ждал дольше.
• Изучение клиентов переходит в ИИ. Gartner прогнозирует, что к 2027 году 95% рабочих процессов продавцов, связанных с изучением клиентов, будут начинаться с ИИ, против менее 20% в 2024 году.

Что делают API для лидогенерации в X, MCP-сервер и вебхуки Gemlead

REST API

Все эндпоинты находятся по адресу https://gemlead.ai/api/v1 и работают с JSON. В Gemlead откройте API в меню, выберите аккаунт X, дайте ключу имя и выберите его права: только read или read и write. Ключ начинается с gl_live_, показывается один раз и видит только данные этого аккаунта X.

Что он охватывает:

• Лиды: получайте список с фильтрами вроде hot, score_min, персоны или даты, смотрите, откуда пришёл лид, переоценивайте его, подписывайтесь на него или сохраняйте в нём свои metadata, например ID в CRM.
• Персоны и источники: создавайте персону, добавляйте источники, меняйте настройки, делитесь ею с другими аккаунтами X.
• Кампании: создавайте черновик из шаблона, запускайте кампанию или ставьте на паузу, читайте статистику и динамику по дням.
• Диалоги: читайте переписку, отправляйте DM с текстом, изображением, GIF, видео или голосовым сообщением, ставьте реакции, перемещайте диалог по воронке.
• Выгрузки и аналитика: выгрузка лидов в CSV или JSON Lines и графики вашей «Панели».
• Julien AI: задавайте ИИ-ассистенту Gemlead вопросы о своём аккаунте прямо из кода.

Ваши горячие лиды, сначала самые новые:

curl -G https://gemlead.ai/api/v1/leads \
  -H "Authorization: Bearer $GEMLEAD_API_KEY" \
  -d hot=true \
  -d limit=10

Каждый лид возвращается со своим профилем X, оценкой score от 0 до 100, причиной оценки score_reason в одном предложении, персоной и статусом. Один ключ делает до 120 запросов в минуту. DM через API ограничены 10 в минуту и 300 в день на аккаунт X, или меньше, если X устанавливает более низкую квоту.

Вебхуки

Зарегистрируйте публичный HTTPS URL в приложении в разделе API или через POST /v1/webhook_endpoints и выберите события:

Каждый запрос содержит заголовок Gemlead-Signature, HMAC SHA256, который вы проверяете секретом своего эндпоинта. Неудачная доставка повторяется 7 раз в течение примерно 45 часов. На аккаунт можно держать до 10 эндпоинтов и ограничить любой из них лидами определённых персон. В руководстве по вебхукам показана проверка на Node.js и Python.

MCP-сервер

Model Context Protocol представляет собой открытый стандарт для подключения ИИ-приложений к внешним системам. Сервер Gemlead по адресу https://gemlead.ai/mcp даёт Claude, ChatGPT, Cursor и Claude Code более 60 инструментов, по одному на каждое действие API: search_leads, get_campaign_stats, list_conversations, send_message, create_export и другие. Claude и ChatGPT входят через OAuth, без копирования ключа. В Claude Code достаточно одной команды:

claude mcp add --transport http gemlead https://gemlead.ai/mcp \
  --header "Authorization: Bearer $GEMLEAD_API_KEY"

Затем спросите: «Покажи сегодняшних горячих лидов персоны „Капперы“ и объясни, почему каждый получил высокую оценку». Инструментам записи нужно право write, и ассистент спрашивает вас, прежде чем что-то отправить, запустить или удалить. Чтобы работать с несколькими аккаунтами X, добавьте по одному подключению на аккаунт. Полная настройка описана в документации.

Почему это работает

• Push лучше поллинга. Вебхук доходит до вашего сервера в момент, когда лид становится горячим, поэтому ваша CRM или менеджер получает его в течение того самого первого часа, без лишних запросов на проверку.
• Одна запись на лида. Сохраните ID из CRM в metadata лида, и каждое следующее событие будет ссылаться на ту же запись. Меньше дублей, меньше чистки.
• ИИ-ассистенты уже говорят на MCP. Anthropic сообщает о более чем 10 000 активных публичных MCP-серверов и более 97 млн загрузок SDK в месяц, а MCP уже приняли ChatGPT, Cursor, Gemini, Microsoft Copilot и Visual Studio Code. Gartner ожидает, что к 2028 году 60% работы B2B-продавцов будет идти через разговорные ИИ-интерфейсы.
• Агентам нужны хорошие данные. Gartner прогнозирует, что к 2028 году меньше 40% продавцов скажут, что ИИ-агенты повысили их продуктивность. Если кормить своих агентов оценёнными лидами с причиной каждой оценки, а не сырым списком, вы окажетесь среди тех, кто видит результат.

Ручные выгрузки или API Gemlead

Для кого API

• Разработчики и RevOps, которые синхронизируют лидов из X с HubSpot, Salesforce, Pipedrive, Attio, Notion или Google Sheets, своим кодом или через сервис автоматизации, принимающий вебхуки.
• Основатели, которые работают в Claude или ChatGPT и хотят видеть горячих лидов и ответы в том же чате.
• Агентства, которые готовят отчёты для клиентов на основе эндпоинтов аналитики, с отдельным ключом на каждый аккаунт X клиента.
• Команды, которые строят своих ИИ-агентов и дают им оценённых лидов Gemlead и его инструменты для DM вместо парсера.
• B2C-продавцы, например каппер или автор с платным сообществом, которые хотят видеть каждого горячего лида в рабочем инструменте своей команды.

Как находят этих лидов, рассказывает статья как находить лидов в X. Прежде чем агент начнёт им писать, прочитайте, что ИИ-SDR умеет и чего не умеет.

Лучшие практики

1. Один ключ на инструмент, на вашем сервере в переменной окружения вроде GEMLEAD_API_KEY. Давайте write только инструментам, которые меняют данные.
2. Проверяйте каждый вебхук. Сверяйте подпись по сырому телу запроса и отклоняйте метки времени старше 5 минут.
3. Отвечайте быстро, обрабатывайте потом. Ответьте 2xx в течение 10 секунд, затем обработайте событие в очереди. События доставляются как минимум один раз, поэтому пропускайте id событий, которые уже обработали.
4. Для больших объёмов используйте выгрузку. Одна выгрузка лучше сотен страниц.
5. Читайте, прежде чем разрешить. Ассистента можно обмануть текстом, который он читает. Проверяйте, что собирается сделать инструмент записи, прежде чем одобрить.

Вопросы и ответы