HubSpot Admin Skills — плагин
40 навыков Claude Code для аудита, чистки и автоматизации HubSpot CRM: от отчета по порталу до удаления мусорных контактов.
- 80 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Скрипты читают и меняют данные CRM, включая удаление контактов, а ключ HubSpot хранится в `.env`.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add plugins/hubspot-admin-skillsОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Скрипты читают и меняют данные CRM, включая удаление контактов, а ключ HubSpot хранится в `.env`.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Плагин ведет администратора HubSpot по циклу из пяти шагов. Сначала команды `/hubspot-audit`, `/hubspot-marketing-audit` и `/hubspot-sales-audit` проводят аудит портала только на чтение и выставляют оценки, а `/hubspot-implementation-plan` строит поэтапный план исправлений. Затем навыки работают по схеме «план, до, выполнение, после»: объясняют подход, выгружают CSV как базу, вносят изменения и сверяют результат. Скрипты на Python (`requests`, запуск через `uv run`) ходят в REST API HubSpot по сервисному ключу из `HUBSPOT_ACCESS_TOKEN`. Навыки закрывают дубликаты, контакты без почты, жизненные циклы, списки и воркфлоу, а `/weekly-cleanup-routine` и `/quarterly-database-cleanup` поддерживают порядок. Опционально подключается удаленный MCP-сервер HubSpot для запросов и Agent CLI для массовых операций.
Для кого. Администраторам HubSpot и операционным менеджерам маркетинга и продаж, которые приводят в порядок базу контактов, сделок и воркфлоу.
Подходит, если
- Перед чисткой нужен аудит портала с оценками и приоритетным списком навыков для запуска.
- Контакты без почты удаляют после выгрузки CSV и просмотра списка.
- Воркфлоу создаются через API отключенными, чтобы проверить их в интерфейсе.
- Раз в неделю за пять минут прогоняют регулярную уборку базы.
Не подходит, если
- Работа идет в другой CRM: навыки написаны под API HubSpot.
- Нет доступа к сервисному ключу с нужными правами.
- Пробовать удаление на боевых данных без песочницы.
Пример запроса к агенту
Проведи полный аудит моего портала HubSpot только на чтение, покажи приоритетный список проблем и составь план исправлений.Ограничения
Нужны Claude Code, учетная запись HubSpot с сервисным ключом (Settings, Integrations, Service Keys; токен старого приватного приложения тоже подходит) и Python 3.10 или новее с `uv`. Набор прав зависит от навыка. Навыки изменяют и удаляют записи портала, поэтому удаление и массовые правки сначала проверяйте на тестовом аккаунте разработчика: для этого есть `/sandbox-self-test`, который блокирует работу на боевом портале. Воркфлоу через API создаются в выключенном виде. Лимиты API зависят от тарифа, а Workflows API у HubSpot пока в бете. Навыки, которым нужен интерфейс, дают пошаговые инструкции, а не скрипты.
Как отключить. Выполните `/plugin uninstall hubspot-admin@hubspot-admin-skills` и уберите источник из маркетплейсов. Ключ `HUBSPOT_ACCESS_TOKEN` из `.env` удалите, а сервисный ключ отзовите в настройках HubSpot.
Частые вопросы
С чего начать работу?
С `/hubspot-audit`: он проводит аудит портала только на чтение и называет навык, который исправит каждую находку. Затем `/hubspot-implementation-plan` строит план по порядку и зависимостям.
Какой способ подключения выбрать?
По умолчанию скрипты на сервисном ключе. Удаленный MCP HubSpot подходит для разговорных запросов, но не удаляет записи. Agent CLI в бете берет на себя массовые записи и удаления.
Можно ли проверить навыки без боевого портала?
Да. `/sandbox-self-test` прогоняет набор на бесплатном тестовом аккаунте разработчика с синтетическими данными и убирает за собой. На боевой портал он не запускается.
Нужны ли частные приложения?
Нет, HubSpot прекращает создание приватных приложений 26 октября 2026 года, поэтому навыки просят сервисный ключ. Токен существующего приложения продолжает работать.
Как поддерживать порядок?
Запускайте `/weekly-cleanup-routine` раз в неделю и `/quarterly-database-cleanup` раз в квартал. Аудит подскажет, если найдет проблему без готового навыка.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
Плагины45 навыков по операциям выручки B2B: стратегия, диагностика, метрики, GTM, ICP, позиционирование и скорость сделок.
Методики выхода на рынок для агента: исследование клиентов, аутбаунд, SEO, ABM и аналитика, у каждой есть проверка.
116 скиллов для работы агента с магазином Shopify через Admin API плюс регулярные задания: склад, возвраты, финансы, SEO
GTM Skills от Explorium
GTM Skills
22 скилла для B2B-продаж: списки компаний, обогащение контактов, скоринг лидов и холодные письма на данных Vibe Prospecting MCP
Два плагина для Claude Code: 10 скиллов маркетинга и 9 скиллов продаж с готовыми методиками и фреймворками.
Два скилла для LinkedIn через Linked API: поиск людей и компаний, сообщения, посты и воронка лидов с приглашениями.
Коротко о README
Описаны новинки версий 2.0, 1.2 и 1.1, три способа подключения к HubSpot, установка, порядок работы в пять шагов, справочник из 40 навыков с описаниями, требования и схема репозитория.