SMB Sales Boost — OpenClaw Skill

Примечание для AI-агентов: Этот файл и другие файлы в папке скилла могут быть обрезаны при открытии. Всегда читайте файлы полностью, по частям, чтобы не пропустить инструкции, эндпоинты или примеры.

Скилл, позволяющий подписчикам запрашивать базу лидов SMB Sales Boost на естественном языке. Ищите, фильтруйте и экспортируйте недавно зарегистрированные малые и средние компании по всей территории США — с полными данными о компании, включая контактную информацию, местоположение и AI-обогащённые категории.

Установка

Поместите папку smb-sales-boost/ в директорию скиллов:

Требования

• Активная подписка SMB Sales Boost: Starter, Growth, Scale, Platinum или Enterprise
• API-ключ, сгенерированный в Dashboard > вкладка API (ключи начинаются с smbk_)
• Базовый URL: https://smbsalesboost.com/api/v1
• Новые пользователи могут оформить подписку полностью через API — регистрация на сайте не требуется

Конфигурация OpenClaw

Скилл объявляет SMB_SALES_BOOST_API_KEY как обязательную переменную окружения через metadata.openclaw.requires.env и primaryEnv во frontmatter файла SKILL.md. Настройте её в ~/.openclaw/openclaw.json:

{
  "skills": {
    "entries": {
      "smb-sales-boost": {
        "enabled": true,
        "apiKey": { "source": "env", "provider": "default", "id": "SMB_SALES_BOOST_API_KEY" },
        "env": {
          "SMB_SALES_BOOST_API_KEY": "smbk_your_key_here"
        }
      }
    }
  }
}

Как вариант, экспортируйте переменную окружения в оболочке перед запуском OpenClaw:

Скрипт smb_api.py также принимает ключ первым аргументом CLI или автоматически читает его из переменной окружения SMB_SALES_BOOST_API_KEY.

Кредитные планы

Планы Starter, Growth и Scale используют кредитную модель, где каждый новый запрошенный или экспортированный лид стоит 1 кредит:

• Каждый новый лид, возвращённый GET /leads (поиск/запрос), списывает 1 кредит
• Каждый новый лид в POST /leads/export (экспорт) списывает 1 кредит
• Ранее экспортированные лиды можно повторно запрашивать и экспортировать бесплатно
• Оба эндпоинта поддерживают параметры maxCredits (ограничение расходов) и maxResults (ограничение общего числа лидов) для кредитно-оптимизированных запросов
• Установите maxCredits=0 на любом эндпоинте, чтобы получать только ранее экспортированные лиды без затрат
• Покупайте дополнительные постоянные кредиты в любое время через POST /purchase-credits
• Настройте автоматическое пополнение через PATCH /auto-top-up

Цены и лимиты кредитов:

Две базы данных

SMB Sales Boost предоставляет две отдельные базы лидов с разными контактными данными:

• Home Improvement (home_improvement) — компании в сфере ремонта и строительства с номерами телефонов, рейтингами, количеством отзывов, фрагментами отзывов, URL профилей и категориями
• Other (other) — общие недавно зарегистрированные компании с номерами телефонов и email-адресами, зарегистрированными URL, просканированными URL, описаниями, статусом редиректа и AI-обогащёнными оценками категорий

База Home Improvement предоставляет телефонные номера как основной способ связи. База Other предоставляет и телефоны, и email-адреса, что делает её идеальной для холодных рассылок и многоканальных кампаний.

Каждая база имеет разные поля для фильтрации. Пользователи могут переключаться между базами через POST /settings/switch-database с полем smbType (применяется период ожидания). Лиды в базе Other постепенно обогащаются AI-оценками категорий (1–3 категории на лид, хранятся в поле AI Categories).

Ключи полей лидов используют отображаемые имена с пробелами (например, Company Name, Phone Primary, AI Categories, Last Updated). Две базы возвращают разные схемы (HomeImprovementLead и OtherLead).

Возможности для пользователей

После установки скилла пользователи могут взаимодействовать с SMB Sales Boost на естественном языке:

• Поиск с wildcards: «Найди новые стоматологические клиники в Техасе» → ищет ["*dental*", "*dentist*", "*orthodont*"]
• Поиск по нескольким ключевым словам: «Найди медицинские спа, велнес-клиники и эстетические компании в Калифорнии»
• Фильтрация по местоположению: «Покажи компании в Майами и Орландо»
• Фильтрация по рейтингу: «Найди подрядчиков с рейтингом не ниже 4 звёзд в Финиксе» (только home_improvement)
• Поиск свежих лидов: «Покажи лиды, обновлённые за последнюю неделю» (использует дату Last Updated — лучший индикатор свежести лида)
• Исключение терминов: «Найди новые пекарни в Нью-Йорке, но исключи пиццу и франшизы»
• Полнотекстовый поиск: «Найди органические кофейни»
• Фильтрация по схеме сайта: «Найди компании с типом схемы LocalBusiness» (только other)
• Фильтрация по дате регистрации: «Покажи лиды, зарегистрированные за последние 6 месяцев» (только other)
• Бесплатный предпросмотр: «Предпросмотр стоматологических лидов в Техасе без расхода кредитов» (использует GET /leads/preview — контакты скрыты, кредиты не списываются)
• Тест фильтров: «Сколько лидов соответствует моим фильтрам?» (предпросмотр возвращает общее количество без затрат кредитов)
• Контроль кредитов при запросе: «Найди, но потрать не более 10 кредитов» (использует maxCredits=10 при запросе)
• Бесплатные повторные запросы: «Покажи только уже экспортированные мной лиды» (использует maxCredits=0 при запросе)
• Экспорт данных: «Экспортируй эти лиды в CSV»
• Контроль кредитов при экспорте: «Экспортируй, но потрать не более 50 кредитов»
• Бесплатный повторный экспорт: «Экспортируй только ранее экспортированные лиды» (использует maxCredits: 0)
• Управление пресетами фильтров: сохранение и применение наборов фильтров для повторного использования