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 兩種方式。