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

building-twitter-prospect-lists — скилл для Claude Code: поиск лидов

Скилл building-twitter-prospect-lists собирает списки потенциальных клиентов из профилей Twitter по ключевым словам в bio и темам твитов через скрейперы Apify.

Apache-2.0 903 установок ★ 1 обновлён 2026-05-13

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add apidojo-io/apidojo-skills --skill building-twitter-prospect-lists -a claude-code
Открыть на GitHub

Что делает building-twitter-prospect-lists

Скилл ищет пользователей Twitter, подходящих под целевой профиль клиента: находит людей с нужной должностью в bio, фильтрует по числу подписчиков и местоположению, собирает недавние твиты как сигнал вовлечённости. Работает в два этапа: сначала apidojo/tweet-scraper находит твиты по темам, затем apidojo/twitter-user-scraper вытягивает полные профили авторов. На выходе — таблица с именем, username, bio, числом подписчиков, локацией и примерами твитов.

Требует токен Apify в переменной окружения APIFY_TOKEN. Скилл может работать через MCP-сервер Apify или напрямую через curl и скрипт run_actor.js. Фильтры гибкие: можно задать диапазон подписчиков, язык твитов, верифицированных пользователей, даты публикаций и минимальное число ретвитов.

Подходит для SDR-команд в B2B, growth-хакеров, основателей, которые ведут продажи сами, и менеджеров по партнёрствам.

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

  • найти основателей SaaS-стартапов на Twitter для холодного аутрича
  • собрать список Head of Growth, которые пишут про метрики PLG
  • отфильтровать профили по числу подписчиков и локации
  • вытащить недавние твиты как сигнал вовлечённости в тему
  • экспортировать готовый список лидов с bio и контактами

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

  • Найди 50 человек на Twitter с «Head of Growth» в bio, которые писали про RevOps за последний месяц
  • Собери список основателей финтех-стартапов в Лондоне с 1000–10000 подписчиков
  • Вытащи профили людей, которые твитят про SaaS-метрики, с bio и недавними твитами

Как установить building-twitter-prospect-lists

1Через Skills CLI (Vercel)

npx skills add apidojo-io/apidojo-skills --skill building-twitter-prospect-lists -a claude-code

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

~/.claude/skills/building-twitter-prospect-lists/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/building-twitter-prospect-lists/

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

Вопросы о building-twitter-prospect-lists

Как установить building-twitter-prospect-lists в Claude Code?

Выполни npx skills add apidojo-io/apidojo-skills --skill building-twitter-prospect-lists -a claude-code, после чего файл скилла появится в ~/.claude/skills/building-twitter-prospect-lists/SKILL.md.

Что делает скилл building-twitter-prospect-lists?

Собирает списки потенциальных клиентов из Twitter: ищет профили по ключевым словам в bio и темам твитов, фильтрует по числу подписчиков и локации, возвращает таблицу с именем, username, bio и примерами твитов.

Что нужно для работы building-twitter-prospect-lists?

Токен Apify в переменной окружения APIFY_TOKEN. Опционально можно установить MCP-сервер Apify для упрощённого запуска акторов.

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

SKILL.md · Apache-2.0
---
name: building-twitter-prospect-lists
description: >
  Builds targeted B2B prospect lists from Twitter/X profiles and posts using apidojo's Twitter scrapers on Apify.
  Triggers when the user asks to: find Twitter users with a specific job title or keyword in bio,
  build a list of founders or executives on Twitter, find people tweeting about a topic for outreach,
  identify potential customers on X, scrape Twitter profiles matching an ICP description,
  find decision-makers in a specific industry on Twitter, or export a list of leads from Twitter bios.
  Returns name, username, bio, follower count, location, and recent tweet samples per prospect.
  Ideal for B2B SDRs, growth hackers, founder-led sales teams, and partnership managers.
license: Apache-2.0
metadata:
  author: apidojo
  version: "1.0"
  apify-actors: apidojo/tweet-scraper, apidojo/twitter-user-scraper
---

# Building Twitter Prospect Lists

Searches Twitter/X for profiles matching a target ICP (Ideal Customer Profile) using bio keywords and topic-based tweet search. Delivers a contact-ready list with engagement signals and bio context.

## Prerequisites

- `APIFY_TOKEN` environment variable set
- Optional: Apify MCP server installed


## Inputs

| Parameter | Type | Required | Default | Notes |
|-----------|------|----------|---------|-------|
| `searchTerms` | array | ✅ | `[]` | Twitter advanced search queries (e.g. `["#AI lang:en", "from:NASA"]`) |
| `sort` | string | Optional | `Top` | Sort order: `Latest`, `Top`, or `Latest+Top` |
| `tweetLanguage` | string | Optional | — | ISO 639-1 language code (e.g. `en`) |
| `maxItems` | number | Optional | Unlimited | Maximum tweets to return |
| `onlyVerifiedUsers` | boolean | Optional | `false` | Only tweets from verified users |
| `onlyTwitterBlue` | boolean | Optional | `false` | Only Twitter Blue subscribers |
| `onlyImage` | boolean | Optional | `false` | Only tweets with images |
| `onlyVideo` | boolean | Optional | `false` | Only tweets with videos |
| `onlyQuote` | boolean | Optional | `false` | Only quote tweets |
| `author` | string | Optional | — | Filter to a specific author handle |
| `inReplyTo` | string | Optional | — | Tweets replying to a specific handle |
| `mentioning` | string | Optional | — | Tweets mentioning a specific handle |
| `geotaggedNear` | string | Optional | — | Tweets near a location |
| `withinRadius` | string | Optional | — | Radius around geotaggedNear |
| `geocode` | string | Optional | — | Lat/lng + radius string |
| `placeObjectId` | string | Optional | — | Tweets tagged with a place |
| `minimumRetweets` | number | Optional | — | Minimum retweet count |
| `minimumFavorites` | number | Optional | — | Minimum like count |
| `minimumReplies` | number | Optional | — | Minimum reply count |
| `start` | string | Optional | — | Tweets after this date (YYYY-MM-DD) |
| `end` | string | Optional | — | Tweets before this date (YYYY-MM-DD) |
| `includeSearchTerms` | boolean | Optional | `false` | Add the matched search term to each tweet |
| `customMapFunction` | string | Optional | — | JavaScript function to transform each output object |
## Workflow

```
Progress:
- [ ] Step 1: Define ICP and search strategy
- [ ] Step 2: Run tweet-scraper for keyword/topic tweets
- [ ] Step 3: Extract unique authors from results
- [ ] Step 4: Enrich with twitter-user-scraper for bio + follower data
- [ ] Step 5: Filter, rank, and deliver prospect list
```

### Step 1: Define ICP and Strategy

Ask the user:
- **Job title keywords** for Twitter bio search (e.g., "Head of Growth", "Founder", "CTO")
- **Topic keywords** — what topics does the ICP tweet about? (e.g., "SaaS metrics", "PLG", "RevOps")
- **Industry signals** — keywords that suggest the right industry in bio (e.g., "SaaS", "fintech", "healthcare")
- **Follower range** (optional) — e.g., 1,000–50,000 (avoids both nobodies and celebrities)
- **Location** (optional) — e.g., "San Francisco", "London"
- **List size** — how many prospects needed?

### Step 2: Search for Topic-Based Tweets

Search Twitter for tweets about topics your ICP cares about. People who actively tweet about a topic are warmer prospects.


**Recommended — run_actor.js (handles waiting, output, and file saving automatically):**
```bash
# Quick answer (prints table to chat)
node scripts/run_actor.js \
  --actor "apidojo~tweet-scraper" \
  --input '{"param": "value"}'

# Save as CSV
node scripts/run_actor.js \
  --actor "apidojo~tweet-scraper" \
  --input '{"param": "value"}' \
  --output YYYY-MM-DD_results.csv --format csv

# Save as JSON
node scripts/run_actor.js \
  --actor "apidojo~tweet-scraper" \
  --input '{"param": "value"}' \
  --output YYYY-MM-DD_results.json --format json
```
> `APIFY_TOKEN` must be set in environment or `.env` file.

**If Apify MCP is available:**
```
Tool: apify:run-actor
Actor: "apidojo~tweet-scraper"
Input:
{
  "searchTerms": ["[TOPIC_KEYWORD_1]", "[TOPIC_KEYWORD_2]"],
  "maxItems": 200,
  "tweetLanguage": "en"
}
```

**If Apify MCP is not available:**
```bash
curl -X POST \
  "https://api.apify.com/v2/acts/apidojo~tweet-scraper/runs?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "searchTerms": ["[TOPIC_KEYWORD]"],
    "maxItems": 200
  }'
```

Run for each topic keyword. Collect all `author.username` values. Deduplicate. This gives you a candidate pool.

### Step 3: Enrich Candidates with Profile Data

Take the top 100-200 unique usernames from Step 2. Fetch full profile data to filter by bio keywords and follower count.

**If Apify MCP is available:**
```
Tool: apify:run-actor
Actor: "apidojo~twitter-user-scraper"
Input:
{
  "usernames": ["[username1]", "[username2]", "..."],
  "maxItems": 100
}
```

**If Apify MCP is not available:**
```bash
curl -X POST \
  "https://api.apify.com/v2/acts/apidojo~twitter-user-scraper/runs?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "usernames": ["[username1]", "[username2]"]
  }'
```

### Step 4: Filter Against ICP Criteria

From profile data, keep only users where ALL of these are true:
1. Bio contains at least one job title keyword OR industry signal keyword
2. Follower count is within the specified range (if given)
3. Location matches (if specified) — check `location` field
4. Account is not a bot (has profile picture, has >10 tweets, account age >6 months)

Remove:
- Accounts with default profile images
- Accounts with 0 tweets
- Verified mega-influencers (follower count above range)
- Obviously automated accounts

### Step 5: Rank and Format

Rank filtered prospects by:
1. Relevance score = number of ICP keywords matched in bio
2. Engagement proxy = (likes + retweets on recent tweets) / follower count

## Output Format

```
# Twitter Prospect List: [ICP DESCRIPTION]
Generated: [N] prospects | Filters applied: [summary] | Date: [DATE]

| # | Name | Handle | Followers | Job / Bio | Location | Last Active | Profile |
|---|------|--------|-----------|-----------|----------|-------------|---------|
| 1 | [name] | @[handle] | [N] | [bio excerpt] | [city] | [date] | [url] |
| 2 | [name] | @[handle] | [N] | [bio excerpt] | [city] | [date] | [url] |

## Top 10 Highest-Priority Prospects
1. **@[handle]** — "[bio]" | [N] followers | Recently tweeted about: [topic]
2. **@[handle]** — "[bio]" | [N] followers | Recently tweeted about: [topic]
...

## Notes
- [N] candidates found in topic search
- [N] filtered out (didn't match ICP criteria)
- [N] final prospects delivered
- Engagement signals are 24-48h delayed
```

## Personalizing Outreach

For each top prospect, the recent tweet sample can be used to personalize outreach. Note their recent topics to reference in a first message.

## Troubleshooting

**Too few results after filtering:** Broaden bio keywords (use OR logic, not AND). Try more topic keywords in Step 2.
**Too many irrelevant accounts:** Add industry-specific keywords to bio filter (e.g., require "SaaS" or "B2B" in bio).
**Location filter not working:** Twitter location is self-reported and inconsistent — treat it as a soft signal, not a hard filter.

© apidojo · Apache-2.0 · apidojo-io/apidojo-skills

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

Все скиллы по теме «Маркетинг и контент» →
x-twitter-scraper официальный github Скилл x-twitter-scraper для GitHub Copilot, который подключает Xquik X API к коду, пайплайнам и агентам. Помогает искать твиты, выгружать подписчиков, запускать извлечения и проверять вебхуки. CX Codex +1 80установок x-research bradautomates Скилл x-research ищет вирусные твиты и паттерны контента в X через Apify Tweet Scraper V2, собирая аналитику и темы в markdown-отчёт. CX Codex +1 286установок x-content-intelligence MSApps-Mobile Плагин x-content-intelligence для Claude Code анализирует публикации в X и помогает создавать контент под конкретное сообщество. Он подключается к исследованию трендов, тональности и вовлечённости. ★ 11звёзд репо twitter Starchild-ai-agent Читает посты и профили пользователей Twitter и X через API. Разбирает ссылки на публикации и собирает статистику. CX Codex +1 7 900установок x-scraper apidojo-io Скилл тянет твиты по запросу, профилю, хэштегу, каштагу, ветке обсуждения или списку — через актор X Scraper API на Apify. Полезен, когда нужно собрать реальную выдачу и смотреть метрики. CX Codex +1 20 800установок prospect официальный anthropics Скилл prospect преобразует описание идеального клиента в ранжированный список решающих лиц с контактами. За один вызов проходит путь от ICP к таблице лидов с почтой и телефонами. CX Codex +1 3 000установок

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

Весь набор →
discovering-tiktok-creators-by-niche Скилл discovering-tiktok-creators-by-niche ищет и ранжирует тиктокеров по нишам и хештегам через скраперы Apify. Рассчитывает вовлечённость и собирает базу контактов для инфлюенс-маркетинга. CX Codex +1 905установок finding-gaming-content-creators Скилл finding-gaming-content-creators ищет игровых блогеров в TikTok и YouTube через скраперы Apify. Пригодится при составлении базы авторов для рекламы и спонсорских интеграций. CX Codex +1 904установок scraping-twitter-profile-tweets Скилл scraping-twitter-profile-tweets для Claude Code выгружает через Apify твиты, треды ответов и метрики профилей Twitter/X. Помогает мониторить аккаунты и собирать статистику публикаций. CX Codex +1 904установок discovering-pre-launch-startups-on-twitter Скилл discovering-pre-launch-startups-on-twitter для Claude Code ищет в Twitter стартапы до публичного запуска и сортирует сигналы по стадии. Задача — разведка ранних продуктов и waitlist. CX Codex +1 903установок scraping-youtube-playlist Скилл scraping-youtube-playlist собирает данные обо всех видео в плейлисте YouTube через скрейпер Apify. Пригодится, чтобы выгрузить метаданные и статистику для дальнейшего анализа. CX Codex +1 901установок finding-speaking-opportunities-on-twitter Скилл finding-speaking-opportunities-on-twitter ищет на Twitter конференции, подкасты и саммиты, набирающие спикеров, и возвращает контакты организаторов, сроки подачи и ссылки на регистрацию. CX Codex +1 900установок extracting-tiktok-comments-for-research Скилл extracting-tiktok-comments-for-research для Claude Code собирает комментарии TikTok и помогает анализировать тональность, темы и популярные реакции. Исследует аудиторию и отзывы. CX Codex +1 898установок finding-real-estate-professionals-on-twitter Скилл finding-real-estate-professionals-on-twitter ищет агентов, брокеров и инвесторов в Twitter/X через Apify. Подходит для сбора списка специалистов по ключевым словам в профилях. CX Codex +1 894установок

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

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