选项： -n, --limit N 获取推文数量（默认10） -p, --pages N 获取页数（默认1，每页约20条） -o, --output PATH 输出文件路径（默认 outputs/{用户名}.md） --json 同时输出 JSON 格式 --interval SECONDS 请求间隔秒数（默认5，防止频率限制） --no-user-info 不获取用户信息 --title TITLE 自定义 Markdown 标题 --fields FIELDS 包含的字段，逗号分隔 --auth-token TOKEN 指定 auth_token


### 频率限制

Twitter API 有频率限制，脚本内置了以下保护机制：
- 默认每次请求间隔 5 秒
- 自动添加随机抖动（0.5-2秒）避免被检测
- 可通过 `--interval` 调整间隔时间
- 获取超过 20 条推文时自动分页

### 字段选项

`--fields` 可选值（逗号分隔）：
- `text` - 推文内容
- `time` - 发布时间
- `likes` - 点赞数
- `retweets` - 转发数
- `replies` - 回复数
- `views` - 浏览量
- `url` - 推文链接
- `media` - 媒体（图片）

## 示例

### 示例1：基础爬取

```bash
python3 scripts/fetch_tweets.py VoxcatAI

输出：outputs/VoxcatAI.md

示例2：指定数量和输出路径

python3 scripts/fetch_tweets.py elonmusk -n 20 -o ~/Desktop/elon.md

示例3：只要内容和链接

python3 scripts/fetch_tweets.py sama --fields text,url

示例4：同时输出 JSON

python3 scripts/fetch_tweets.py OpenAI -n 15 --json

输出：

outputs/OpenAI.md
outputs/OpenAI.json

示例5：自定义标题

python3 scripts/fetch_tweets.py VoxcatAI --title "VoxCat 的 Prompt 分享"

输出格式

Markdown 格式

# @用户名 的推文

> 爬取时间: 2026-01-11 12:00:00
> 推文数量: 10

## 用户信息

- **名称**: xxx
- **用户名**: @xxx
- **粉丝**: 1,000
- **简介**: xxx

## 推文列表

### 1. 推文

**时间**: 2026-01-11 10:00:00

> 推文内容...

**互动**: ❤️ 100 | 🔁 20 | 💬 5

**链接**: [https://twitter.com/xxx/status/xxx](...)

---

JSON 格式

{
  "user": {
    "name": "xxx",
    "username": "xxx",
    "followers": 1000,
    ...
  },
  "tweets": [
    {
      "id": "xxx",
      "text": "xxx",
      "created_at": "2026-01-11 10:00:00",
      "likes": 100,
      "retweets": 20,
      ...
    }
  ],
  "fetched_at": "2026-01-11T12:00:00"
}

配置

auth_token

脚本会自动从 ~/Documents/trend-crawler-master/trend-crawler/config.yaml 读取 auth_token。

如果需要单独配置，创建 ~/.claude/skills/twitter-crawler/config.yaml：

twitter_accounts:
  auth_token: "你的auth_token"

获取 auth_token

登录 Twitter 网页版
打开开发者工具 (F12) → Application → Cookies
找到 auth_token 的值

依赖

tweety-ns（从 trend-crawler 项目的 venv 加载）
pyyaml

注意事项

频率限制：Twitter 有 API 频率限制，建议间隔使用
auth_token 过期：如果遇到错误，可能需要更新 auth_token
访客模式：不配置 auth_token 也能使用，但可能受限

twitter-crawler

Twitter 推文爬取器

概述

使用方法

基础用法

完整参数