# Send TwitterScore to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "twitterscore",
    "name": "TwitterScore",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/NikolayBohdanov/twitterscore",
    "canonicalUrl": "https://clawhub.ai/NikolayBohdanov/twitterscore",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/twitterscore",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=twitterscore",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "twitterscore",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-10T07:54:10.982Z",
      "expiresAt": "2026-05-17T07:54:10.982Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=twitterscore",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=twitterscore",
        "contentDisposition": "attachment; filename=\"twitterscore-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "twitterscore"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/twitterscore"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/twitterscore",
    "downloadUrl": "https://openagent3.xyz/downloads/twitterscore",
    "agentUrl": "https://openagent3.xyz/skills/twitterscore/agent",
    "manifestUrl": "https://openagent3.xyz/skills/twitterscore/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/twitterscore/agent.md"
  }
}
```
## Documentation

### 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

### 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

### Global Flags

FlagDescription--api-key KEYOverride API key--jsonOutput as JSON--csvOutput as CSV--quietMinimal output

### Common Parameters

ParameterDescriptionDefault--page NPage number1--size NItems per page (max 50)10--category IDFilter by category ID---tag IDFilter by tag ID---tag-category IDFilter by tag category-

### Environment Variables

VariableDescriptionTWITTERSCORE_API_KEYYour TwitterScore API keyTWITTERSCORE_BASE_URLAPI base URL (optional)

### 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.

### "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.

### 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
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: NikolayBohdanov
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-10T07:54:10.982Z
- Expires at: 2026-05-17T07:54:10.982Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/twitterscore)
- [Send to Agent page](https://openagent3.xyz/skills/twitterscore/agent)
- [JSON manifest](https://openagent3.xyz/skills/twitterscore/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/twitterscore/agent.md)
- [Download page](https://openagent3.xyz/downloads/twitterscore)