X Tweet Fetcher

无需身份验证即可从 X/Twitter 抓取推文。使用 FxTwitter API。

支持抓取的内容类型

使用方法

命令行（CLI）

# JSON 格式输出
python3 scripts/fetch_tweet.py --url "https://x.com/user/status/123456"

# 美化后的 JSON 输出
python3 scripts/fetch_tweet.py --url "https://x.com/user/status/123456" --pretty

# 纯文本输出（人类可读格式）
python3 scripts/fetch_tweet.py --url "https://x.com/user/status/123456" --text-only

在 Agent 代码中调用

from scripts.fetch_tweet import fetch_tweet

result = fetch_tweet("https://x.com/user/status/123456")
tweet = result["tweet"]

# 普通推文
print(tweet["text"])

# X Article（长文）
if tweet["is_article"]:
    print(tweet["article"]["title"])
    print(tweet["article"]["full_text"])  # 完整文章正文
    print(tweet["article"]["word_count"])

输出格式

{
  "url": "https://x.com/user/status/123",
  "username": "user",
  "tweet_id": "123",
  "tweet": {
    "text": "推文内容...",
    "author": "显示名称",
    "screen_name": "username",
    "likes": 100,
    "retweets": 50,
    "bookmarks": 25,
    "views": 10000,
    "replies_count": 30,
    "created_at": "Mon Jan 01 12:00:00 +0000 2026",
    "is_note_tweet": false,
    "is_article": true,
    "article": {
      "title": "文章标题",
      "full_text": "完整文章内容...",
      "word_count": 4847,
      "char_count": 27705
    }
  }
}

运行要求

• Python 3.7+
• 不依赖任何外部包（仅使用标准库）
• 无需 API 密钥
• 无需登录

工作原理

使用 FxTwitter 公共 API（api.fxtwitter.com），该服务作为 X/Twitter 内容的代理。X Articles 以结构化区块形式返回，并被重新组合为完整文本。

限制条件

• 无法抓取回复线程（仅可通过 replies_count 字段获取回复数量）
  • 获取实际回复内容需依赖浏览器自动化工具（如 Camofox/Nitter）
  • 为保持零依赖架构，已移除此类依赖
  • --replies 参数仍存在，但会返回说明性错误信息
• 无法抓取已被删除或设为私密的推文
• 速率限制取决于 FxTwitter 服务的可用性
• 若 FxTwitter 服务不可用，则本功能将失效（无备用方案）

文件结构

skills/x-tweet-fetcher/
├── SKILL.md              （本文档）
└── scripts/
    └── fetch_tweet.py    （单文件实现，零依赖）