TwitterScore

Research, analyze, and track Twitter influence with TwitterScore.io API. Get scores, analyze followers, track growth, and compare accounts.

Security Scan

The SKILL.md describes a straightforward TwitterScore CLI that legitimately needs a TwitterScore API key, but the registry metadata does not declare those required credentials and the skill has no provenance — this metadata/manifest mismatch and lack of source info are concerning.

Purpose & Capability

The name/description and SKILL.md are coherent: the skill is a CLI wrapper around the TwitterScore.io API and legitimately needs a TWITTERSCORE_API_KEY (and optionally TWITTERSCORE_BASE_URL). However, the registry metadata claims no required environment variables or primary credential, which is inconsistent with the runtime instructions and suggests an incomplete or incorrect manifest.

Instruction Scope

The instructions are narrowly scoped to calling the TwitterScore API via a CLI (score, info, followers, bulk, etc.), reading optional local files for bulk input, and exporting CSVs. They do not instruct arbitrary system-wide reads or exfiltration to third-party endpoints beyond TwitterScore. One operational note: the SKILL.md tells users how to persist the API key using 'openclaw config set', which stores a secret in agent configuration.

Install Mechanism

There is no install spec and no code files — this is instruction-only, so nothing is written to disk by an installer. This is the lower-risk scenario for installation mechanics.

Credentials

The SKILL.md requires a single API key (TWITTERSCORE_API_KEY) and optionally a TWITTERSCORE_BASE_URL — both are proportionate to the stated purpose. The manifest/registry, however, lists no required env vars or primary credential, a mismatch that reduces transparency and makes it harder to reason about required secrets. Also note: storing the key via 'openclaw config set' will persist the secret in agent config.

Persistence & Privilege

The skill does not request always:true and has no special OS or config path requirements. The only persistence-related behavior mentioned is guidance to store the API key in OpenClaw's config (user choice), which could keep the secret around between sessions but is not itself a platform privilege escalation.

What to consider before installing

What to consider before installing: - The SKILL.md clearly requires a TwitterScore API key (TWITTERSCORE_API_KEY) but the registry metadata does not declare any required credentials — ask the publisher to fix the manifest so required secrets are visible before you install. - The skill comes from an unknown source with no homepage. Verify you trust twitterscore.io (review their docs, pricing page, privacy/security policy) before supplying an API key. - Be cautious about using 'openclaw config set' to store your API key: it will persist the secret in agent configuration. Prefer exporting the key into a process-only env var if you want it ephemeral. - The instructions themselves are narrowly scoped to TwitterScore API usage and do not request unrelated system access, so the primary risk is secret handling and provenance rather than unexpected behavior. - If you plan to use this in a sensitive environment, ask the publisher for: an official source URL, a homepage or repo, and corrected registry metadata that declares TWITTERSCORE_API_KEY as a required credential.

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: [phone] → 2024-10-03)
Month: [phone] → 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