# X Article Fetcher

> X 长文排行榜发现器。基于 AttentionVC 排行榜发现优质 X 长文，支持多维度筛选。 Discover viral X/Twitter long-form articles from AttentionVC leaderboard. 触发方式 Triggers: "X长文排行榜", "X热门长文", "X长文榜单", "x article leaderboard", "x trending articles", "x article ranking", "/xarticle"

- Skill: `qcqallen/x-article-fetcher` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add qcqallen/x-article-fetcher`
- Raw SKILL.md: https://api.skillmd.com/api/skills/qcqallen/x-article-fetcher/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: qcqAllen (https://skillmd.com/u/qcqallen)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/qcqallen/x-article-fetcher

---


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

基于 [AttentionVC](https://www.attentionvc.ai) 排行榜，发现 X 平台上的优质长文内容。

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

---

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

| 你说... / You say... | 我会... / I will... |
|---------------------|---------------------|
| "今天的 X 长文排行榜" | 获取今日热门长文列表 |
| "AI 分类的中文长文" | 筛选 AI 分类下的中文文章 |
| "给我 10 篇关于 Crypto 的热门长文" | 获取 Crypto 分类的前 10 篇文章 |
| "最近一周的科技长文" | 获取 7 天内的 tech 分类文章 |

---

## ✨ 功能特点 / Features

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

---

## 📋 API 端点 / API Endpoints

AttentionVC 提供的公开 API：

| 端点 | 功能 |
|------|------|
| `/v1/articles/leaderboard` | 获取排行榜 |
| `/v1/articles/categories` | 获取分类列表 |
| `/v1/articles/languages` | 获取语言列表 |
| `/v1/articles/locations` | 获取地区列表 |
| `/v1/articles/trending-topics` | 获取热门话题 |

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

```json
{
  "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

```bash
# 获取排行榜
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

| 分类 | 说明 |
|------|------|
| `ai` | 人工智能 |
| `crypto` | 加密货币 |
| `tech` | 科技 |
| `politics` | 政治 |
| `self_help` | 自我提升 |
| `business` | 商业 |
| `entertainment` | 娱乐 |
| `lifestyle` | 生活方式 |
| `health` | 健康 |
| `news` | 新闻 |
| `other` | 其他 |
| `wtf` | 热门话题 |

---

## 📦 支持的语言 / 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：

```bash
# 使用脚本
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 长文排行榜！**