baoyu-danger-x-to-markdown

此工具透過將個別推文、完整執行緒 (threads) 和 X 文章轉換為帶有 YAML 前言的結構化 Markdown 檔案，簡化了從 X (前身為 Twitter) 歸檔內容的流程。專為研究人員、內容策展人和知識管理人員設計，它能自動提取元數據（包括作者詳細資訊、URL 和圖像封面資源），確保您的本地筆記能準確反映社交媒體內容的原始語境。

• 自動識別推文或文章 URL 並將其解析為乾淨、易讀的 Markdown。

• 支援完整的執行緒重組，將個別回覆合併為帶有 YAML 標頭的連貫文件。

• 提供強大的媒體處理功能，包括可選擇性地將圖像和影片下載到本地目錄，並在輸出檔案中自動重寫為相對路徑。

• 與本地檔案系統整合，透過用戶名和推文 ID 維護組織良好的歸檔。

• 為其逆向工程的 X API 實施了強制性的同意流程，確保用戶了解潛在的 API 穩定性或帳號相關風險。

• 透過 EXTEND.md 提供靈活的配置系統，允許用戶為特定專案或全域設定定義自訂輸出路徑和預設的媒體下載行為。

• 輸入：提供 x.com 或 twitter.com 的狀態或文章連結。工具會透過內部引擎解析這些連結，並在首次執行時請求用戶同意。

• 輸出：產生包含 YAML 前言的 .md 檔案，記錄 URL、作者和推文數量。媒體資源可選擇性地保存到本地 /imgs 和 /videos 資料夾。

• 使用：透過 CLI 執行，並可搭配 --download-media 等選項處理本地資源，或使用 --json 獲取結構化資料。請始終確保在指定路徑存在同意檔案，以避免操作中斷。

• 注意：此工具依賴逆向工程的 API 端點，該端點可能會隨時變更。它旨在用於個人知識管理，並非官方的 X 整合工具。