modbender TwitterScore Skill
Use twitterscore to research Twitter accounts, analyze influence scores, track follower growth, and compare accounts using the TwitterScore.io API.
Setup
Requires a TwitterScore API key. Get one at twitterscore.io/api/prices.
# Set API key
export TWITTERSCORE_API_KEY="your_api_key"
# Or configure via OpenClaw
openclaw config set twitterscore.api_key your_api_key
Commands
score
Get TwitterScore for an account.
# By username (default)
twitterscore score elonmusk
# By Twitter ID
twitterscore score --id 44196397
# Output as JSON
twitterscore score elonmusk --json
Output:
@elonmusk (Elon Musk)
Twitter ID: 44196397
Twitter Score: 1000.0/1000
info
Get detailed account information.
twitterscore info elonmusk
Output:
@elonmusk
Name: Elon Musk
Description: ...
Followers: 199,987,720
Profile: [image URL]
bulk
Check up to 50 accounts at once.
twitterscore bulk coinbase binance paradigm a16zcrypto
# From file
twitterscore bulk --file accounts.txt
followers
Get and analyze followers.
# Top followers by score
twitterscore followers elonmusk --top 10
# Paginated list
twitterscore followers elonmusk --page 1 --size 25
# Filter by category (1=Venture Capitals)
twitterscore followers elonmusk --category 1
# Filter by tag (22=Ethereum)
twitterscore followers elonmusk --tag 22
# Filter by tag category (3=Ecosystems)
twitterscore followers elonmusk --tag-category 3
diff
Track score changes.
twitterscore diff elonmusk
Output:
Score Changes for @elonmusk:
Week: +8 (2024-09-26 → 2024-10-03)
Month: +9 (2024-09-03 → 2024-10-03)
history
Get follower count history.
# Last 30 days (default)
twitterscore history elonmusk
# Custom periods
twitterscore history elonmusk --period 7d # 7 days
twitterscore history elonmusk --period 180d # 6 months
twitterscore history elonmusk --period 1y # 1 year
twitterscore history elonmusk --period all # All time
# Export to CSV
twitterscore history elonmusk --export growth.csv
categories
List all follower categories.
twitterscore categories
Output:
ID Name
1 Venture Capitals
2 Founders
3 Projects
4 Exchanges
5 Auditors
7 Media
8 Influencers
9 Angels
10 Trading
tags
List all available tags.
# All tags
twitterscore tags
# Paginated
twitterscore tags --page 1 --size 25
analyze
Analyze followers by categories and tags.
# Followers by category
twitterscore analyze elonmusk --by-category
# Followers by tag
twitterscore analyze elonmusk --by-tag
limits
Check your API usage and limits.
twitterscore limits
Output:
Plan: Pro
Monthly: 10,700 / 200,000 (189,300 remaining)
Resets: 2025-05-12
Per minute: 60 requests
Options
Global Flags
| Flag | Description |
|---|---|
--api-key KEY |
Override API key |
--json |
Output as JSON |
--csv |
Output as CSV |
--quiet |
Minimal output |
Common Parameters
| Parameter | Description | Default |
|---|---|---|
--page N |
Page number | 1 |
--size N |
Items per page (max 50) | 10 |
--category ID |
Filter by category ID | - |
--tag ID |
Filter by tag ID | - |
--tag-category ID |
Filter by tag category | - |
Environment Variables
| Variable | Description |
|---|---|
TWITTERSCORE_API_KEY |
Your TwitterScore API key |
TWITTERSCORE_BASE_URL |
API base URL (optional) |
Tips
Rate Limiting
- Max 60 requests/minute
- Use bulk operations when checking multiple accounts
- Cache results for frequently checked accounts
Efficient Queries
# ❌ Slow: Individual requests
for user in coinbase binance paradigm; do
twitterscore score $user
done
# ✅ Fast: Bulk request
twitterscore bulk coinbase binance paradigm
Exporting Data
# Export follower analysis to CSV
twitterscore followers elonmusk --top 100 --csv > top_followers.csv
# Export growth history
twitterscore history elonmusk --period 1y --export yearly_growth.csv
API Reference
Base URL: https://twitterscore.io/api/v1
See TwitterScore API Documentation for full API details.
Troubleshooting
"API key not configured"
Set your API key:
export TWITTERSCORE_API_KEY="your_key"
"Rate limit exceeded"
Wait a minute or check your plan limits:
twitterscore limits
"Account not found"
The account may be deleted, private, or suspended. Try using Twitter ID instead of username.
Examples
Research Competitors
# Get scores for top VCs
twitterscore bulk a16zcrypto paradigm coinbasecms dragonfly_xyz
# Analyze their followers
for vc in a16zcrypto paradigm; do
echo "=== $VC ==="
twitterscore analyze $vc --by-category
done
Track Growth
# Save current state
twitterscore history myaccount --period all --export before_campaign.csv
# ... run marketing campaign ...
# Compare after
twitterscore history myaccount --period 30d --export after_campaign.csv
Find Influencers
# Get top followers of major accounts
twitterscore followers elonmusk --top 100 --category 8 > influencers.txt