ScraperCity
официальныйMCP-сервер для генерации B2B-лидов — Apollo, Google Maps, поиск email, пропуск трейсов и более 15 инструментов.
Что можно делать с ScraperCity MCP?
- Собирайте данные о местных компаниях — Получайте данные из Google Maps с телефонами, адресами электронной почты и отзывами по запросу и местоположению, затем проверяйте статус запуска и скачивайте CSV.
- Находите B2B-контакты — Ищите людей в базе лидов или собирайте данные из Apollo по должности, отрасли и местоположению.
- Проверяйте и находите адреса электронной почты — Проверяйте доставляемость с помощью
validate_emailsили находите рабочий адрес электронной почты по имени и компании. - Ищите мобильные номера — Находите номера телефонов по профилю LinkedIn или адресу электронной почты либо выполняйте поиск по имени, адресу электронной почты, телефону или адресу.
- Проверяйте статус запуска и скачивайте результаты — Отслеживайте ход сбора данных и сохраняйте готовые результаты в формате CSV после успешного завершения.
Документация
ScraperCity — генерация B2B-лидов для ИИ-агентов
Получайте лиды, проверяйте адреса электронной почты, находите мобильные номера и собирайте данные о компаниях — всё с помощью ИИ-агента, CLI или кода. Один пакет: MCP-сервер, CLI и JavaScript SDK. Python SDK — pip install scrapercity.
ScraperCity предоставляет ИИ-агентам доступ к более чем 15 инструментам для работы с B2B-данными: сбор данных из Apollo, извлечение данных из Google Maps, поиск и проверка адресов электронной почты, поиск мобильных номеров, поиск людей, данные об интернет-магазинах, сведения о судимостях и многое другое.
Начните здесь (API-ключ не нужен)
npx scrapercity start "dentists in Austin"
Или попросите агента вызвать инструмент MCP start_here или GET https://app.scrapercity.com/api/v1/start?query=.... Без ключа вы получите обзор: что такое ScraperCity, как зарегистрироваться, какие есть тарифы и условия пробного периода, а также реальные поисковые запросы с актуальным количеством результатов. С ключом сервис составит план для вашей учётной записи и вернёт точный следующий вызов.
О пробном периоде — без прикрас: это реальное использование, а не демонстрация или бесплатный тариф: кредит в размере $5 на 7 дней, который действует для всех инструментов и баз данных по обычным ценам. Вы сможете получать реальные записи с первого дня и оценить данные. При регистрации требуется указать карту. По окончании 7 дней начнёт действовать тариф, выбранный при регистрации; отмените его до этого срока в разделе оплаты, и больше ничего не спишется. Если кредит закончится раньше, запросы к базам данных будут приостановлены (плата за них не взимается); если запуск скрапера превысит остаток кредита, тариф начнёт действовать раньше. Планирование поисков и проверка количества результатов бесплатны. start_here возвращает актуальные условия.
Быстрый старт
Вариант 1: CLI
npx scrapercity login # enter your API key
npx scrapercity wallet # check balance
npx scrapercity maps -q "plumbers" -l "Denver, CO"
npx scrapercity poll <runId> # wait for results
npx scrapercity download <runId> # save CSV
Вариант 2: MCP-сервер (Claude Code, Cursor, Windsurf и т. д.)
Добавьте в конфигурацию MCP (например, ~/.claude/claude_desktop_config.json):
{
"mcpServers": {
"scrapercity": {
"command": "npx",
"args": ["-y", "--package", "scrapercity", "scrapercity-mcp"],
"env": {
"SCRAPERCITY_API_KEY": "your_api_key_here"
}
}
}
}
Затем попросите ИИ: «Найди с помощью ScraperCity 1000 сантехников в Денвере с адресами электронной почты»
Вариант 3: файл Skill (Claude Code)
Скопируйте файл Skill в свой проект:
npx scrapercity-mcp --print-skill > SCRAPERCITY_SKILL.md
Или скачайте его отсюда: https://scrapercity.com/agents/SKILL.md
Затем в Claude Code: «Прочитай SCRAPERCITY_SKILL.md, найди 2000 директоров по маркетингу в SaaS-компаниях Калифорнии, проверь их адреса электронной почты и сохрани данные в leads.csv»
Вариант 4: прямой вызов API
# Start a Maps scrape
curl -X POST https://app.scrapercity.com/api/v1/scrape/maps \
-H "Authorization: Bearer $SCRAPERCITY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"searchStringsArray":["plumbers"],"locationQuery":"Denver, CO","maxCrawledPlacesPerSearch":500}'
# Check status
curl https://app.scrapercity.com/api/v1/scrape/status/RUN_ID \
-H "Authorization: Bearer $SCRAPERCITY_API_KEY"
# Download CSV when SUCCEEDED
curl -O https://app.scrapercity.com/api/downloads/RUN_ID \
-H "Authorization: Bearer $SCRAPERCITY_API_KEY"
Вариант 5: JavaScript SDK
npm install scrapercity
import { configure, wallet, dbLeads, callTool, TOOLS, openaiTools, anthropicTools } from 'scrapercity'
configure({ apiKey: process.env.SCRAPERCITY_API_KEY })
await wallet()
await dbLeads({ title: 'CEO', country: ['United States'], hasEmail: 'true', limit: 25 })
// Every tool the MCP server offers, by name, with the same arguments
await callTool('plan_search', { query: 'dentists in Austin, Texas' })
// Hand the whole tool list to OpenAI or Anthropic tool calling
const tools = openaiTools() // or anthropicTools()
Вариант 6: Python SDK
pip install scrapercity # add [langchain] or [openai] for agent tools
from scrapercity import ScraperCity, langchain_tools
sc = ScraperCity() # reads SCRAPERCITY_API_KEY
sc.call_tool("query_lead_database", {"title": "CEO", "limit": 10})
tools = langchain_tools() # LangChain / LangGraph
Оба SDK содержат тот же список инструментов, что и MCP-сервер; список обновляется на основе актуальной документации API при каждом выпуске. Руководство: scrapercity.com/sdk. Пакет Python: pypi.org/project/scrapercity.
Цены (генерируются автоматически на основе актуального каталога — не редактировать)
| Инструмент | Конечная точка | Цена |
|---|---|---|
scrape_apollo | /api/v1/scrape/apollo | $0.0039 за лид |
scrape_website_finder | /api/v1/scrape/website-finder | $0.0499 за найденный контакт |
find_people | /api/v1/scrape/skip-trace | $0.0199 за результат (поиски без совпадений тарифицируются как 1 результат) |
scrape_distress_list | /api/v1/scrape/distress-list | $0.05 за объект недвижимости |
validate_emails | /api/v1/scrape/email-validator | $0.0017 за адрес электронной почты |
scrape_maps | /api/v1/scrape/maps | $0.0099 за компанию |
scrape_airbnb | /api/v1/scrape/airbnb-email | $0.019 за результат ($19.00 за 1 000) |
scrape_bizbuysell | /api/v1/scrape/bizbuysell-scraper | $0.0099 за объявление |
scrape_crexi | /api/v1/scrape/crexi-scraper | $0.029 за объект недвижимости |
scrape_angi | /api/v1/scrape/angi-angies-list-scraper | $0.0099 за объявление |
scrape_yelp | /api/v1/scrape/yelp-scraper | $0.0099 за результат |
scrape_zillow_agents | /api/v1/scrape/zillow-agents | $0.029 за агента |
scrape_property_lookup | /api/v1/scrape/property-lookup | $0.15 за объект недвижимости (+$0.10 за контакт владельца) |
search_criminal_records | /api/v1/scrape/criminal-records | $1.00 за поиск (плата взимается только при обнаружении записей) |
scrape_store_leads | /api/v1/scrape/store-leads | $0.0039 за лид |
scrape_builtwith | /api/v1/scrape/techstack | $4.99 за технологию |
scrape_signals | /api/v1/scrape/signals | $0.0094 за компанию, размещающую рекламу; $0.0009 за сайт для каждой проверяемой платформы; $0.0043 за компанию, нанимающую сотрудников; минимальная плата за поиск |
find_emails | /api/v1/scrape/email-finder | $0.05 за найденный адрес электронной почты (БЕСПЛАТНО, если адрес не найден) |
find_mobiles | /api/v1/scrape/mobile-finder | $0.25 за найденный номер (БЕСПЛАТНО, если номер не найден) |
Доступные инструменты
| Инструмент | Назначение | Стоимость |
|---|---|---|
| Apollo | B2B-контакты по должности, отрасли и местоположению | $0.0039/лид |
| Google Maps | Местные компании с телефонами, адресами электронной почты и отзывами | $0.01/место |
| Email Validator | Проверка доставляемости, catch-all и MX-записей | $0.0036/адрес электронной почты |
| Email Finder | Поиск рабочего адреса электронной почты по имени и компании | $0.05/контакт |
| Mobile Finder | Поиск номеров телефонов по LinkedIn или адресу электронной почты | $0.25/входные данные |
| People Finder | Поиск людей по имени, адресу электронной почты, телефону или адресу | $0.02/результат |
| Store Leads | Магазины Shopify/WooCommerce с контактными данными | $0.0039/лид |
| BuiltWith | Все сайты, использующие определённую технологию | $4.99/поиск |
| Criminal Records | Проверка биографических данных по имени | $1.00 при обнаружении |
| Lead Database | B2B-контакты, мгновенный поиск | Включено в тарифы от $149/мес.; ниже этого уровня — оплата за каждый новый лид из кредитов |
| Local Business Database | Местные компании с телефонами, адресами электронной почты и рейтингами, мгновенный поиск | Включено в тарифы от $149/мес.; ниже этого уровня — оплата за каждую новую компанию из кредитов |
Перед отправкой
Проверяйте лиды из любой базы данных перед рассылкой. Для каждой записи указан статус email_check_status (наш собственный сервис проверки адресов электронной почты: valid, valid_catch_all, invalid, unknown, not_checked): отправляйте письма ТОЛЬКО на адреса valid, проверенные за последние 30 дней (email_checked_on), а все остальные сначала проверьте с помощью validate_emails. Для людей (Lead Database) передайте replaceLeftContacts: true в query_lead_database (query_local_business_database и query_ecommerce_database тоже принимают его для контактного лица каждой компании или магазина); в ответе появится replacement.run_id — запуск, который проверяет все адреса электронной почты и заменяет каждого ушедшего сотрудника на человека, который сейчас занимает эту должность. Дождитесь его завершения с помощью check_run_status, затем отправьте CSV из download_results ($0.02 за заменённый контакт, бесплатно на тарифе $649). Как минимум проверьте адреса электронной почты с помощью validate_emails и отправляйте письма только на действительные адреса.
Как это работает
- Запустите сбор данных → получите
runId - Проверяйте статус (или используйте вебхуки) → дождитесь
SUCCEEDED - Скачайте CSV → лиды с полной контактной информацией
Сбор данных из Apollo обычно занимает 15–30 минут. Работа всех остальных скраперов занимает 1–30 минут. Данные о магазинах доступны мгновенно.
Аутентификация
Получите API-ключ на странице app.scrapercity.com/dashboard/api-docs
# Environment variable (recommended)
export SCRAPERCITY_API_KEY="your_key"
# Or save to config file
npx scrapercity login
Вебхуки
Для Apollo и длительных сборов данных настройте вебхук на странице app.scrapercity.com/dashboard/webhooks, чтобы получить уведомление о готовности результатов.
Тарифы
| Тариф | Цена | Кредиты |
|---|---|---|
| Пробный период | 7 дней, требуется карта; затем начинает действовать тариф, выбранный при регистрации | $5 в виде кредита на использование |
| Starter | $49/мес. | $49 (базы данных тарифицируются за каждую запись из кредитов) |
| Growth | $149/мес. | $149 + бонус 10%, базы данных включены |
| Scale | $649/мес. | $649 + бонус 30%, базы данных включены, повышенные лимиты |
Дополнительные кредиты можно приобрести в любое время. scrapercity.com/pricing
Ссылки
- Документация для агентов — руководство по настройке
- Справочник API — полная документация
- Руководство по SDK — JavaScript и Python SDK
- Python SDK на PyPI —
pip install scrapercity - Файл Skill — для Claude Code
- Страница MCP-сервера — настройка
Лицензия
MIT