mcpField
T
tracking-twitter-thought-leaders

tracking-twitter-thought-leaders

github.com/apidojo-ioMarketing & growth1817 installsUpdated 24w ago
Repository

About tracking-twitter-thought-leaders

A skill for finding and ranking influential Twitter/X accounts by topic engagement, not follower count alone. It supports PR outreach, community engagement, and partnership research.

Key features

  1. 01Find active accounts by topic
  2. 02Enrich account profiles
  3. 03Score engagement and audience signals
  4. 04Produce ranked thought-leader lists

Use cases

  1. 01Select accounts for PR outreach
  2. 02Find active voices in a topic community
  3. 03Identify potential partners

MCP support

Optionally uses the Apify MCP server to run tweet-search and profile-scraping Actors; scripts and the REST API are also described.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/apidojo-io/apidojo-skills --skill tracking-twitter-thought-leaders

After installing, type/tracking-twitter-thought-leadersin Claude Code to confirm it loaded.

Details

From the project README

Tracking Twitter Thought Leaders

Finds Twitter/X accounts with genuine influence in a topic area — not just high follower counts, but accounts whose tweets get shared and discussed. Delivers a ranked list for PR outreach, community engagement, or partnership targeting.

Prerequisites

  • APIFY_TOKEN environment variable set
  • Optional: Apify MCP server installed

Inputs

ParameterTypeRequiredDefaultNotes
startUrlsarrayOptional[]Twitter profile or tweet URLs
twitterHandlesarrayOptional[]Twitter usernames (without @)
twitterUserIdsarrayOptional[]Twitter user IDs
getFollowersbooleanOptionalfalseExtract follower lists
getFollowingbooleanOptionalfalseExtract following lists
getRetweetersbooleanOptionalfalseExtract retweeters of a tweet URL
includeUnavailableUsersbooleanOptionalfalseInclude unavailable/suspended users
maxItemsnumberOptionalUnlimitedMaximum users to return
customMapFunctionstringOptional—JavaScript function to transform each output object

Workflow

Progress:
- [ ] Step 1: Define topic, industry, and influence criteria
- [ ] Step 2: Search for topic-relevant tweets to find active voices
- [ ] Step 3: Enrich top accounts with profile data
- [ ] Step 4: Score by influence signals
- [ ] Step 5: Deliver ranked thought leader list
Step 1: Clarify Parameters

Ask the user for:

  • Topic or industry (e.g., "AI safety", "B2B SaaS growth", "climate tech")
  • Influence type — broad reach (high followers), community depth (high engagement), or rising voices (growing fast)
  • Follower range (default: 5,000–2,000,000 — excludes unknown accounts and mega-celebrities)
  • Geography/language (optional)
  • List size (default: 25)
Step 2: Search for Topic Tweets

Find who's actively tweeting about the topic — recent activity matters more than old follower counts.

Recommended — run_actor.js (handles waiting, output, and file saving automatically):

# Quick answer (prints table to chat)
node scripts/run_actor.js \
  --actor "apidojo~twitter-user-scraper" \
  --input '{"param": "value"}'

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

# Save as JSON
node scripts/run_actor.js \
  --actor "apidojo~twitter-user-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]", "[TOPIC_KEYWORD_3]"],
  "maxItems": 300,
  "tweetLanguage": "en"
}

REST API fallback:

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_1]", "[TOPIC_KEYWORD_2]"],
    "maxItems": 300
  }'

Extract unique author.username values from all results. Sort by their tweet's retweet+like count — accounts whose topic tweets get the most engagement are the most influential voices.

Step 3: Enrich with Profile Data

Take top 100 candidate usernames. Fetch full profiles.

If Apify MCP is available:

Tool: apify:run-actor
Actor: "apidojo~twitter-user-scraper"
Input:
{
  "usernames": ["[username1]", "[username2]", "...up to 100"]
}

REST API fallback:

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: Score by Influence

Calculate composite influence score for each account:

topic_engagement = avg(likes + retweets) on topic-related tweets
audience_quality = followers / following ratio (>1 is healthy)
influence_score = topic_engagement * log(followers) * audience_quality

Filter: keep only accounts within follower range AND whose bio suggests topical relevance.

Step 5: Format Output

Output Format

# Twitter Thought Leaders: [TOPIC/INDUSTRY]
Accounts analyzed: [N] | Final list: [N] | Date: [DATE]

## Top Thought Leaders

| # | Name | @Handle | Followers | Influence Score | Bio Excerpt | Recent Top Tweet |
|---|------|---------|-----------|-----------------|-------------|------------------|
| 1 | [name] | @[handle] | [N] | [score] | [bio] | "[tweet excerpt]" |

## Tier Breakdown

### 🏆 Power Voices (500K+ followers)
[list with brief bio and latest relevant tweet]

### 🎯 Core Influencers (50K–500K followers)
[list — best for outreach: big enough to matter, accessible enough to respond]

### 🌱 Rising Voices (5K–50K followers)
[list — early partnership opportunity, lower cost, high engagement]

## Best Accounts for Direct Outreach
[Top 5 picks with rationale — why they're ideal for PR, partnership, or co-content]

## Content Themes These Voices Tweet About
- [Theme 1]: [N] of the accounts tweet regularly about this
- [Theme 2]: [N] accounts

Troubleshooting

Results dominated by one person: Some topics have one mega-voice. Exclude them and surface the next tier. Not enough topically relevant accounts: Expand keyword list with synonyms, adjacent topic terms, and industry jargon. Follower counts seem off: Cached data — for final list, spot-check top 5 accounts directly on Twitter.

Comments

Markdown supported