X Article Fetcher

X 长文排行榜发现器 / X Article Leaderboard

基于 AttentionVC 排行榜，发现 X 平台上的优质长文内容。

⚠️ 注意：本 skill 专注于排行榜发现，如需抓取帖子原文内容，请使用 x-content-fetcher skill。

🚀 我能帮你做什么？/ What Can I Do?

✨ 功能特点 / Features

• 📊 排行榜发现 - 基于 AttentionVC 的病毒传播排行
• 🌍 多语言支持 - 中文、英文、日文等 29 种语言
• 🏷️ 分类筛选 - AI、Crypto、Tech、Business 等 12 个分类
• ⏰ 时间窗口 - 24h、7d、14d、All Time
• 📈 多维排序 - 按浏览量、点赞、转发排序
• 🔥 热门话题 - 发现当前趋势话题

📋 API 端点 / API Endpoints

AttentionVC 提供的公开 API：

Base URL: https://reply-vc-90459984647.us-central1.run.app

💬 使用示例 / Examples

获取排行榜 / Get Leaderboard

"给我今天的中文 AI 长文排行榜"
"Get today's Chinese AI articles leaderboard"

参数说明：

• window: 1d | 7d | 14d | all
• category: ai | crypto | tech | politics | self_help | business | ...
• lang: zh | en | ja | ...
• sortBy: views | likes | retweets
• limit: 返回数量

获取热门话题 / Get Trending Topics

"今天 X 上什么话题最火？"
"What's trending on X today?"

📁 数据结构 / Data Structure

排行榜条目 / Leaderboard Entry

{
  "rank": 1,
  "tweetId": "2032031621910577329",
  "title": "文章标题",
  "author": {
    "handle": "username",
    "name": "显示名称",
    "followers": 9819,
    "isBlueVerified": true
  },
  "viewCount": 2959522,
  "likeCount": 9187,
  "retweetCount": 4987,
  "category": "tech",
  "tags": ["security", "automation"],
  "langsDetected": ["ja"],
  "wordCount": 225,
  "readingTimeMinutes": 1
}

🛠️ CLI 命令参考 / CLI Reference

# 获取排行榜
xarticle.py leaderboard --window 1d --category ai --lang zh --limit 10

# 获取分类列表
xarticle.py categories

# 获取语言列表
xarticle.py languages

# 获取地区列表
xarticle.py locations

# 获取热门话题
xarticle.py trending --window 1d

📦 支持的分类 / Supported Categories

📦 支持的语言 / Supported Languages

ar ca de el en es fa fi fr he hi id it ja ko mr nl pl pt ru sl sv ta te th tr uk ur zh

🔧 工作流程 / Workflow

1. 用户请求 → 解析筛选条件（时间/分类/语言/排序）
      ↓
2. 调用 AttentionVC API → 获取排行榜数据
      ↓
3. 格式化输出 → Markdown / JSON / 表格
      ↓
4. 返回文章列表（含 tweetId、标题、作者、互动数据等）
      ↓
5. 用户可选择感兴趣的 tweetId，使用 x-content-fetcher 抓取原文

🤖 Claude 执行指南 / Claude Execution Guide

步骤 1: 获取排行榜

使用 Python 脚本或直接调用 API：

# 使用脚本
python3 ~/.claude/skills/x-article-fetcher/xarticle.py leaderboard --lang zh --category ai --limit 10

# 或直接调用 API
curl "https://reply-vc-90459984647.us-central1.run.app/v1/articles/leaderboard?window=1d&category=ai&lang=zh&sortBy=views&limit=10"

步骤 2: 展示结果

将返回的文章列表整理为易读格式展示给用户，包含：

• 排名、标题、作者
• 浏览量、点赞、转发等互动数据
• 原文链接：https://x.com/i/status/{tweetId}

步骤 3: 获取原文（可选）

如用户需要抓取原文内容，调用 x-content-fetcher skill。

⚠️ 注意事项 / Notes

• 本 skill 仅提供排行榜发现功能
• 内容抓取请使用 x-content-fetcher skill
• 建议合理使用 API，避免频繁请求

📝 开始使用吧！告诉我你想查看什么类型的 X 长文排行榜！