MechanicalSoup：基於 Requests 和 BeautifulSoup 的 Python 網頁自動化函式庫
用於自動與網站互動的 Python 函式庫。 MechanicalSoup 提供了類似的 API，建構在 Python 巨頭 Requests __ （用於 HTTP 會話）和 BeautifulSoup __ （用於文件導航）之上。
秒懂
- 它是什麼？
- 一個處理 Cookie、重新導向、連結和表單提交的小型函式庫，明確不支援 JavaScript。
- 適合誰用？
- MechanicalSoup 緊密依賴於兩個基礎函式庫，README 也明確說明了其限制。對於需要 JavaScript 的專案，它不是合適的工具；對於不需要 JavaScript 的專案，它提供了簡單的 API 和持續維護的程式碼庫。
- 可以商用嗎？
- 可以。MIT 是寬鬆授權：你可以使用、修改並販售以它為基礎的軟體，只需保留著作權與授權聲明。
- 還在維護嗎？
- 有在維護。儲存庫最近一次提交在 43 天前。
- 用什麼語言寫的？
- 主要是 Python（依據 GitHub 的語言統計）。
以上回答依據專案的 GitHub 資料（最近同步於 2026年9月14日）與我們的分析，不構成法律意見。
開源專案深度解析
MechanicalSoup：促成 MechanicalSoup 的 Mechanize 缺口（1）
MechanicalSoup 由 M Hickford 編寫，他曾是 Mechanize 函式庫的常客。Mechanize 曾長期不相容於 Python 3；README 中連結的 GitHub issue 直到 2019 年才關閉，其開發也停滯了數年。MechanicalSoup 提供了類似的 API，但基於 Requests 處理 HTTP 工作階段，基於 BeautifulSoup 進行文件解析。自 2017 年起，包括 @hemberger 和 @moy 在內的小團隊持續維護該專案。README 並未給出首個版本的發布日期，因此本來源無法確定其建立的準確時間線。（段落核對1）
MechanicalSoup：Cookie 處理、重新導向、表單與 JavaScript 的邊界（2）
README 明確說明了三個核心能力：MechanicalSoup 會自動儲存和傳送 Cookie、跟隨重新導向，並可以跟隨連結和提交表單。它還直截了當地說明它不支援 JavaScript。這一限制對於選擇該函式庫至關重要。設計上依賴 Requests 作為 HTTP 工作階段層，BeautifulSoup 用於解析和導覽文件。範例程式碼使用了 StatefulBrowser 物件，這表明存在一個具有狀態的持久工作階段，但 README 並未正式定義類別階層，僅出現在範例中。（段落核對2）
MechanicalSoup：安裝：PyPI、GitHub 或本機原始碼（3）
README 給出了三種安裝路徑。已發佈版本透過 `pip install MechanicalSoup` 安裝。GitHub 上的開發版本透過 `pip install git+https://github.com/MechanicalSoup/MechanicalSoup` 安裝。對於本機檢出，`pip install .` 會安裝目前目錄。每種情況都可以新增 `--user` 將安裝位置置於目前使用者的主目錄。README 還提到 PyPy3 受支援並經過測試。它沒有列出所支援的確切 Python 版本；該資訊在 PyPI 的徽章上。（段落核對3）
MechanicalSoup：一個可執行的範例：搜尋 Qwant（4）
README 包含了取自 `examples/expl_qwant.py` 的完整範例。指令碼建立一個帶有自訂使用者代理的 StatefulBrowser，開啟 Qwant 精簡版頁面，透過 CSS 選擇器 `#search-form` 選擇搜尋表單，將查詢欄位設定為「MechanicalSoup」，然後提交表單。隨後遍歷結果連結，使用正則表達式從 Qwant 的重新導向路徑中擷取真實 URL，並列印每個結果的文字和目標位址。該範例示範了基本工作流程：開啟、選擇表單、填寫欄位、提交並解析回應頁面。`examples/` 目錄中列出了更多範例，README 還指向測試檔案，用於包含核取方塊、單選按鈕和文字區域的複雜表單。（段落核對4）
MechanicalSoup：維護、社群與倉庫狀態（5）
README 列出了 Gitter 聊天室，並指向 CONTRIBUTING.rst 以了解建置、測試和貢獻方式。它包含了建置狀態、覆蓋率、文件和 CII 最佳實踐的徽章。倉庫元資料顯示有 4,883 個星標、396 個複刻和 39 個開放問題，且專案未被封存。預設分支是 main。README 沒有詳細描述貢獻工作流程，而是將讀者指引到貢獻檔案。它還提到了文件中的 FAQ。（段落核對5）
MechanicalSoup：授權與文件（6）
MechanicalSoup 使用 MIT 授權分發。授權摘錄授予使用、複製、修改、合併、發布、分發、再授權和銷售軟體副本的權利，前提是包含版權聲明。該軟體按「現況」提供，不提供任何形式的擔保，授權也不承擔損害賠償責任。完整文件託管在 mechanicalsoup.readthedocs.io，並提供了自動生成的 API 文件的連結。README 還指向 FAQ。授權文字沒有說明支援、安全或維護承諾。（段落核對6）
在 MechanicalSoup/MechanicalSoup 的實作評估中，先確認 README 指定的執行環境，再把安裝步驟拆成依賴安裝、啟動命令與輸出檢查三個紀錄點。每個紀錄點都要保留終端結果，並標記是本機程式完成還是仍需下載資源。這能區分文件宣稱的能力與目前環境真正可用的部分。（1）（段落核對7）
MechanicalSoup/MechanicalSoup 的功能邊界要從輸入格式開始看。測試資料應使用不含敏感資訊的最小範例，固定檔名、命令列參數與版本標籤，接著比較輸出欄位、錯誤訊息和產物位置。若 README 只提供範例而沒有完整格式，就把缺少的欄位記為未知，不以推測補齊。（2）（段落核對8）
維護 MechanicalSoup/MechanicalSoup 時，應逐次對照 README 的小節、倉庫目錄與 GitHub Releases。特別要記錄 main 分支上的變更，以及 v1.4.0 是否改變安裝入口。第三方 API、模型、資料集或網站的行為，不應與本機程式的版本穩定性混為一談。（3）（段落核對9）
授權與部署也要分開判斷 MechanicalSoup/MechanicalSoup。倉庫元資料列出的授權只描述程式碼可如何使用，不能替外部資料、服務條款或使用者資料處理作保證。正式導入前，將 LICENSE、README 的網路依賴和實際執行日誌放在同一份審查紀錄中，才能針對這個專案提出可追溯的決定。（4）（段落核對10）
在 MechanicalSoup/MechanicalSoup 的實作評估中，先確認 README 指定的執行環境，再把安裝步驟拆成依賴安裝、啟動命令與輸出檢查三個紀錄點。每個紀錄點都要保留終端結果，並標記是本機程式完成還是仍需下載資源。這能區分文件宣稱的能力與目前環境真正可用的部分。（5）（段落核對11）
MechanicalSoup/MechanicalSoup 的功能邊界要從輸入格式開始看。測試資料應使用不含敏感資訊的最小範例，固定檔名、命令列參數與版本標籤，接著比較輸出欄位、錯誤訊息和產物位置。若 README 只提供範例而沒有完整格式，就把缺少的欄位記為未知，不以推測補齊。（6）（段落核對12）
維護 MechanicalSoup/MechanicalSoup 時，應逐次對照 README 的小節、倉庫目錄與 GitHub Releases。特別要記錄 main 分支上的變更，以及 v1.4.0 是否改變安裝入口。第三方 API、模型、資料集或網站的行為，不應與本機程式的版本穩定性混為一談。（7）（段落核對13）
授權與部署也要分開判斷 MechanicalSoup/MechanicalSoup。倉庫元資料列出的授權只描述程式碼可如何使用，不能替外部資料、服務條款或使用者資料處理作保證。正式導入前，將 LICENSE、README 的網路依賴和實際執行日誌放在同一份審查紀錄中，才能針對這個專案提出可追溯的決定。（8）（段落核對14）
在 MechanicalSoup/MechanicalSoup 的實作評估中，先確認 README 指定的執行環境，再把安裝步驟拆成依賴安裝、啟動命令與輸出檢查三個紀錄點。每個紀錄點都要保留終端結果，並標記是本機程式完成還是仍需下載資源。這能區分文件宣稱的能力與目前環境真正可用的部分。（9）（段落核對15）
MechanicalSoup/MechanicalSoup 的功能邊界要從輸入格式開始看。測試資料應使用不含敏感資訊的最小範例，固定檔名、命令列參數與版本標籤，接著比較輸出欄位、錯誤訊息和產物位置。若 README 只提供範例而沒有完整格式，就把缺少的欄位記為未知，不以推測補齊。（10）（段落核對16）
維護 MechanicalSoup/MechanicalSoup 時，應逐次對照 README 的小節、倉庫目錄與 GitHub Releases。特別要記錄 main 分支上的變更，以及 v1.4.0 是否改變安裝入口。第三方 API、模型、資料集或網站的行為，不應與本機程式的版本穩定性混為一談。（11）（段落核對17）
授權與部署也要分開判斷 MechanicalSoup/MechanicalSoup。倉庫元資料列出的授權只描述程式碼可如何使用，不能替外部資料、服務條款或使用者資料處理作保證。正式導入前，將 LICENSE、README 的網路依賴和實際執行日誌放在同一份審查紀錄中，才能針對這個專案提出可追溯的決定。（12）（段落核對18）
編輯結論
MechanicalSoup 緊密依賴於兩個基礎函式庫，README 也明確說明了其限制。對於需要 JavaScript 的專案，它不是合適的工具；對於不需要 JavaScript 的專案，它提供了簡單的 API 和持續維護的程式碼庫。
社群筆記