TwitterScore 技能

使用 twitterscore 命令研究 Twitter 账号、分析影响力分数、追踪粉丝增长，并通过 TwitterScore.io API 对账号进行横向对比。

配置

需提供 TwitterScore API 密钥。请访问 twitterscore.io/api/prices 获取密钥。

# 设置 API 密钥
export TWITTERSCORE_API_KEY="your_api_key"

# 或通过 OpenClaw 配置
openclaw config set twitterscore.api_key your_api_key

命令

score

获取指定账号的 TwitterScore 分数。

# 按用户名查询（默认方式）
twitterscore score elonmusk

# 按 Twitter ID 查询
twitterscore score --id 44196397

# 以 JSON 格式输出
twitterscore score elonmusk --json

输出示例：

@elonmusk (Elon Musk)
Twitter ID: 44196397
Twitter Score: 1000.0/1000

info

获取账号的详细信息。

twitterscore info elonmusk

输出示例：

@elonmusk
Name: Elon Musk
Description: ...
Followers: 199,987,720
Profile: [image URL]

bulk

一次性批量查询最多 50 个账号。

twitterscore bulk coinbase binance paradigm a16zcrypto

# 从文件读取账号列表
twitterscore bulk --file accounts.txt

followers

获取并分析账号的粉丝数据。

# 按分数排序，获取 Top 10 粉丝
twitterscore followers elonmusk --top 10

# 分页列出粉丝
twitterscore followers elonmusk --page 1 --size 25

# 按分类筛选（1 = 风险投资机构）
twitterscore followers elonmusk --category 1

# 按标签筛选（22 = Ethereum）
twitterscore followers elonmusk --tag 22

# 按标签分类筛选（3 = 生态系统）
twitterscore followers elonmusk --tag-category 3

diff

追踪账号分数变化趋势。

twitterscore diff elonmusk

输出示例：

Score Changes for @elonmusk:
Week: +8 (2024-09-26 → 2024-10-03)
Month: +9 (2024-09-03 → 2024-10-03)

history

获取粉丝数量历史记录。

# 最近 30 天（默认）
twitterscore history elonmusk

# 自定义时间范围
twitterscore history elonmusk --period 7d    # 7 天
twitterscore history elonmusk --period 180d  # 6 个月
twitterscore history elonmusk --period 1y    # 1 年
twitterscore history elonmusk --period all   # 全部历史

# 导出为 CSV 文件
twitterscore history elonmusk --export growth.csv

categories

列出所有粉丝分类。

twitterscore categories

输出示例：

ID  Name
1   Venture Capitals
2   Founders
3   Projects
4   Exchanges
5   Auditors
7   Media
8   Influencers
9   Angels
10  Trading

tags

列出所有可用标签。

# 所有标签
twitterscore tags

# 分页显示
twitterscore tags --page 1 --size 25

analyze

按分类和标签对粉丝构成进行分析。

# 按分类统计粉丝分布
twitterscore analyze elonmusk --by-category

# 按标签统计粉丝分布
twitterscore analyze elonmusk --by-tag

limits

查看当前 API 使用量与配额限制。

twitterscore limits

输出示例：

Plan: Pro
Monthly: 10,700 / 200,000 (189,300 remaining)
Resets: 2025-05-12
Per minute: 60 requests

选项

全局标志（Global Flags）

通用参数（Common Parameters）

环境变量

使用提示

速率限制

• 最高 60 次请求/分钟
• 批量检查多个账号时，请优先使用 bulk 命令
• 对高频查询的账号建议缓存结果

高效查询

# ❌ 低效：逐个发起请求
for user in coinbase binance paradigm; do
  twitterscore score $user
done

# ✅ 高效：单次批量请求
twitterscore bulk coinbase binance paradigm

数据导出

# 将粉丝分析结果导出为 CSV
twitterscore followers elonmusk --top 100 --csv > top_followers.csv

# 导出粉丝增长历史
twitterscore history elonmusk --period 1y --export yearly_growth.csv

API 参考文档

基础 URL：https://twitterscore.io/api/v1

完整 API 接口详情请参阅 TwitterScore 官方 API 文档。

故障排查

“API key not configured”（未配置 API 密钥）

请设置您的 API 密钥：

export TWITTERSCORE_API_KEY="your_key"

“Rate limit exceeded”（超出速率限制）

请等待一分钟后再试，或运行以下命令查看当前套餐配额：

twitterscore limits

“Account not found”（账号未找到）

该账号可能已被删除、设为私密或遭平台封禁。建议改用 Twitter ID 替代用户名进行查询。

使用示例

竞品调研

# 获取头部风投机构的 TwitterScore 分数
twitterscore bulk a16zcrypto paradigm coinbasecms dragonfly_xyz

# 分析其粉丝构成
for vc in a16zcrypto paradigm; do
  echo "=== $VC ==="
  twitterscore analyze $vc --by-category
done

增长追踪

# 保存当前状态
twitterscore history myaccount --period all --export before_campaign.csv

# ... 执行营销活动 ...

# 对比活动后数据
twitterscore history myaccount --period 30d --export after_campaign.csv

寻找关键影响者

# 获取主流账号的 Top 100 粉丝（限定分类为 Influencers）
twitterscore followers elonmusk --top 100 --category 8 > influencers.txt