ythx-101/x-tweet-fetcher

解决的问题

该项目提供了一种无需官方 API 密钥或用户登录即可从 X（Twitter）获取数据的方法。它解决了 X 的限制性 API 和标准网页爬取的脆弱性问题，使 AI 代理和开发者能够更轻松地获取推文、时间线和文章。

工作原理

该工具使用“智能后端路由”系统，自动在三种不同方法之间切换以获取数据：

1. FxTwitter：用于快速、无依赖地获取单条推文和用户资料。
2. Nitter：通过直接 HTTP 请求使用 Nitter 实例（自托管或公共）获取时间线、搜索结果和回复。
3. 浏览器驱动：使用 Camofox 或 Playwright 处理复杂任务，如获取 X 列表和全文文章，这些任务需要真实浏览器环境。

所有数据均被归一化为统一的 JSON 模式，确保无论使用哪个后端，输出格式都保持一致，便于下游 AI 提示使用。

适用人群

主要面向需要可靠、免登录访问 X 数据以进行监控、归档或内容分析的 AI 代理和开发者。

特色亮点

• 自动故障转移：当一个后端失败时，自动切换到其他后端，并提供机器可读的错误码，便于代理分支处理。
• 本地归档：包含“Ledger”功能，将获取的推文保存到 SQLite 数据库中，支持离线查询和统计分析。
• 统一模式：将不同数据源归一化为单一的 Tweet / Reply / Article 格式。
• 全面覆盖：支持单条推文、线程回复、分页时间线、搜索结果、X 列表和 X 文章。
• 灵活部署：支持 CLI 和 Python API 两种方式。