СБИС (Saby) для Claude — поиск компаний без браузера

ru-companies-mcp — MCP-сервер, который подключает к Claude (Claude Desktop, Claude Code) каталог компаний СБИС / Saby, открытую отчётность ФНС и вакансии hh.ru. Claude ищет компании по отрасли и региону, открывает карточки и проверяет финансы сам — без расширения Claude in Chrome, без скриншотов и разбора страниц, поэтому тратит заметно меньше лимитов.

Кому пригодится:

• ищете работу — «найди экологические компании в Татарстане с выручкой от 100 млн, проверь отчётность и вакансии»;

• ищете клиентов или партнёров — список компаний по отрасли и региону с директором, адресом и выручкой, выгрузка в Excel;

• проверяете контрагента — карточка по ИНН, статус, ОКВЭД, выручка и прибыль по годам из ФНС;

• у вас платный аккаунт СБИС — с ним в карточках видны телефоны и email.

Чем отличается от других СБИС MCP-серверов (sbis-mcp-ru, sbis-mcp): те работают с документооборотом (ЭДО: счета, акты, подписи) и требуют API-доступа. Этот — про поиск и проверку компаний, работает без аккаунта.

English: MCP server that lets Claude search Russian companies in the SBIS/Saby catalog by industry and region, read company cards, Federal Tax Service (FNS) financial statements and hh.ru vacancies — no browser needed.

Неофициальный проект, не связан с ООО «Тензор» (Saby/СБИС), ФНС или hh.ru. Использует публичные страницы и открытые данные; запросы к saby.ru идут не чаще раза в 2 секунды, как просит их robots.txt. Для личного использования, не для массового сбора.

Что умеет

Экологические категории каталога, например: «Защита окружающей среды» (~14 800 компаний), «Экология, охрана природы, уборка территорий», «Вывоз, утилизация и переработка мусора», «Оборудование и системы очистки», «Услуги по геологическим и геофизическим изысканиям».

Related MCP server: hh-ru MCP server

Установка

Нужен Python 3.10+ и uv (или pip).

uvx --from git+https://github.com/glalker/ru-companies-mcp ru-companies-mcp

Claude Desktop

claude_desktop_config.json (Настройки → Разработчик → Изменить конфиг):

{
  "mcpServers": {
    "ru-companies": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/glalker/ru-companies-mcp", "ru-companies-mcp"],
      "env": {
        "HH_APP_TOKEN": "",
        "SBIS_LOGIN": "",
        "SBIS_PASSWORD": ""
      }
    }
  }
}

Claude Code

claude mcp add ru-companies -- uvx --from git+https://github.com/glalker/ru-companies-mcp ru-companies-mcp

Все переменные необязательны: без них работает поиск, карточки, отчётность и шорт-лист.

Примеры запросов к Claude

• «Какие есть категории про отходы и экологию?»

• «Найди компании из категории "Защита окружающей среды" в Татарстане с выручкой от 50 млн»

• «Покажи отчётность ИНН 7734690939 за последние годы — растёт или падает?»

• «Есть ли у них вакансии эколога?»

• «Добавь их в шорт-лист с заметкой "написать HR", потом выгрузи в CSV»

Платный аккаунт СБИС

В публичных карточках телефоны и email замаскированы ((495) 21 ** 16). Если задать SBIS_LOGIN и SBIS_PASSWORD от платного аккаунта, company_card получает их полностью (проверено на одном платном тарифе). Численность сотрудников при этом может остаться скрытой — это зависит от тарифа. Чтобы проверить, что даёт ваш тариф:

SBIS_LOGIN=... SBIS_PASSWORD=... uvx --from git+https://github.com/glalker/ru-companies-mcp ru-companies-mcp probe

Команда сравнит публичную и авторизованную выдачу и сохранит ~/.ru-companies-mcp/probe-report.json. В отчёте только названия полей и счётчики — без пароля, сессии и данных компаний. Приложите его к issue, чтобы помочь добавить контакты.

Разработка

python -m venv .venv && .venv/bin/pip install -e ".[dev]"
.venv/bin/pytest --cov=ru_companies_mcp     # офлайн-тесты
.venv/bin/pytest -m live                    # проверка живых сервисов

Как устроен поиск по saby.ru: страница каталога вызывает JSON-RPC метод Contractor.FindByRequisitesPromo на https://saby.ru/profile/service/; сервер делает тот же вызов (см. src/ru_companies_mcp/saby.py). Если Saby поменяет вёрстку или метод, первыми упадут live-тесты.

Лицензия

MIT