baoyu-danger-x-to-markdown

此工具專為研究人員、內容創作者與數位典藏者設計，旨在捕捉 X (Twitter) 上的重要內容以進行長期保存、筆記整理或知識管理。它能自動將單則推文、長串文以及複雜的 X 文章轉換為標準化的 Markdown 檔案。透過 YAML 前言，該工具保留了原始網址、作者資訊與媒體參考連結等關鍵後設資料，確保保存的內容在 Obsidian、Notion 或靜態網站產生器中依然具備高度可用性與上下文。

• 支援將完整的串文轉換為帶有結構化 YAML 後設資料的 Markdown 格式。

• 支援直接擷取 X 文章，轉為易讀的排版文字。

• 提供可選的媒體處理功能，可自動下載圖片與影片並自動調整為相對路徑。

• 採用反向工程 API 技術，在初次使用時強制要求取得使用者同意，確保使用者了解此為非官方擷取工具。

• 透過 EXTEND.md 檔案管理輸出目錄，支援專案層級或全域使用者層級的偏好設定。

• 首次使用時，工具會執行必要的初始化設定流程，以配置媒體下載與輸出目錄儲存路徑。

• 請注意，由於此工具依賴非官方的反向工程 API，平台的變動可能會影響其功能，建議適時確認 API 狀態。

• 可使用 CLI 參數 --download-media 進行本地資產歸檔，或使用 --json 進行原始資料處理。

• 當工具請求同意或進行設定時，優先配合代理執行環境提供的互動工具（如 AskUserQuestion）。

• 使用前請確認已安裝 Bun 環境或 Node.js 與 npx，以確保底層腳本能順利執行。