Tomba MCP

Tomba.io MCP Server

Сервер Model Context Protocol (MCP) для интеграции с API Tomba.io. Этот сервер предоставляет комплексные возможности поиска, проверки и обогащения email-адресов через стандартизированный интерфейс MCP.

Возможности

Инструменты (доступно 28)

Поиск email-адресов

• Domain Search: Найдите все email-адреса, связанные с доменом
• Email Finder: Генерация вероятных email-адресов на основе имен и доменов
• Author Finder: Поиск email-адресов авторов статей
• LinkedIn Finder: Поиск email-адресов по URL-профилям LinkedIn
• Email Count: Получение общего количества email-адресов для доменов
• Email Sources: Поиск, где email-адрес был найден в интернете
• Email Format: Получение шаблонов формата email-адресов, используемых доменом

Проверка

• Email Verifier: Проверка доставляемости email и наличие в базе данных

Обогащение

• Email Enrichment: Обогащение email-адресов дополнительными контактными данными
• Person Enrichment: Поиск данных о человеке по email (имя, должность, социальные профили)
• Company Enrichment: Поиск данных о компании по домену (отрасль, размер, местоположение)
• Combined Enrichment: Комбинированное обогащение (человек + компания) по email

Телефон

• Phone Finder: Поиск номеров телефонов по email, домену или LinkedIn
• Phone Validator: Проверка номеров телефонов и информации об операторе

Интеллектуальный анализ доменов

• Domain Status: Проверка, является ли домен веб-почтой или одноразовым
• Autocomplete: Подсказки названий компаний с логотипом и информацией о домене
• Similar Finder: Поиск похожих доменов на основе целевого домена
• Technology Finder: Определение технологических стеков, используемых веб-сайтами
• Location: Получение количества сотрудников по странам

Поиск компаний

• Companies Search: Поиск компаний с использованием запросов на естественном языке с расширенными фильтрами

Аккаунт и управление

• Account Info: Получение информации о текущем аккаунте, плане и кредитах
• Usage Info: Получение статистики использования API по всем конечным точкам
• List Flags: Просмотр отправленных флагов данных со статусом и возвратом кредитов
• Create Flag: Сообщение о некорректных данных (жесткие отказы, недействительные email) для возврата кредитов
• List Leads: Просмотр лидов с опциональным фильтром по домену
• Create Lead: Добавление нового лида в список
• List Keys: Просмотр ключей API
• Get Logs: Получение последних журналов запросов API

Ресурсы (доступно 7)

• tomba://api/status - Статус API и информация об аккаунте
• tomba://domain/{domain} - Информация о домене
• tomba://email/{email} - Информация об email
• tomba://similar/{domain} - Анализ похожих доменов
• tomba://technology/{domain} - Информация о технологическом стеке
• tomba://docs/api - Документация API
• tomba://docs/tools - Документация по инструментам

Промпты (16 готовых рабочих процессов)

• find_contact - Поиск полной контактной информации о человеке
• verify_email_list - Пакетная проверка email-адресов
• research_company - Исследование контактов и структуры компании
• enrich_lead - Обогащение лида всеми доступными данными
• find_journalists - Поиск контактов журналистов из статей
• phone_finder - Поиск номеров телефонов для контактов
• validate_phone - Проверка номера телефона
• competitor_analysis - Анализ конкурентов с использованием похожих доменов и технологий
• technology_audit - Комплексный технологический аудит веб-сайта
• domain_insights - Получение комплексной информации о домене, включая количество email и технологии
• bulk_domain_research - Исследование нескольких доменов для получения количества email и базовой информации
• find_target_companies - Поиск компаний с расширенными фильтрами (размер, тип, выручка, отрасль)
• market_research - Исследование компаний в рыночном сегменте с комплексной фильтрацией
• lead_generation - Генерация лидов путем поиска компаний и их контактов
• prospect_enrichment - Обогащение корпоративных потенциальных клиентов комплексными данными
• industry_analysis - Анализ компаний в отрасли с детальной сегментацией

Параметры фильтров для промптов поиска компаний

Фильтр	Доступные значения
Размер	1-10 (Микро), 11-50 (Малые), 51-250 (Средние), 251-1K (Средне-крупные), 1K-5K (Крупные), 5K-10K (Очень крупные), 10K-50K (Корпоративные), 50K-100K (Массивные), 100K+ (Глобальные)
Тип	образование, государственный, некоммерческий, частный, публичный, личный
Выручка	$0-$1M, $1M-$10M, $10M-$50M, $50M-$100M, $100M-$250M, $250M-$500M, $500M-$1B, $1B-$10B, $10B+
Отрасль	На основе кодов отраслей LinkedIn V2 (более 140 отраслей, включая компьютерное программное обеспечение, финансовые услуги, больницы и здравоохранение и т. д.)

Производительность и надежность

Тайм-аут

Все вызовы API имеют тайм-аут 120 секунд. Поиск Tomba выполняется в реальном времени на живой инфраструктуре — время ответа варьируется в зависимости от скорости SMTP-сервера целевой компании, скорости ответа веб-сайта и глубины обнаружения catch-all.

Повторные попытки с экспоненциальной задержкой

Все вызовы API автоматически повторяются до 3 раз с экспоненциальной задержкой при:

• 429 Too Many Requests (превышен лимит запросов)
• 5xx ошибки сервера

Задержки повторных попыток: 1с → 2с → 4с.

Лимиты запросов

Лимиты запросов применяются для каждой конечной точки и каждого плана:

План	В секунду	В минуту	В день
Free	1	2	5
Basic	3	50	500
Growth	5	80	1,000
Pro	8	150	4,000
50,000+ планы	Безлимит	Безлимит	Безлимит

Кредиты не списываются, когда Tomba не может предоставить результат. Повторные запросы в течение 30 дней не учитываются повторно.

Варианты транспорта

• stdio - Стандартный ввод/вывод (по умолчанию, для Claude Desktop)
• http - HTTP-сервер с REST-конечными точками

Установка

Предварительные требования

• Node.js 18 или выше
• npm или yarn
• Аккаунт Tomba API (Зарегистрироваться здесь)

Скриншоты

Примечание: Пакет npm был переименован с tomba-mcp-server на @tomba-io/tomba-mcp-server. Пожалуйста, обновите свои конфигурации соответствующим образом.

Вариант 1: Установка через NPX (рекомендуется)

Самый простой способ использовать сервер Tomba MCP — через npx, который не требует клонирования репозитория:

macOS/Linux

Добавьте в ваш claude_desktop_config.json (~/Library/Application Support/Claude/claude_desktop_config.json):

{
    "mcpServers": {
        "tomba": {
            "command": "npx",
            "args": ["-y", "@tomba-io/tomba-mcp-server"],
            "env": {
                "TOMBA_API_KEY": "your-api-key-here",
                "TOMBA_SECRET_KEY": "your-secret-key-here"
            }
        }
    }
}

Windows

Добавьте в ваш claude_desktop_config.json (%APPDATA%\Claude\claude_desktop_config.json):

{
    "mcpServers": {
        "tomba": {
            "command": "npx",
            "args": ["-y", "@tomba-io/tomba-mcp-server"],
            "env": {
                "TOMBA_API_KEY": "your-api-key-here",
                "TOMBA_SECRET_KEY": "your-secret-key-here"
            }
        }
    }
}

Примечание: Флаг -y автоматически принимает запрос на установку, и npx всегда будет загружать последнюю версию.

Вариант 2: Установка из исходного кода

Если вы хотите изменить сервер или внести вклад в разработку:

# Clone the repository
git clone https://github.com/tomba-io/tomba-mcp-server.git
cd tomba-mcp-server

# Install dependencies
yarn install

# Build the project
yarn build

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

Навык OpenClaw

Этот репозиторий включает локальные навыки рабочей области в skills/. Плагин Cursor (.cursor-plugin/plugin.json) также загружает их.

skills/tomba-contact-intelligence/SKILL.md — основной навык. Он помогает агенту выбирать правильные инструменты Tomba MCP для поиска контактов, исследования компаний, проверки email, поиска телефонов и рабочих процессов обогащения потенциальных клиентов.

Каждый инструмент MCP также имеет свою собственную папку навыка, skills/tomba-<tool-name>/SKILL.md. Каждый из них охватывает входные данные инструмента, рабочий процесс, ожидаемый результат и пример вызова:

Группа	Навыки
Email	tomba-email-finder, tomba-email-verifier, tomba-email-enrichment, tomba-email-count, tomba-email-sources, tomba-email-format
Discovery	tomba-domain-search, tomba-author-finder, tomba-linkedin-finder
Phone	tomba-phone-finder, tomba-phone-validator
Company	tomba-companies-search, tomba-company-enrichment, tomba-similar-finder, tomba-technology-finder, tomba-autocomplete, tomba-location, tomba-domain-status
Enrichment	tomba-person-enrichment, tomba-combined-enrichment
Leads	tomba-list-leads, tomba-create-lead
Data quality	tomba-list-flags, tomba-create-flag
Account	tomba-account-info, tomba-usage-info, tomba-list-keys, tomba-get-logs

Для использования:

1. Откройте этот репозиторий как рабочее пространство OpenClaw или скопируйте нужные каталоги skills/tomba-* в каталог навыков OpenClaw.
2. Убедитесь, что сервер Tomba MCP настроен и доступен для OpenClaw.
3. Запустите новый сеанс OpenClaw, чтобы навык был загружен.

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

• "Найди лучший контакт для партнёрств на stripe.com и проверь email перед тем, как вернуть его."
• "Исследуй финтех-компании в Германии, затем определи вероятных контактов для продаж среди лучших совпадений."
• "Обогати этот лид email, телефоном, технологиями компании и похожими конкурентами: jane@acme.com"

Плагин Claude Code

Этот репозиторий также является маркетплейсом плагинов Claude Code (.claude-plugin/). Плагин объединяет все навыки из skills/ и подключается к размещённому MCP-серверу по адресу https://mcp.tomba.io/mcp:

/plugin marketplace add tomba-io/tomba-mcp-server
/plugin install tomba@tomba

Затем запустите /mcp и авторизуйте сервер tomba через OAuth. Ключи API не требуются. Навыки плагина имеют пространства имён, например /tomba:tomba-domain-search zapier.com.

Плагин Codex

.codex-plugin/plugin.json упаковывает те же навыки для OpenAI Codex. Он загружает удалённый сервер из .mcp.json. После установки плагина войдите через OAuth:

codex mcp login tomba

Чтобы использовать ключи API вместо OAuth, отправьте заголовки X-Tomba-Key и X-Tomba-Secret или Authorization: Bearer <base64(ta_key:ts_secret)> на адрес https://mcp.tomba.io/mcp.

Настройка Claude Desktop

Чтобы использовать этот сервер с Claude Desktop, добавьте конфигурацию в файл claude_desktop_config.json.

Использование NPX (рекомендуется)

Этот метод автоматически использует последнюю опубликованную версию:

macOS/Linux (~/Library/Application Support/Claude/claude_desktop_config.json):

{
    "mcpServers": {
        "tomba": {
            "command": "npx",
            "args": ["-y", "@tomba-io/tomba-mcp-server"],
            "env": {
                "TOMBA_API_KEY": "your-api-key-here",
                "TOMBA_SECRET_KEY": "your-secret-key-here"
            }
        }
    }
}

Windows (%APPDATA%\Claude\claude_desktop_config.json):

{
    "mcpServers": {
        "tomba": {
            "command": "npx",
            "args": ["-y", "@tomba-io/tomba-mcp-server"],
            "env": {
                "TOMBA_API_KEY": "your-api-key-here",
                "TOMBA_SECRET_KEY": "your-secret-key-here"
            }
        }
    }
}

Использование локальной установки

Если вы собрали из исходного кода, используйте абсолютный путь к вашей установке:

macOS/Linux:

{
    "mcpServers": {
        "tomba": {
            "command": "node",
            "args": ["/ABSOLUTE/PATH/TO/tomba-mcp-server/server/index.js"],
            "env": {
                "TOMBA_API_KEY": "your-api-key-here",
                "TOMBA_SECRET_KEY": "your-secret-key-here"
            }
        }
    }
}

Windows:

{
    "mcpServers": {
        "tomba": {
            "command": "node",
            "args": [
                "C:\\ABSOLUTE\\PATH\\TO\\tomba-mcp-server\\server\\index.js"
            ],
            "env": {
                "TOMBA_API_KEY": "your-api-key-here",
                "TOMBA_SECRET_KEY": "your-secret-key-here"
            }
        }
    }
}

Важные примечания:

• Замените your-api-key-here и your-secret-key-here на ваши реальные учётные данные Tomba API
• Для локальной установки замените /ABSOLUTE/PATH/TO/tomba-mcp-server на полный путь к каталогу установки
• Перезапустите Claude Desktop после обновления конфигурации

Получение учётных данных Tomba API

1. Посетите https://tomba.io
2. Зарегистрируйте аккаунт или войдите
3. Перейдите в панель управления
4. Откройте настройки API
5. Скопируйте ваш API Key и Secret Key

Альтернатива: использование HTTP-транспорта

Для HTTP-транспорта с npx:

{
    "mcpServers": {
        "tomba": {
            "command": "npx",
            "args": [
                "-y",
                "@tomba-io/tomba-mcp-server",
                "--transport",
                "http",
                "--port",
                "3000"
            ],
            "env": {
                "TOMBA_API_KEY": "your-api-key-here",
                "TOMBA_SECRET_KEY": "your-secret-key-here"
            }
        }
    }
}

Для HTTP-транспорта с локальной установкой:

{
    "mcpServers": {
        "tomba": {
            "command": "node",
            "args": [
                "/ABSOLUTE/PATH/TO/tomba-mcp-server/server/index.js",
                "--transport",
                "http",
                "--port",
                "3000"
            ],
            "env": {
                "TOMBA_API_KEY": "your-api-key-here",
                "TOMBA_SECRET_KEY": "your-secret-key-here"
            }
        }
    }
}

Использование

Параметры командной строки

Usage: tomba-mcp-server [options]

Options:
  --transport <type>    Transport type: 'stdio' or 'http' (default: stdio)
  --port <number>       Port number for HTTP transport (default: 3000)
  --help                Show help message

Environment Variables:
  TOMBA_API_KEY         Your Tomba API key (required)
  TOMBA_SECRET_KEY      Your Tomba secret key (required)

Examples:
  # Run with stdio transport (default)
  node server/index.js

  # Run with HTTP transport on default port (3000)
  node server/index.js --transport http

  # Run with HTTP transport on custom port
  node server/index.js --transport http --port 8080

Автономный HTTP-сервер

Вы также можете запустить сервер как автономный HTTP-сервис:

export TOMBA_API_KEY="your-api-key"
export TOMBA_SECRET_KEY="your-secret-key"
node server/index.js --transport http --port 3000

Конечные точки HTTP API

• POST /mcp — отправка JSON-RPC запросов
• GET /mcp — Server-Sent Events для уведомлений (требуется заголовок X-Session-Id)
• DELETE /mcp — завершение сеанса (требуется заголовок X-Session-Id)
• GET /health — конечная точка проверки состояния
• GET /sessions — список активных сеансов (требуется аутентификация)

Пример HTTP-запроса

curl -X POST http://localhost:3000/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "email_finder",
      "arguments": {
        "domain": "stripe.com",
        "firstName": "Patrick",
        "lastName": "Collison"
      }
    },
    "id": 1
  }'

🔧 Разработка

Команды разработки

# Run in development mode
yarn dev

# Build the project
yarn build

# Run tests
yarn test

# Run tests in watch mode
yarn test:watch

# Run tests with coverage
yarn test:coverage

# Lint code
yarn lint

# Fix linting errors
yarn lint:fix

🔍 Отладка и тестирование

MCP Inspector (рекомендуется)

Самый простой способ протестировать и отладить ваш MCP-сервер:

# Build and launch MCP Inspector
yarn debug

Это открывает веб-интерфейс, где вы можете:

• 📋 Просматривать все доступные инструменты
• 🧪 Тестировать инструменты в интерактивном режиме
• 📊 Проверять запросы/ответы
• 🐛 Отлаживать в реальном времени

Альтернативные методы отладки

# Debug TypeScript directly
yarn debug:dev

# Run integration tests
yarn test:integration

# Manual testing
yarn build
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | node server/index.js

Отладка в VS Code

Если вы используете VS Code, воспользуйтесь встроенными конфигурациями отладки:

• Debug MCP Server: отладка скомпилированного JavaScript
• Debug TypeScript: отладка исходного кода TypeScript напрямую
• Debug with Inspector: отладка с MCP Inspector
• Run Tests: отладка тестов Jest

См. DEBUG_GUIDE.md для получения подробных инструкций по отладке.

🧪 Тестирование отдельных инструментов

1. Поиск по домену

Поиск email-адресов, связанных с доменным именем.

{
    "name": "domain_search",
    "arguments": {
        "domain": "tomba.io",
        "limit": 10,
        "page": 1
    }
}

Ответ:

{
  "data": {
    "organization": {
      "website_url": "tomba.io",
      "organization": "Tomba technology web service LLC",
      "location": {
        "country": "US",
        "city": "Claymont",
        "state": "Delaware",
        "street_address": "1228 claymont",
        "postal_code": "19703"
      },
      "social_links": {
        "twitter_url": "https://twitter.com/tombaplatforum",
        "facebook_url": "https://www.facebook.com/tombaplatforum",
        "linkedin_url": "https://www.linkedin.com/company/tomba-io"
      },
      "disposable": false,
      "webmail": false,
      "phone_number": "(850) 790-5575",
      "industries": "Information Technology and Services",
      "founded": "2021",
      "company_size": "1-10",
      "company_type": "privately held",
      "revenue": "$0-$1M",
      "accept_all": false,
      "description": "the most powerful email-finding tool which is able to list all the email addresses of people who are working in a particular company.",
      "pattern": "{l}.{first}",
      "total_similar": 35,
      "keywords": [
        "lead generation software"
      ],
      "ranking": 661495,
      "whois": {
        "registrar_name": "namecheap, inc.",
        "created_date": "2020-07-07T20:54:07+02:00",
        "referral_url": "https://www.namecheap.com/"
      },
      "last_updated": "2025-09-06T00:22:01+02:00"
    },
    "emails": [
      {
        "email": "b.mohamed@tomba.io",
        "first_name": "Mohamed",
        "last_name": "Ben rebia",
        "full_name": "Mohamed Ben rebia",
        "gender": "male",
        "phone_number": false,
        "type": "personal",
        "country": "DZ",
        "position": "CEO",
        "department": "executive",
        "seniority": "senior",
        "twitter": null,
        "linkedin": "https://www.linkedin.com/in/mohamed-ben-rebia",
        "score": 100,
        "verification": {
          "date": "2025-09-22T00:00:00+02:00",
          "status": "valid"
        },
        "sources": [
          {
            "uri": "https://github.com/tomba-io/generic-emails/blob/084fc1a63d3cdaf9a34f255bedc2baea49a8e8b9/src/lib/validation/hash.ts",
            "website_url": "github.com",
            "extracted_on": "2021-02-08T20:09:54+01:00",
            "last_seen_on": "2021-02-08T22:43:40+01:00",
            "still_on_page": true
          },
          ....
        ]
      },
      ...
      ...
      ...
      ...
      ...
    ]
  },
  "meta": {
    "total": 21,
    "pageSize": 10,
    "current": 1,
    "total_pages": 3,
    "params": {
      "domain": "tomba.io",
      "page": 1,
      "limit": 10,
      "department": null,
      "country": null,
      "type": "all",
      "live": false
    }
  }
}

2. Поиск email

Генерация вероятных email-адресов по домену, имени и фамилии.

{
    "name": "email_finder",
    "arguments": {
        "domain": "example.com",
        "firstName": "John",
        "lastName": "Doe"
    }
}

Ответ:

{
    "data": {
        "email": "b.mohamed@tomba.io",
        "first_name": "Mohamed",
        "last_name": "Ben rebia",
        "full_name": "Mohamed Ben rebia",
        "website_url": "tomba.io",
        "company": "Tomba technology web service LLC",
        "position": "CEO",
        "country": "DZ",
        "gender": "male",
        "twitter": null,
        "linkedin": "https://www.linkedin.com/in/mohamed-ben-rebia",
        "score": 100,
        "accept_all": null,
        "phone_number": false,
        "verification": {
            "date": "2025-09-22T00:00:00+02:00",
            "status": "valid"
        },
        "sources": [
            {
                "uri": "https://github.com/tomba-io/generic-emails/blob/084fc1a63d3cdaf9a34f255bedc2baea49a8e8b9/src/lib/validation/hash.ts",
                "website_url": "github.com",
                "extracted_on": "2021-02-08T20:09:54+01:00",
                "last_seen_on": "2021-02-08T22:43:40+01:00",
                "still_on_page": true
            }
        ]
    }
}

3. Проверка email

Проверка доставляемости email-адреса и наличия в базе данных.

{
    "name": "email_verifier",
    "arguments": {
        "email": "b.mohamed@tomba.io"
    }
}

Ответ:

{
    "data": {
        "email": {
            "email": "b.mohamed@tomba.io",
            "result": "deliverable",
            "status": "valid",
            "score": 99,
            "smtp_provider": "Google Workspace",
            "mx": {
                "records": [
                    "aspmx.l.google.com",
                    "alt2.aspmx.l.google.com",
                    "alt1.aspmx.l.google.com",
                    "alt4.aspmx.l.google.com",
                    "alt3.aspmx.l.google.com"
                ]
            },
            "mx_check": true,
            "smtp_server": true,
            "smtp_check": true,
            "accept_all": false,
            "greylisted": false,
            "block": true,
            "gibberish": false,
            "disposable": false,
            "webmail": false,
            "regex": true,
            "whois": {
                "registrar_name": "namecheap, inc.",
                "referral_url": "https://www.namecheap.com/",
                "created_date": "2020-07-07T20:54:07+02:00"
            }
        },
        "sources": [
            {
                "uri": "https://github.com/tomba-io/generic-emails/blob/084fc1a63d3cdaf9a34f255bedc2baea49a8e8b9/src/lib/validation/hash.ts",
                "website_url": "github.com",
                "extracted_on": "2021-02-08T20:09:54+01:00",
                "last_seen_on": "2021-02-08T22:43:40+01:00",
                "still_on_page": true
            }
        ]
    }
}

4. Обогащение email

Обогащение email-адреса дополнительной контактной информацией.

{
    "name": "email_enrichment",
    "arguments": {
        "email": "b.mohamed@tomba.io"
    }
}

Ответ:

{
    "data": {
        "email": "b.mohamed@tomba.io",
        "first_name": "Mohamed",
        "last_name": "Ben rebia",
        "full_name": "Mohamed Ben rebia",
        "website_url": "tomba.io",
        "company": "Tomba technology web service LLC",
        "position": "CEO",
        "country": "DZ",
        "gender": "male",
        "twitter": null,
        "linkedin": "https://www.linkedin.com/in/mohamed-ben-rebia",
        "score": 100,
        "accept_all": null,
        "phone_number": false,
        "verification": {
            "date": "2025-09-22T00:00:00+02:00",
            "status": "valid"
        },
        "sources": [
            {
                "uri": "https://github.com/tomba-io/generic-emails/blob/084fc1a63d3cdaf9a34f255bedc2baea49a8e8b9/src/lib/validation/hash.ts",
                "website_url": "github.com",
                "extracted_on": "2021-02-08T20:09:54+01:00",
                "last_seen_on": "2021-02-08T22:43:40+01:00",
                "still_on_page": true
            }
        ]
    }
}

5. Поиск автора

Поиск email-адресов авторов статей по URL.

{
    "name": "author_finder",
    "arguments": {
        "url": "https://example.com/article"
    }
}

Ответ:

{
    "data": {
        "email": "b.mohamed@tomba.io",
        "first_name": "Mohamed",
        "last_name": "Ben rebia",
        "full_name": "Mohamed Ben rebia",
        "website_url": "tomba.io",
        "company": "Tomba technology web service LLC",
        "position": "CEO",
        "country": "DZ",
        "gender": "male",
        "twitter": null,
        "linkedin": "https://www.linkedin.com/in/mohamed-ben-rebia",
        "score": 100,
        "accept_all": null,
        "phone_number": false,
        "verification": {
            "date": "2025-09-22T00:00:00+02:00",
            "status": "valid"
        },
        "sources": [
            {
                "uri": "https://github.com/tomba-io/generic-emails/blob/084fc1a63d3cdaf9a34f255bedc2baea49a8e8b9/src/lib/validation/hash.ts",
                "website_url": "github.com",
                "extracted_on": "2021-02-08T20:09:54+01:00",
                "last_seen_on": "2021-02-08T22:43:40+01:00",
                "still_on_page": true
            }
        ]
    }
}

6. Поиск через LinkedIn

Поиск email-адресов по URL профилей LinkedIn.

{
    "name": "linkedin_finder",
    "arguments": {
        "url": "https://linkedin.com/in/johndoe"
    }
}

Ответ:

{
    "data": {
        "email": "b.mohamed@tomba.io",
        "first_name": "Mohamed",
        "last_name": "Ben rebia",
        "full_name": "Mohamed Ben rebia",
        "website_url": "tomba.io",
        "company": "Tomba technology web service LLC",
        "position": "CEO",
        "country": "DZ",
        "gender": "male",
        "twitter": null,
        "linkedin": "https://www.linkedin.com/in/mohamed-ben-rebia",
        "score": 100,
        "accept_all": null,
        "phone_number": false,
        "verification": {
            "date": "2025-09-22T00:00:00+02:00",
            "status": "valid"
        },
        "sources": [
            {
                "uri": "https://github.com/tomba-io/generic-emails/blob/084fc1a63d3cdaf9a34f255bedc2baea49a8e8b9/src/lib/validation/hash.ts",
                "website_url": "github.com",
                "extracted_on": "2021-02-08T20:09:54+01:00",
                "last_seen_on": "2021-02-08T22:43:40+01:00",
                "still_on_page": true
            }
        ]
    }
}

7. Поиск телефона

Поиск номеров телефонов по email, домену или профилю LinkedIn.

{
    "name": "phone_finder",
    "arguments": {
        "domain": "tomba.io"
    }
}

Ответ:

{
    "data": {
        "domain": "tomba.io",
        "valid": true,
        "local_format": "(850) 790-5575",
        "intl_format": "+1 850-790-5575",
        "e164_format": "+18507905575",
        "rfc3966_format": "tel:+1-850-790-5575",
        "country_code": "US",
        "line_type": "FIXED_LINE_OR_MOBILE",
        "carrier": "",
        "timezones": ["America/New_York"]
    }
}

8. Проверка телефона

Проверка номеров телефонов и информации об операторе.

{
    "name": "phone_validator",
    "arguments": {
        "phone": "+213667945402"
    }
}

Ответ:

{
    "data": {
        "valid": true,
        "local_format": "0667 94 54 02",
        "intl_format": "+213 667 94 54 02",
        "e164_format": "+213667945402",
        "rfc3966_format": "tel:+213-667-94-54-02",
        "country_code": "DZ",
        "line_type": "MOBILE",
        "carrier": "Mobilis",
        "timezones": ["Europe/Paris"]
    }
}

9. Количество email

Получение общего количества email-адресов для домена.

{
    "name": "email_count",
    "arguments": {
        "domain": "tomba.io"
    }
}

Ответ:

{
    "domain": "tomba.io",
    "total": 245,
    "personalEmails": 198,
    "genericEmails": 47,
    "department": {
        "engineering": 45,
        "sales": 38,
        "marketing": 32,
        "hr": 15,
        "finance": 12,
        "legal": 8,
        "executive": 25,
        "support": 28,
        "other": 42
    },
    "seniority": {
        "junior": 89,
        "senior": 125,
        "executive": 31
    },
    "source": "tomba_email_count"
}

10. Поиск похожих

Поиск похожих доменов на основе конкретного домена.

{
    "name": "similar_finder",
    "arguments": {
        "domain": "tomba.io"
    }
}

Ответ:

{
    "data": [
        {
            "website_url": "summit.com",
            "name": "Summit",
            "industries": "Wholesale"
        },
        {
            "website_url": "hunter.io",
            "name": "Hunter",
            "industries": "Information Technology and Services"
        },
        {
            "website_url": "voilaNorbert.com",
            "name": "VoilaNorbert",
            "industries": "Information Technology and Services"
        }
    ]
}

11. Поиск технологий

Мгновенное определение технологического стека любого веб-сайта.

{
    "name": "technology_finder",
    "arguments": {
        "domain": "tomba.io"
    }
}

Ответ:

{
    "domain": "tomba.io",
    "data": [
        {
            "slug": "intercom",
            "name": "Intercom",
            "icon": "Intercom.png",
            "website": "https://www.intercom.com",
            "categories": {
                "id": 10,
                "slug": "analytics",
                "name": "Analytics"
            }
        }
    ]
}

12. Поиск компаний

Поиск компаний с помощью запросов на естественном языке с расширенными фильтрами, включая местоположение, отрасль, размер и выручку.

{
    "name": "companies_search",
    "arguments": {
        "filters": {
            "location_city": {
                "include": ["san francisco"]
            },
            "industry": {
                "include": ["technology"]
            },
            "size": {
                "include": ["51-200", "201-500"]
            }
        },
        "page": 1,
        "limit": 10
    }
}

Ответ:

{
    "data": {
        "companies": [
            {
                "name": "Tech Company Inc",
                "domain": "techcompany.com",
                "industry": "Technology",
                "location": {
                    "city": "San Francisco",
                    "state": "California",
                    "country": "United States"
                },
                "size": "51-200",
                "revenue": "$10M-$50M"
            }
        ],
        "total": 150,
        "page": 1
    }
}

Доступные фильтры:

• location_city: фильтр по городу с массивами включения/исключения
• location_state: фильтр по региону с массивами включения/исключения
• location_country: фильтр по стране с массивами включения/исключения
• industry: фильтр по отрасли (на основе LinkedIn Industry Codes V2 — 140+ отраслей)
• type: фильтр по типу компании: education, government, nonprofit, private, public, personal
• size: фильтр по размеру компании: 1-10, 11-50, 51-250, 251-1K, 1K-5K, 5K-10K, 10K-50K, 50K-100K, 100K+
• revenue: фильтр по диапазону выручки: $0-$1M, $1M-$10M, $10M-$50M, $50M-$100M, $100M-$250M, $250M-$500M, $500M-$1B, $1B-$10B, $10B+
• founded: фильтр по году основания с массивами включения/исключения
• keywords: фильтр по ключевым словам с массивами включения/исключения
• sic: фильтр по кодам SIC с массивами включения/исключения
• naics: фильтр по кодам NAICS с массивами включения/исключения
• similar: фильтр по похожим доменам с массивами включения/исключения

Ограничение частоты запросов и использование

Лимиты API

Tomba.io применяет ограничение частоты запросов в зависимости от вашего тарифного плана:

• Free Plan: 50 запросов в месяц
• Growth Plan: 5 000 запросов в месяц + 10 000 запросов на проверку
• Pro Plan: 10 000 запросов в месяц
• Enterprise Plan: 50 000 запросов в месяц
• Custom Plan: индивидуальные лимиты

Узнайте больше о тарифных планах Tomba.

Заголовки ограничения частоты

Каждый ответ API включает информацию об ограничении частоты:

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 1609459200

Узнайте больше о лимитах API Tomba.

Обработка ограничений частоты

Когда вы превышаете лимит, API возвращает статус 429 Too Many Requests с:

{
    "error": {
        "type": "rate_limit",
        "message": "Rate limit exceeded. Please try again in 60 seconds",
        "code": 429
    }
}

Рекомендации

1. Отслеживайте использование: проверяйте панель управления на tomba.io/dashboard
2. Реализуйте откат: обрабатывайте ответы 429 с экспоненциальной задержкой
3. Пакетные операции: используйте поиск по домену для нескольких email с одного домена
4. Кэшируйте результаты: сохраняйте результаты локально, чтобы избежать повторных запросов
5. Планируйте заранее: обновите тарифный план в зависимости от характера использования

Советы по использованию

• Поиск домена возвращает несколько email-адресов за один запрос (эффективнее, чем отдельные поиски)
• Проверка email расходует кредиты только для корректных форматов email
• Поиск телефона может возвращать несколько номеров за один запрос
• Обогащение предоставляет полные данные в одном запросе

Устранение неполадок

Сервер не запускается в Claude Desktop

1. Проверьте версию Node.js: Убедитесь, что у вас установлен Node.js 18 или выше

   node --version
   

2. Использование NPX:

   • Убедитесь, что у вас есть стабильное интернет-соединение для первого запуска
   • Флаг -y должен автоматически принять установку
   • NPX кэширует пакет после первого использования

3. Использование локальной установки:

   • Проверьте, что абсолютный путь указан корректно в вашей конфигурации
   • Убедитесь, что server/index.js существует: ls -la server/index.js
   • Убедитесь, что вы успешно выполнили yarn build

4. Проверьте учетные данные API: Убедитесь, что ваши ключи Tomba API корректны

5. Проверьте журналы Claude:

   • macOS: ~/Library/Logs/Claude/mcp*.log
   • Windows: %APPDATA%\Claude\logs\mcp*.log

Проблемы, связанные с NPX

«Команда npx не найдена»:

• Убедитесь, что npm установлен: npm --version
• NPX поставляется с npm 5.2.0+, обновите при необходимости: npm install -g npm

Пакет не найден:

• Проверьте, что пакет опубликован: npm view @tomba-io/tomba-mcp-server
• Попробуйте очистить кэш npm: npm cache clean --force

Пакет всегда загружается:

• Это нормальное поведение с флагом -y
• NPX кэширует пакет после первой загрузки
• Для постоянной установки используйте метод локальной установки

Ошибки аутентификации

• Проверьте ваши ключи API на https://app.tomba.io/dashboard
• Убедитесь, что переменные окружения корректно заданы в конфигурации
• Проверьте, что ваша подписка API активна

Инструменты не отвечают

• Проверьте лимиты скорости вашего Tomba API
• Проверьте сетевое подключение
• Просмотрите журналы сервера на наличие сообщений об ошибках

О Tomba

Основанная в 2020 году, компания Tomba гордится тем, что является самым надежным, точным и глубоким источником данных об email-адресах, доступным где-либо. Мы обрабатываем терабайты данных для создания нашего API поиска email.

Внесение вклада

1. Сделайте форк (https://github.com/tomba-io/tomba-mcp-server/fork)
2. Создайте свою ветку функций (git checkout -b my-new-feature)
3. Зафиксируйте свои изменения (git commit -am 'Add some feature')
4. Отправьте изменения в ветку (git push origin my-new-feature)
5. Создайте новый Pull Request

Лицензия

Пожалуйста, обратитесь к файлу Лицензия для получения дополнительной информации.

Поддержка

• Проблемы GitHub
• Поддержка по email
• Веб-сайт