LidFly MCP — Яндекс Директ, Метрика, Вордстат, Вебмастер, VK Реклама, ВКонтакте, Telegram, MAX и Авито в Claude, ChatGPT, Cursor и Codex

Официальный MCP-проект, готовые конфиги и набор из 27 навыков (skills) платформы LidFly для работы через ИИ со всеми ключевыми площадками: Яндекс Директ, Яндекс Метрика, Яндекс Вордстат (Wordstat), Яндекс Вебмастер, Яндекс Аудитории, AppMetrica, VK Реклама (VK Ads), сообщества ВКонтакте, каналы и группы Telegram, каналы в мессенджере MAX, профиль Авито и Авито Реклама, сайты и интернет-магазины LidFly (Commerce), базы знаний, ИИ-консультант, генерация документов Word (.docx), Пространства (память по проектам) и бухгалтерия УСН «Доходы» — напрямую из Claude Code, Claude Desktop, ChatGPT, OpenAI Codex, Cursor, VS Code (GitHub Copilot), Windsurf, Gemini CLI, OpenCode, Cline и OpenClaw.

Быстрый старт за 3 минуты · Инструкции для вашего ИИ-клиента · Все возможности по площадкам · Готовые промпты · Каталог 27 навыков (Skills) · Личный кабинет LidFly

Проект создан и официально поддерживается командой LidFly (https://lidfly.ru/). Историческое имя репозитория в URL (direct-mcp-ai-project) сохранено для обратной совместимости ссылок, git-репозиториев и автоматических релизов — внутри находится актуальный единый шаблон LidFly MCP v3 для всех рекламных, аналитических, контентных и соцсетевых площадок.

Зачем устанавливать этот проект, а не просто подключать «голый» API

Обычное подключение по API даёт нейросети только «сырые кнопки», из-за чего бот может перепутать клиентские кабинеты, предложить устаревшие настройки кампаний или случайно изменить рабочее объявление. Этот репозиторий превращает ваш ИИ-клиент в аккуратного профильного специалиста:

• Сначала проверка и план — потом действие с вашего согласия. ИИ сам находит нужный проект, рекламный кабинет, счётчик Метрики, группу ВКонтакте или канал в Telegram / MAX, читает текущие цифры и показывает понятный план. Ни одна ставка, кампания, цена или публикация не изменится без вашего явного подтверждения.
• Весь маркетинг, соцсети и продажи в одном окне. Без переключения между десятком вкладок: в одном диалоге проверяйте расход и заявки в Яндекс Директе и VK Рекламе, сводите конверсии с Метрикой, выпускайте посты в Telegram, ВКонтакте и мессенджере MAX (с безопасным предпросмотром в личном боте), отвечайте покупателям на Авито, собирайте статьи из часовых видео и выгружайте отчёты в Google Таблицы.
• 27 проверенных профессиональных навыков (skills) внутри. Ваш ИИ сразу знает актуальные правила Единой перфоманс-кампании (ЕПК) в Директе, совместимость пакетов и целей в VK Ads, работу с автозагрузкой фидов Авито, SEO-аудит по Вебмастеру и Вордстату и редактуру статей для Хабра и VC.ru без нейросетевых штампов.
• Подключение за пару минут без возни с токенами. Единый сервер https://lidfly.ru/mcp/v3 авторизуется через браузер по email (OAuth) — вручную выпускать и копировать API-ключи рекламных площадок в конфиги не нужно.

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

Начать работу можно за 3 минуты — выберите удобный способ:

Шаг 1. Подключите свои площадки в LidFly

1. Войдите в личный кабинет lidfly.ru/app.
2. Подключите нужные сервисы через безопасный OAuth-вход: Яндекс Директ, Яндекс Метрику, Яндекс Аудитории, AppMetrica, Яндекс Вебмастер, VK Рекламу (VK Ads), сообщества ВКонтакте, каналы и группы Telegram, каналы в мессенджере MAX, профиль Авито или Авито Рекламу, сайты и магазины LidFly.
   • Если счётчика Метрики, целей или Вебмастера ещё нет с нуля — соберите их за 15 минут по пошаговой шпаргалке docs/setup-platforms.md.

Шаг 2. Подключите ваш ИИ-клиент

• Без терминала (в пару кликов):
  • OpenAI Codex (macOS / Windows): откройте инструкцию с установщиком на lidfly.ru/codex или docs/setup-codex.md.
  • Claude Desktop и Claude Code: откройте инструкцию на lidfly.ru/claude или docs/setup-claude-code.md.
  • ChatGPT (Plus / Pro / Team в браузере): добавьте MCP-приложение https://lidfly.ru/mcp/v3 по инструкции docs/setup-chatgpt.md.
• Через этот проект-шаблон в редакторе (Claude Code, Cursor, Codex, VS Code, Windsurf, Gemini CLI, OpenCode, Cline, OpenClaw):
  Скачайте ZIP-архив репозитория (кнопка Code → Download ZIP наверху страницы) или клонируйте проект:

  git clone https://github.com/awaik/direct-mcp-ai-project.git
  cd direct-mcp-ai-project
  

  Откройте папку в своём ИИ-клиенте — в корне уже лежат готовые конфигурационные файлы MCP, правила AGENTS.md / CLAUDE.md и папки со скиллами. При первом обращении нажмите Authenticate / Login и подтвердите вход по email.

Шаг 3. Отправьте первый запрос (безопасный режим чтения)

Скопируйте в чат любой из стартовых запросов:

Покажи мои доступные Пространства, рекламные кабинеты и подключённые площадки (Директ, Метрика, VK, Telegram, MAX, Авито).

Проверь мои активные кампании в Яндекс Директе и конверсии в Метрике за последние 30 дней. Найди точки слива бюджета, ничего не меняй без отдельного плана.

Авторизация: вход по email в браузере (OAuth) используется во всех готовых конфигах по умолчанию. Если вы предпочитаете статический API-ключ или ваш клиент не поддерживает OAuth, используйте инструкцию подключения через API-ключ (ключ хранится локально в переменной LIDFLY_TOKEN).

Поддерживаемые Клиенты

Выберите свой ИИ-инструмент — в каждой инструкции есть готовый конфиг, шаги авторизации и примеры первых команд:

Что можно делать через LidFly

Все возможности доступны через единое подключение https://lidfly.ru/mcp/v3 и разделены по понятным рабочим задачам:

1. Контекстная и таргетированная реклама (Яндекс Директ, VK Реклама, Авито Реклама)

• Яндекс Директ — глубокий аудит действующих кампаний, поиск неэффективных ключевых фраз, поисковых запросов и площадок РСЯ, контроль дневного бюджета и стоимости заявки (CPA). Сборка новых Единых перфоманс-кампаний (ЕПК) с нуля: подбор семантики и минус-слов через Вордстат, написание заголовков и текстов, генерация креативов, настройка автостратегий и UTM-разметки.
• VK Реклама (VK Ads) — разбор статистики, показов, кликов и стоимости лида по кампаниям, группам и баннерам. Подготовка и запуск новых кампаний, работа с лид-формами, контекстным таргетингом и автоматическая проверка совместимости пакетов и целей (goal_mode) перед публикацией.
• Авито Реклама — управление рекламными кампаниями, группами и бюджетами в отдельном рекламном кабинете Авито (avito_ads), анализ показов, кликов, затрат и аудиторий.
• Яндекс Аудитории — создание сегментов для ретаргетинга и поиска похожих клиентов (Look-alike): загрузка ваших баз телефонов и email из CSV (с автоматическим хешированием), сбор сегментов по целям Метрики, событиям AppMetrica или геолокации.

2. Публикации, автопостинг и ведение Telegram, ВКонтакте и мессенджера MAX

Ведите контент-план сразу в трёх площадках из одного окна чата или адаптируйте один материал под формат каждой соцсети:

• Telegram (каналы и группы):
  • мгновенный выпуск постов или планирование по расписанию (отложенный постинг до года вперёд);
  • форматирование текста (HTML/Markdown), прикрепление одиночных фото или альбомов (до 10 картинок), скрытие медиа под спойлер, добавление inline-кнопок со ссылками;
  • загрузка собственных фотографий с компьютера или генерация иллюстраций прямо в диалоге;
  • безопасный предпросмотр в боте (telegram_preview_post): перед публикацией в канал ИИ пришлёт готовый пост вам в личный чат с ботом, чтобы вы проверили вёрстку и кнопки с телефона;
  • редактирование, закрепление, открепление и удаление уже вышедших постов.
• ВКонтакте (сообщества и паблики — vk_social):
  • публикация и отложенное планирование записей от имени группы: текст, карусели и сетки фотографий, опросы, ссылки, репосты, а также модерация предложенных постов от подписчиков («предложки»);
  • аналитика сообщества: динамика подписчиков и вирального охвата, рейтинг лучших постов по реакциям и вовлечённости (ER), демография аудитории по возрасту и городам, анализ постов конкурентов;
  • работа с комментариями и клиентами: поиск неотвеченных вопросов под постами, ответы от имени сообщества (текстом и вложениями), удаление спама и переписка с клиентами в личных сообщениях сообщества.
• Мессенджер MAX (каналы — max):
  • мгновенная и отложенная публикация постов (до 4000 символов с разметкой), прикрепление до 12 фото и видео в один пост, отправка аудиозаписей и крупных файлов (до 250 МБ);
  • добавление кнопок-ссылок и кнопок быстрого копирования промокода в один тап;
  • предпросмотр поста в личном чате с ботом (max_preview_post) перед отправкой в канал, закрепление важных публикаций, редактирование и удаление постов без ограничения по давности;
  • чтение полной ленты канала со статистикой просмотров каждого поста, ответы на комментарии, очистка спама, обновление названия, описания и аватарки канала, а также быстрый кросс-постинг из Telegram.

3. Продажи, объявления и общение с покупателями на Авито

Отдельно от рекламного кабинета поддерживается полноценная работа с профилем продавца на Авито (provider: "avito", включая клиентские кабинеты Avito Promo для агентств):

• управление товарными объявлениями, ценами и остатками на складе;
• контроль автозагрузки фидов (Autoload XML/CSV): проверка статуса последней выгрузки, сверка Avito ID и быстрый разбор ошибок модерации по конкретным товарам;
• чтение мессенджера Авито и отправка ответов покупателям, ответы на отзывы и контроль рейтинга продавца;
• просмотр заказов, записей звонков, подключение платных услуг продвижения и управление ставками за целевые просмотры.

4. Веб-аналитика, мобильные приложения, SEO и исследование спроса

• Яндекс Метрика — анализ посещаемости, источников трафика, конверсий по целям и реальной стоимости лида (CPA) в разрезе кампаний и UTM-меток. Проверка посадочных страниц, поисковых фраз и действий посетителей в карточке компании на Яндекс Картах. Создание и настройка целей.
• AppMetrica — аналитика мобильных приложений: активная и новая аудитория (DAU / WAU / MAU), удержание (Retention), источники установок по рекламным кампаниям и трекерам, воронки продуктовых событий внутри приложения.
• Яндекс Вебмастер — контроль индексации и позиций сайта в поиске Яндекса: популярные поисковые запросы, показы, клики и CTR по страницам и регионам, техническая диагностика сайта, проверка sitemap.xml и отправка новых или обновлённых URL на быстрый переобход.
• Яндекс Вордстат (Wordstat) — исследование реального поискового спроса по регионам и городам: частотность фраз, сезонность по месяцам и неделям, сбор семантического ядра и минус-слов (работает сразу через серверный API LidFly, даже если у вас ещё нет кабинета Директа).

5. Сайты, интернет-магазины, базы знаний, ИИ-консультант и договоры

• Сайты и лендинги на LidFly — сборка продающих лендингов, многостраничных сайтов и блогов из готовых адаптивных секций (20 дизайнерских шаблонов) либо точный перенос существующих страниц 1:1. Поддерживаются тонкая настройка CSS, загрузка готовой HTML/ZIP-вёрстки, подключение своего домена, автогенерация Schema.org / Open Graph / RSS и прямая отправка заявок в amoCRM, Битрикс24, Calltouch и MANGO OFFICE.
• Интернет-магазины и меню ресторанов (Commerce) — управление каталогом товаров с категориями, вариациями, размерами и остатками, обработка заказов и приём онлайн-оплаты напрямую через ЮKassa. Автоматическая генерация товарных фидов для Яндекс Маркета / Товаров (yandex-market.yml), Google Merchant и постоянного фида меню для карточки ресторана в Яндекс Бизнесе.
• Базы знаний компании (knowledge-base) — создание и поддержка внутренней или клиентской вики-базы из ваших документов, заметок и ссылок с отслеживанием источников и автоматической проверкой актуальности.
• ИИ-консультант и генерация документов Word (.docx) — обучение умного виджета-консультанта (ermiy_*), который отвечает клиентам на сайте, на Авито и во ВКонтакте; автоматическая генерация договоров, счетов и коммерческих предложений (business_docs_*) по вашему шаблону .docx с подстановкой реквизитов и сквозной нумерацией.

6. Из большого видео — в статью на Хабр / VC.ru, YouTube-упаковка и глубокая редактура («гуманизация»)

В проект встроена цепочка редакторских и медиа-скиллов (video-article-writer, article-writer, article-reviser, human-editorial-polish, youtube-video-seo) и авторский редстандарт в .styles/*.md. Они включаются автоматически, когда вы просите подготовить статью, разобрать видео или отредактировать текст:

• Статья из огромного видео (хоть на 1 ГБ+ и несколько часов) с бесплатной расшифровкой (video-article-writer):
  • Укажите путь к локальному видео- или аудиофайлу (.mp4, .mov, .mkv, .webm — запись вебинара, подкаста, доклада, демо продукта или длинного созвона).
  • ИИ сам через ffmpeg извлекает лёгкую аудиодорожку, при необходимости нарезает многочасовую запись на части, отправляет их в LidFly на бесплатную расшифровку и собирает полный точный транскрипт.
  • По расшифровке пишется фактологическая статья строго по тезисам и цифрам спикера (без выдуманных кейсов и «воды»), после чего автоматически запускаются структурная ревизия и живая человеческая редактура.
• Упаковка видео для YouTube под высокий CTR и поиск (youtube-video-seo):
  • По видеофайлу и его транскрипту ИИ сверяет реальный спрос в Вордстате и готовит полный комплект метаданных для публикации ролика: 3–5 вариантов названий, SEO-описание, точные таймкоды (главы) по реальному хронометражу, теги, текст закреплённого комментария и 3–5 лаконичных формулировок для обложки (превью).
• Статьи для Хабра, VC.ru и блога компании (article-writer + .styles/awaik.md):
  • Готовый редстандарт (.styles/awaik.md) для требовательной аудитории Хабра и VC.ru: структура «Разбор» (гипотеза → проверка → выводы) или «Нарратив» (продуктовый кейс), строгая числовая дисциплина, проверка спроса в Вордстате и карта разделов H2, закрывающая реальный интент читателя.
• Автоматическая «гуманизация» и чистка нейросетевых штампов (article-reviser → human-editorial-polish):
  • Финальным этапом при написании любой статьи (или по отдельному запросу для вашего черновика) ИИ прогоняет текст по каталогу русскоязычных ИИ-паттернов (russian-patterns.md): убирает пустые вступления («в современном динамичном мире», «давайте разберёмся»), фальшивую значимость («играет ключевую роль»), рекламную инфляцию («уникальный», «бесшовный»), симметричные списки-близнецы и двойные выводы — сохраняя 100% фактов, цифр, цитат, кода и ссылок.

7. Долгосрочная память (Пространства), отчёты в Google Таблицы и бухгалтерия УСН

• Пространства (память по каждому проекту и клиенту) — LidFly хранит контекст по каждому бизнесу или клиенту агентства в отдельном проекте (workspace_project_id): брифы, история изменений в кампаниях, результаты аудитов, привязанные кабинеты и задачи. Вы можете ставить как обычные напоминания на почту, так и автоматические запуски ИИ по расписанию (например, каждое утро проверять расход и CPA).
• Выгрузка отчётов в Google Sheets и Google Docs (export-ad-reports) — автоматическая сборка сводных таблиц и отчётов по Яндекс Директу, Метрике, VK Рекламе и Авито Рекламе с формулами и превью рекламных креативов прямо в ваши Google Таблицы или Документы.
• Бухгалтерия УСН «Доходы» (https://lidfly.ru/mcp/accounting) — отдельный защищённый контур для ИП и ООО на УСН «Доходы»: загрузка банковских выписок, эквайринга и чеков, серверный расчёт налога УСН и зарплаты, ведение КУДиР, подготовка расчётных листков и черновиков платёжек.

Стартовые Промпты

Скопируйте подходящий запрос в свой ИИ-клиент после подключения:

Реклама и аналитика (Яндекс Директ, Метрика, VK Реклама, Авито Реклама)

Покажи доступные Пространства, рекламные кабинеты и подключённые соцсети/мессенджеры.

Проверь кампанию "Бренд Москва" в Яндекс Директе: найди scope сам, сделай read-only аудит за 30 дней со сверкой конверсий по целям Метрики и покажи, где теряется бюджет.

Проанализируй мои кампании в VK Рекламе (VK Ads) за последние 14 дней: расход, клики, стоимость целевого действия и какие объявления пора остановить. Ничего не меняй без моего подтверждения.

Покажи активные кампании Авито Рекламы, динамику показов и риски по дневному бюджету. Ничего не меняй.

Соцсети и мессенджеры (Telegram, ВКонтакте, MAX)

Подготовь пост для нашего Telegram-канала и канала в мессенджере MAX с анонсом вебинара, кнопкой регистрации и картинкой: сначала отправь предпросмотр мне в личного бота и ничего не публикуй без моего подтверждения.

Проанализируй наше сообщество ВКонтакте за последние 30 дней: лучшие посты по вовлечённости (ER), динамику охвата и покажи неотвеченные комментарии с вопросами о цене.

Профиль Авито, SEO и поисковый спрос

Проверь профиль продавца на Авито: активные объявления, статус последней автозагрузки фида (Autoload), ошибки модерации и новые сообщения от покупателей.

Собери семантическое ядро через Яндекс Вордстат для направления <ваша услуга в вашем городе>, сгруппируй по интенту и сохрани документ в нужное Пространство.

Проверь сайт example.ru в Яндекс Вебмастере: популярные поисковые запросы, средние позиции, CTR, статус sitemap и критичные технические ошибки.

Видео, статьи на Хабр / VC.ru, YouTube и отчёты

Вот видеофайл webinar.mp4 (1,4 ГБ): сам извлеки из него аудио, отправь на бесплатную расшифровку в LidFly и напиши по нему подробную статью на Хабр / VC.ru в стиле .styles/awaik.md с автоматической ревизией и гуманизацией.

К этому же видео webinar.mp4 подготовь полную упаковку для YouTube: 5 цепляющих названий с проверкой спроса в Вордстате, продающее описание, точные таймкоды, теги, закреплённый комментарий и идеи текста на обложку.

Отредактируй и «очеловечь» этот черновик статьи для VC.ru: убери нейросетевые штампы, канцелярит и воду по каталогу russian-patterns.md, но сохрани все цифры, ссылки и примеры кода.

Выгрузи отчёт по кампании «Бренд Москва» за последние 30 дней в Google Sheets по ссылке <URL>: добавь расходы, показы, клики, конверсии и публичные креативы, затем перечитай диапазон и проверь формулы.

Создай задачу проверить CPA этой кампании через неделю. allowed_tools укажи реальными доменными инструментами будущей проверки.

Пространства Для Агентств И Команд

Пространство хранит долговременную память пользователя, команды или маркетингового агентства. Проект внутри Пространства (Workspace project) — это конкретный бизнес, бренд, направление или клиент агентства.

Канонический идентификатор проекта — workspace_project_id. К нему привязываются документы, брифы, принятые решения, слепки аудитов, задачи и внешние аккаунты площадок (provider entities):

• Яндекс Директ: client_login
• Яндекс Метрика: counter_id
• Яндекс Аудитории: audience_connection_id
• Яндекс Вебмастер: host_id
• VK Реклама (VK Ads): client_id / vk_client_id
• ВКонтакте (сообщества): group_id
• Telegram (каналы и группы): chat_binding_id
• Мессенджер MAX (каналы): chat_binding_id
• Авито (профиль бизнеса): avito_user_id
• Авито Реклама: account_id
• Сайты и магазины LidFly (Commerce): subdomain

Если название клиента или кабинета неоднозначно, ИИ сначала покажет найденных кандидатов и попросит подтвердить точный workspace_project_id — он никогда не создаёт проект «Основной проект» молча и не смешивает данные разных клиентов.

Настройка Под Ваш Бизнес

Чтобы ИИ учитывал специфику вашей компании в каждом диалоге, вы можете заполнить три локальных шаблона в корне проекта:

• PROJECTS.md — описание продукта, сайт, ключевые цели Метрики, целевой CPA, география, подключённые площадки и стоп-темы для минус-слов;
• LEGAL.md — юридические и редакционные ограничения вашей ниши (запрещённые и допустимые формулировки);
• .styles/*.md — редакционные профили для написания статей на Хабр, VC.ru и в блог (в комплекте уже настроен профиль .styles/awaik.md).

Долговременная память по кампаниям и клиентам хранится на сервере в Пространствах LidFly (локальная папка campaigns/ оставлена только как шаблон для ручной миграции старых заметок).

Что Подключается (Архитектура MCP v3)

Основной endpoint (реклама, аналитика, соцсети, мессенджеры, Авито, сайты, контент и Пространства):

https://lidfly.ru/mcp/v3

Дополнительный изолированный endpoint для бухгалтерии УСН «Доходы» (подключается отдельно в разделе Интеграции → Бухгалтерия):

https://lidfly.ru/mcp/accounting

Вместо загрузки сотен разрозненных инструментов в контекстное окно клиента v3 отдаёт компактный верхнеуровневый meta-layer:

search_tools
get_tool_schema
call_tool
call_write_tool
get_methodology
get_provider_context
resolve_campaign_scope
get_write_operation_status
subscription_status

ИИ находит нужный доменный инструмент через search_tools, получает точную схему параметров через get_tool_schema, выполняет чтение через call_tool, а любые изменения — только через защищённый call_write_tool. Каталог возможностей на сервере постоянно расширяется; не привязывайте локальные инструкции к фиксированному числу provider tools.

Памятка для ИИ-агента: поиск инструментов в каталоге

Для задачи о посещаемости, целях или конверсиях сначала ищи search_tools({ query: "metrika" });
для мобильных приложений и установок — query: "appmetrica"; для сегментов и баз клиентов —
query: "audience"; для SEO, индексации и запросов сайта — query: "webmaster"; для спроса и
частотности — query: "wordstat"; для постов в Telegram, ВКонтакте или MAX — query: "telegram",
query: "vk_social" или query: "max"; для объявлений и чатов Авито — query: "avito"; для базы
знаний ИИ-консультанта и договоров — query: "ermiy" или query: "business_docs"; для бесплатной
расшифровки аудио и видео — query: "audio" (request_upload_audio, transcribe_audio_url,
get_transcription). Это относится и к запросам без названия LidFly или сервиса.

Отсутствие профильного инструмента в tools/list не означает отсутствие возможности:
сначала выполни поиск, получи get_tool_schema, затем используй нужный read/write wrapper.
Если поиск пуст, попробуй короткое название сервиса и поиск без фильтров; усечённый
список не является полным каталогом. Наличие инструмента не доказывает доступ к
конкретному счётчику или сайту: scope и разрешения проверяются отдельно через MCP.
Метрика начинает с metrika_get_counters, Вебмастер — с webmaster_get_hosts.
Не подставляй для них client_login Директа.

Skills

В проект встроены 27 специализированных навыков (skills), которые задают ИИ проверенные алгоритмы работы с каждой площадкой:

Канонический авторский источник skills находится в основном репозитории LidFly direct-mcp/skills-source. Этот репозиторий хранит проверенную клиентскую проекцию подписанного immutable release: skills-source/.lidfly-release-lock.json фиксирует выпуск и контрольные суммы. Не редактируйте skills-source/ вручную.

Клиентские копии в .agents/skills (актуальный Codex и универсальные агенты), .codex/skills (совместимость), .claude/skills и .openclaw/skills синхронизируются командой:

node scripts/sync-skills.mjs

Структура Репозитория

.
├── AGENTS.md                  # Главные правила работы ИИ-агента и маршрутизация по площадкам
├── CLAUDE.md                  # Симлинк/копия правил для Claude Code и Claude Desktop
├── README.md                  # Описание возможностей, быстрый старт и каталог навыков
├── PROJECTS.md                # Шаблон брифа вашего бизнеса (цели Метрики, KPI, география, площадки)
├── LEGAL.md                   # Шаблон юридических и редакционных ограничений вашей ниши
├── .styles/awaik.md           # Редакционный стандарт для статей на Хабр, VC.ru и в блог
├── METRIKA-ADS-RULES.md       # Подробные правила работы с API Яндекс Директа и Метрики
├── VK-ADS-RULES.md            # Подробные правила создания и проверки кампаний VK Рекламы
├── docs/setup-*.md            # Пошаговые инструкции подключения для всех ИИ-клиентов
├── skills-source/             # Подписанный источник 27 навыков (skills) LidFly
├── scripts/sync-skills.mjs    # Скрипт синхронизации навыков по папкам клиентов
├── .mcp.json                  # Готовый конфиг MCP для Claude Code
├── .codex/config.toml         # Готовый конфиг MCP для OpenAI Codex
├── .cursor/mcp.json           # Готовый конфиг MCP для Cursor
├── .vscode/mcp.json           # Готовый конфиг MCP для VS Code / GitHub Copilot
├── .windsurf/mcp.json         # Готовый конфиг MCP для Windsurf
├── .cline/mcp_settings.json   # Готовый конфиг MCP для Cline
├── .gemini/settings.json      # Готовый конфиг MCP для Gemini CLI
├── opencode.json              # Готовый конфиг MCP для OpenCode
└── .openclaw/                 # Пример конфига и навыки для OpenClaw

Сопровождение шаблона

• AGENTS.md (и парный CLAUDE.md) держите не больше 28 КиБ. Codex встраивает из AGENTS.md не больше 32 КиБ (project_doc_max_bytes) и молча отбрасывает остальное, а этот лимит общий с AGENTS.md, которые пользователь добавит во вложенные папки. Размер проверяет scripts/test-skills.mjs. В AGENTS.md — только общие правила и маршрутизация, подробные методики — в skills.
• Обновление skills-source/ выполняет scripts/pull-lidfly-skills.mjs: он проверяет pinned Ed25519 key, подписи latest.json/manifest, registry и file digests, а затем меняет только файлы, совпадающие с предыдущим lock. После pull запускается node scripts/sync-skills.mjs. Workflow pull-lidfly-skills.yml запускается через workflow_dispatch.
• Публичные snippets подключения на сайте генерируются из public/js/guides.js основного репозитория LidFly. Если локальные примеры разошлись, синхронизируйте их с public/js/guides.js.
• Экспорт skills в плагин Codex: node scripts/sync-skills.mjs --plugin-target ../lidfly-plugins/plugins/lidfly/skills.

Безопасность

• Не коммитьте локальные файлы с токенами (tokens.env, .openclaw/openclaw.json).
• ИИ-агент никогда не выводит в чат OAuth tokens, refresh tokens, секреты ЮKassa или ключи кабинетов.
• Любые изменения ставок, бюджетов, объявлений, постов или настроек сайта выполняются только через call_write_tool после чтения текущего состояния, preflight-проверки и вашего согласия.
• Для агентств и командных Пространств write-действия требуют точный workspace_project_id.

Ссылки и контакты

• Официальный сайт платформы: lidfly.ru
• Личный кабинет и подключение площадок: lidfly.ru/app
• Установка в пару кликов для Codex: lidfly.ru/codex
• Установка в пару кликов для Claude: lidfly.ru/claude
• Документация возможностей: lidfly.ru/docs
• Быстрый старт на сайте: lidfly.ru/docs/quickstart
• Для рекламных агентств и команд: lidfly.ru/agencies

Темы и теги репозитория (GitHub Topics): yandex-direct, vk-ads, vkontakte, telegram, max-messenger, mcp, claude, chatgpt, yandex-metrika, yandex-webmaster, wordstat, avito, avito-ads, claude-code, cursor, openai-codex, model-context-protocol.