К основному содержанию
скилл CX Codex

apify-verified-email-finder — скилл для Claude Code

Скилл apify-verified-email-finder собирает список проверенных бизнес-имейлов из Google Maps, поисковой выдачи или списка URL. Проверка выполняется в одном запуске Apify без внешних сервисов.

Apache-2.0 299 установок ★ 300 обновлён 2026-09-22

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add apify/awesome-skills --skill apify-verified-email-finder -a claude-code
Открыть на GitHub

Что делает apify-verified-email-finder

Скилл маршрутизирует запрос в один из трёх Apify-акторов: compass/crawler-google-places для поиска на Maps, apify/google-search-scraper для выдачи поиска или vdrmota/contact-info-scraper для готового списка URL. Во всех трёх случаях включаются одинаковые дополнения — обогащение лидов и проверка email.

Процесс начинается с шести якорных входов: тип исходных данных (локация, ключевое слово или URL), сами данные, фильтр по отделам (c-suite, product, engineering и так далее), максимум контактов на домен, формат вывода (CSV или JSON) и фильтр результатов (только проверенные, проверенные + catch-all, все с email, только с телефоном). Скилл собирает эти параметры в один блок перед запуском актора.

Дедупликация и финальная фильтрация происходят после получения данных. Если нужны оба маршрута (например, результаты и из Maps, и из поиска), можно запустить оба актора и объединить вывод — колонка Source покажет, откуда каждый контакт. Для работы скилл требует токен Apify в переменной APIFY_TOKEN при использовании CLI, в облачных сеансах Claude Code авторизация проходит через MCP-сервер Apify.

Какие задачи решает

  • собрать список потенциальных клиентов с email-адресами из Google Maps по географии и сфере
  • найти email контактов компаний в топе выдачи по поисковому запросу
  • проверить и обогатить email для готового списка доменов или URL
  • отфильтровать контакты по должности (руководство, продакт, разработка, маркетинг, продажи)
  • получить проверенные email без подписки на Hunter, Apollo или других платных сервисов

Примеры запросов агенту

  • Найди контакты в отделе продаж у всех компаний из топ-10 по запросу «CRM для e-commerce», выдай только проверенные email в CSV
  • Соберу список бизнес-контактов из Google Maps для стоматологов в Берлине, фильтр по любым должностям, максимум по 2 контакта с каждого сайта
  • Проверь email и обогати контакты по этим URL: acme-co.example, demo-co.example, test-co.example — нужны только люди из руководства и маркетинга

Как установить apify-verified-email-finder

1Через Skills CLI (Vercel)

npx skills add apify/awesome-skills --skill apify-verified-email-finder -a claude-code

2Вручную: положить файлы

~/.claude/skills/apify-verified-email-finder/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/apify-verified-email-finder/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об apify-verified-email-finder

Как установить apify-verified-email-finder в Claude Code?

Выполни npx skills add apify/awesome-skills --skill apify-verified-email-finder -a claude-code, затем посмотри файл ~/.claude/skills/apify-verified-email-finder/SKILL.md. Для других платформ команда меняется: например, для Cursor — npx skills add apify/awesome-skills --skill apify-verified-email-finder -a cursor с путём .cursor/skills/apify-verified-email-finder/SKILL.md.

Что делает apify-verified-email-finder?

Находит бизнес-email из трёх источников — Google Maps, поисковой выдачи или готового списка URL — и проверяет их подлинность в одном запуске. Встроенная проверка не требует подписки на Hunter, Apollo или других верификаторов.

Какие требования для работы скилла?

Нужен токен Apify в переменной окружения APIFY_TOKEN (при использовании CLI) или подключённый MCP-сервер Apify в Claude Code. При запуске через Node.js требуется версия 20.6 и выше для поддержки флага --env-file.

Исходный текст

SKILL.md · Apache-2.0
---
name: apify-verified-email-finder
description: Builds a list of verified business emails from Google Maps, Google SERPs, or a user-supplied URL list. Verification happens inside the same Apify run — no third-party verifier needed. Use when user asks to find verified emails, build a leads list, scrape emails from Maps or SERP, verify emails for a URL list, or find an Apollo / Hunter alternative.
author: Daniela Ryplová
author_url: https://github.com/danielarypl
metadata:
  keywords: "email, verification, leads, contacts, verified-emails, google-maps, serp, apify, apollo-alternative, hunter-alternative"
---

# Verified Email Finder

Return a list of verified business emails by routing the user's input to the right Apify Actor and turning on the leads enrichment + email verification add-ons in a single run. No third-party verifier (Hunter, NeverBounce, Apollo) needed — verification happens inside the same Actor run.

## Prerequisites
(No need to check it upfront)

The skill supports two execution paths. Pick the one that matches your environment — Steps 4 and 5 show commands for both.

**MCP path (default in Claude sessions, recommended).** If the Apify MCP server is connected, no setup is needed — auth runs through the user's Apify account. Use the `call-actor` and `get-dataset-items` MCP tools.

**Script path (CLI / scheduled / non-Claude execution).** Requires:
- `.env` file with `APIFY_TOKEN`
- Node.js 20.6+ (for native `--env-file` support)

## Workflow

Copy this checklist and track progress:

```
Task Progress:
- [ ] Step 1: Collect the six required anchor inputs
- [ ] Step 2: Route to the correct Actor (confirm if ambiguous)
- [ ] Step 3: Build the Actor input (verification always ON)
- [ ] Step 4: Run the Actor and wait
- [ ] Step 5: Apply the result-scope filter, deduplicate, and render
```

### Step 1: Collect the Six Required Anchor Inputs

Ask all six as one block before any Actor call. Don't bundle Actor-specific optional fields (country code, language, max pages) into this round — surface those as follow-ups.

1. **What do you have to start with?** — `location query` / `SERP keyword` / `URL list`. This drives the routing decision.
2. **The actual input** — the location string, the keyword(s), or the URLs themselves.
3. **Department filter** — one or more of: `c_suite`, `product`, `engineering_technical`, `design`, `education`, `finance`, `human_resources`, `information_technology`, `legal`, `marketing`, `medical_health`, `operations`, `sales`, `consulting`. Default is `any` (leave the array empty), but ask every time.
4. **Max contacts per domain / business** — passed as `maximumLeadsEnrichmentRecords`. Default `3`, but ask every time.
5. **Output format** — `CSV` or `JSON`. Ask every time.
6. **Result scope** — which leads to keep in the deliverable. The Actor always runs the same way (verification always on); this only controls post-run filtering. Pick one:
   - `verified-only` (default) — only leads with `emailVerification.result == "ok"`. Safest for cold email.
   - `verified-plus-catchall` — `ok` plus `catch_all`. Catch-all is often deliverable but unprovable.
   - `all-emails` — any lead with a non-empty `email`, regardless of verification.
   - `with-phone` — any lead with a non-empty phone number, regardless of email status. Use for call campaigns.
   - `everything` — every lead the Actor returned, even incomplete ones.


### Step 2: Route to the Correct Actor

Inspect anchor #1 and pick the Actor.

| User has to start with | Actor ID | Use when |
|---|---|---|
| Location + business type ("dentists in Berlin") | `compass/crawler-google-places` | Local leads list from Maps listings; best when user wants address / phone / hours too |
| Keyword / search query ("best CRM software") | `apify/google-search-scraper` | Contacts from whichever sites Google ranks for a topic |
| Pre-existing URL list (pasted, file path) | `vdrmota/contact-info-scraper` | User already has domains; cheapest route since no discovery step |

All three Actors share the same three add-on fields, so verification behavior is identical across routes.

**Decision examples**

| User says | Route |
|---|---|
| "Dentists in Munich" / "Lawyers in Prague" | Maps |
| "Marketing contacts at the top results for 'AI agent builder'" | Search |
| "Find emails for these 5 URLs: acme-co.example, demo-co.example..." | URL list |
| "Find HR contacts at Fortune 500 companies" | **Ask:** SERP for "Fortune 500 HR" or a URL list? |
| "Find contacts at SaaS companies in Berlin" | **Ask:** Maps for "SaaS companies in Berlin" or SERP for "SaaS companies Berlin"? Maps works best when businesses are Google-Maps-listed. |
| (User pastes both a SERP keyword AND a URL list) | **Ask:** run one route, the other, or both as separate deliverables? |

**Ambiguity rule:** if anchor #1 is unclear, ask **one** follow-up before running. Never burn Actor compute on a guessed route.

**Mixed deliverables:** if the user explicitly asks for two routes in one deliverable, run both Actors and concatenate. The `Source` column makes the mix clear; dedupe by email across the combined output.

### Step 3: Build the Actor Input

Always set these three fields, regardless of which Actor is selected.

| Field | Value |
|---|---|
| `maximumLeadsEnrichmentRecords` | anchor #4 (default `3`, min `1`) |
| `leadsEnrichmentDepartments` | anchor #3 as array, or `[]` if "any" |
| `verifyLeadsEnrichmentEmails` | `true` (always) — guard rail, never set to `false` |

Full per-Actor input parameters and example payloads are in [reference/apify-actor-usage.md](reference/apify-actor-usage.md).

**URL-list pre-validation:** before submitting URLs to `vdrmota/contact-info-scraper`, parse each one and check it is http/https and parseable. Skipped entries must appear in the output as `skipped — invalid URL`, never silently dropped.

### Step 4: Run the Actor

Maps and SERP runs with leads enrichment can take several minutes per query. Raise the timeout for large jobs.

**MCP path (default in Claude sessions):**

Call the `call-actor` tool:
- `actor`: one of the three Actor IDs (`compass/crawler-google-places`, `apify/google-search-scraper`, `vdrmota/contact-info-scraper`)
- `input`: the JSON payload from Step 3
- `callOptions`: `{"timeout": 1800, "memory": 4096}` for a generous budget

The tool returns `runId` and `datasetId`. If `status` is still `RUNNING`, poll with `get-actor-run` (waitSecs up to 45) until `SUCCEEDED`. Capture both IDs for the `run_metadata.json` sidecar.

**Script path (CLI / scheduled use):**

```bash
node --env-file=.env ${CLAUDE_PLUGIN_ROOT}/reference/scripts/run_actor.js \
  --actor "ACTOR_ID" \
  --input 'JSON_INPUT' \
  --output YYYY-MM-DD_verified-emails.csv \
  --format csv \
  --timeout 900
```

Use `--format json` for JSON. The script writes the raw dataset to disk; Step 5 still applies the spurious-match + scope filters on top.

### Step 5: Filter, Deduplicate, and Render

Pull the dataset:
- **MCP path:** call `get-dataset-items` with the `datasetId` from Step 4. Use the `fields` parameter (e.g., `title,searchString,countryCode,city,address,phone,website,leadsEnrichment`) and `clean: true` to keep the response small. For datasets that still exceed the response cap, fetch directly via `curl https://api.apify.com/v2/datasets/<id>/items?fields=...&clean=true` and pipe through `jq`.
- **Script path:** the raw dataset is already on disk in the file from Step 4.

Each record contains business fields plus a `leadsEnrichment` array (Maps, SERP) or top-level lead fields (URL list). Each lead has a `departments` array, a `companyWebsite`, and an `emailVerification` object with `result` (`ok` / `invalid` / `disposable` / `catch_all` / `unknown` / `error`) and `quality` (`good` / `risky` / `bad`).

- **Spurious-match filter (mandatory, always on).** Apply this **first**, before any other filter. The lead-enrichment service can return global-fallback leads when no local match exists (real case observed: a single US-zoo CFO whose `companyWebsite=zoo.org` was attributed to 8 unrelated Polish zoos because the matcher latched onto the `zoo` substring). Drop any lead whose `companyWebsite` hostname doesn't equal the source URL's hostname (strip `https?://`, leading `www.`, anything after `/`; lowercase). Count drops in `run_metadata.json` and call them out in the deliverable header if non-zero.

- **Filter by result scope** (anchor #6). Applied second.

  | Scope | Row-keep logic |
  |---|---|
  | `verified-only` | `emailVerification.result == "ok"` |
  | `verified-plus-catchall` | `emailVerification.result in {"ok", "catch_all"}` |
  | `all-emails` | `email` is non-empty (any result, including missing verification) |
  | `with-phone` | `phone` (or company phone) is non-empty (regardless of email) |
  | `everything` | keep every lead, no filter |

- **Dedupe:** group by lowercased email; keep the first occurrence and merge `Source Query or URL` if the same email appears from multiple sources. For `with-phone` rows that have no email, dedupe by lowercased phone instead.
- **Empty-result surfacing:** if the department filter (anchor #3) produces zero leads for a given domain, include a row for that domain with `Email = ""` and `Email Verification Status = "no leads matched filter"`. Do not silently drop it. This is separate from the result-scope filter above — empty-domain rows are inserted before scope-filtering and always shown.

Output row schema (16 columns, including `Departments`) and per-format rendering details are in [reference/output-formats.md](reference/output-formats.md).

## Worked Examples

- Maps: [examples/example-maps-input.md](examples/example-maps-input.md)
- SERP: [examples/example-search-input.md](examples/example-search-input.md)
- URL list: [examples/example-url-list-input.md](examples/example-url-list-input.md)

## Quality Rules (always enforce)

- **Guard rail:** never submit a run with `verifyLeadsEnrichmentEmails: false`.
- **Provenance & traceability:** populate the `Source` column on every row; carry Apify `runId` + `datasetId` in `run_metadata.json`.
- **No fabrication:** missing dataset fields stay blank.
- **Deliverable header transparency:** state the active result scope and the spurious-match drop count; offer to re-render under a different scope.
- **Ambiguity confirm:** if anchor #1 is unclear, ask before running.

## Cost & Pricing

Email verification is charged only for **decisive** results (`ok` / `invalid` / `disposable`); `catch_all` / `unknown` / `error` are free. Leads enrichment is charged per successfully extracted lead. Check the Apify console for live rates (they vary by subscription tier and change over time).

## Error Handling

See [reference/troubleshooting.md](reference/troubleshooting.md).

© Daniela Ryplová · Apache-2.0 · apify/awesome-skills

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
apify-actor-development apify Скилл apify-actor-development для создания, отладки и деплоя Apify Actors. Помогает агенту писать код актора, схемы ввода-вывода и публиковать проект на платформе Apify. CX Codex +1 11 000установок Apify apify MCP-сервер, который подключает к агенту каталог скрейперов Apify Store и документацию платформы. Агент ищет готовые акторы, запускает их и забирает результат. CX Codex +1 218установок apify-integration-development apify Скилл apify-integration-development для Claude Code, Codex, Cursor и других агентов: помогает спроектировать и собрать официальную интеграцию с Apify — от плагина для AI-агента до клиента на apify-client. CX Codex +1 638установок apify-scraper MSApps-Mobile Плагин apify-scraper интегрирует платформу Apify с Claude Code для запуска акторов, управления датасетами, хранилищами ключей и расписаниями задач. ★ 11звёзд репо Emaillistchecker.io Email Verification Emaillistchecker-io MCP-сервер Emaillistchecker.io Email Verification для Claude Code: проверяет адрес до отправки письма — MX, SMTP, catch-all, одноразовые домены. Чистит список рассылки или форму регистрации. CX Codex +1 Email Finder — Professional Email from Name + Domain axel-belfort Email Finder — Professional Email from Name + Domain — MCP-сервер для Claude Code находит рабочий адрес по имени человека и домену компании. Ищет контакты перед письмом. CX Codex +1 4 476установок

Из того же набора8

apify-ecommerce Скилл apify-ecommerce для Claude Code превращает вопрос про цены, отзывы или конкурентов в запуск нужного Apify Actor и готовый ответ. Собирает данные магазинов без ручного парсинга. CX Codex +1 536установок apify-easy-competitive-intelligence Скилл apify-easy-competitive-intelligence для Claude Code собирает живые данные о конкурентах через Apify-акторы: отзывы, цены, вакансии, SERP. Закрывает разбор рынка свежими данными из веба, не из памяти модели. CX Codex +1 343установок apify-ads-intelligence Скилл apify-ads-intelligence исследует рекламу конкурентов через Apify Actors и сводит данные из публичных библиотек Meta, Google, TikTok, LinkedIn и X. CX Codex +1 270установок apify-link-prospecting-outreach Скилл apify-link-prospecting-outreach собирает сайты для линкбилдинга, оценивает их через Ahrefs и готовит персональные письма с предложением ссылки. CX Codex +1 227установок apify-ai-search-visibility-tracker Скилл apify-ai-search-visibility-tracker для Claude Code отслеживает упоминания бренда и конкурентов в ответах ИИ-поиска. Он также ищет запросы для мониторинга, возможности для цитирования и пробелы на сайте. CX Codex +1 204установок apify-influencer-brand-collabs Скилл apify-influencer-brand-collabs помогает найти партнёрства между брендами и инфлюэнсерами через Meta Ad Library. Используй, когда нужно узнать, с какими брендами работает создатель, или какие инфлюэнсеры продвигают бренд. CX Codex +1 194установок apify-booking-host-leads Скилл apify-booking-host-leads для Claude Code собирает контакты хозяев и управляющих жильём с Booking.com. Запускается по запросу найти почты или собрать список объектов размещения. CX Codex +1 103установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой