⚡ 重點摘要：用 Python 串接內政部建物/土地權利 API，加上「自動換 token」與「查完一筆立即保存到 Excel」兩個設計，就能把原本要一筆一筆手動查詢的土地謄本作業，變成可以批次跑、中途斷線也不會遺失資料的自動化工具。

這個案子的背景

客戶是不動產業者（元鼎不動產），業務上常常需要針對大量地號、建號查詢對應的建物與土地權利資訊。傳統做法是在政府網頁介面上一筆一筆手動輸入查詢、複製貼上結果，數量一多，人力成本跟出錯機率都會直線上升。客戶希望有一套工具，能輸入一批地號/建號清單，自動跑完所有查詢，結果整理成 Excel。

💡 最終架構：Python 腳本，串接內政部建物/土地權利 API，具備自動換 token、增量保存至 Excel、查詢進度追蹤三個核心設計

三個核心設計

1

自動換 Token

政府 API 的存取權杖通常有時效限制，大量批次查詢很容易在跑到一半時因為 token 過期而全部失敗。工具內建自動偵測 token 是否即將過期的機制，快到期前自動重新取得新 token，讓長時間批次查詢不會因為單一環節過期就整批中斷。

2

增量保存到 Excel

如果查完全部幾百筆資料才一次寫入 Excel，任何一次網路中斷、程式意外中止，先前查到的資料都會全部消失，等於要從頭重跑。工具設計成每查完一筆就立即寫入 Excel，即使中途中斷，已完成的查詢結果都不會遺失。

3

查詢進度追蹤

搭配增量保存，工具同時記錄目前查到清單中的第幾筆，重新執行時可以直接從中斷的地方接續查詢，不需要整批重跑已經查過的資料，大幅節省重跑時間跟 API 呼叫次數。

📝 小柯備註：這個案子目前記錄下來的是核心架構跟設計理念。如果你想公開分享更多實戰細節（例如實際遇到的 API 回應格式問題、單批查詢筆數上限抓多少比較穩），可以補充成「踩過的坑」段落，會讓這篇文章對同業更有參考價值。

這套工具適合誰？

共同條件是：查詢量夠大（幾十筆以上手動查詢就已經很花時間）、查詢清單能事先整理成結構化格式（地號/建號清單），這樣才能真正發揮批次自動化的效益。

常見問題

土地謄本可以大量批次查詢嗎？
如果透過內政部提供的建物/土地資訊 API，並用程式串接、自動化執行查詢流程，就能一次處理大量地號/建號的查詢需求，不需要在網頁介面上一筆一筆手動輸入。
自動化批次查詢工具中途斷線，資料會不會不見？
如果工具設計時就把每查完一筆立即寫入 Excel，而不是等全部查完才一次寫入，就算中途斷線，已查到的資料也不會遺失，重新執行時可以從中斷的地方接續。
為什麼需要自動換 token 的機制？
多數政府 API 的存取權杖都有效期限，大量批次查詢往往會超過單一 token 的有效時間，如果沒有自動換發新 token 的機制，查到一半就會全部失敗，因此需要在程式裡加入自動換 token 的邏輯。
✅ 這次的收穫：「增量保存 + 進度追蹤 + 自動換 token」這套組合，其實是所有長時間批次 API 查詢工具都適用的通用設計模式，不只限於地政資料，後續遇到類似的大量資料查詢需求都可以直接套用這套架構。

如果你也有大量資料查詢的需求

不管是政府開放資料 API、還是其他系統的批次查詢需求，只要能結構化清單、有對應的 API 或查詢介面，都可以評估用類似的自動化方式處理。歡迎聊聊你的實際查詢量與需求。