eBird Scripts

緣起

使用新版 eBird 網站中，發現一些不甚好用的地方，因此製作此腳本以改善使用體驗。

功能

手機計鳥網頁（不需 Tampermonkey）

開啟計鳥網頁 · 完整說明

獨立的 GitHub Pages 靜態網頁，採緊湊手機列表與本機自動保存。可匯入個人 eBird ZIP／CSV，以全部完整鳥單頻率建立所有地點共用的可收合分組；沒有個人資料則使用全台公開頻率。預設自動估算常見約 15 種、少見再 30 種，支援即時門檻預覽、拖曳自訂區塊／鳥種順序、數字快速加減、描述、繁殖、GPS 距離與附近已設地點預選。計鳥頁不需要安裝腳本，個人資料不會上傳。

既有自訂網域下的預期位置是 https://christorng.idv.tw/eBirdScripts/counter/。功能分支 push 不會更新正式網站；合併到 main 並由 GitHub Pages 發布後才会上線。不要把專案的 CNAME 改成網域根目錄。

eBird Scripts

eBird Scripts 是一個 Tampermonkey 使用者腳本，用於增強 eBird 網站的功能。

• 繁體中文介面的日期統一改為「年/月/日」；含星期時顯示為「2026/9/2 (三)」，提交頁日期欄位也依序排列為年、月、日。英文介面維持 eBird 原格式。
• 開啟異常的 /atlastw/myebird/TW?continue 時，自動移除 ?continue 並重新導向正常的「我的 eBird」頁面。
• 在全站瀏覽列同時提供「資料探索」與「TW 資料探索」，可直接切換一般 eBird 與臺灣繁殖鳥類大調查的探索頁面。
• eBird 熱門鳥點
  • 開啟地圖時自動定位到目前位置，時間範圍設為今年全年度。
  • 點出各別地點的彈跳畫面內，新增「最近鳥種」及「最近紀錄」連結。

eBird 文字輸入助手

Parse Taiwan birding notes, fill eBird forms, verify page values, and optionally submit after successful verification.

eBird 文字輸入助手可將慣用的臺灣賞鳥文字紀錄帶入 eBird 提交表單：

• 貼上後立即逐行顯示日期、地點、時間及鳥種的辨識結果，無法辨識的項目會以紅字標示。
• 可直接篩選及選取 eBird 地點，並在 Tampermonkey 本機設定地名簡稱、預設地點、努力量與人數。
• 支援多種日期簡寫、常用鳥種簡稱、鳥名與數字相連的寫法，以及「唱歌」、「聽到」與「一對」等細節。
• 1.12.5 可在新增或既有清單頁輸入計鳥文字，並在編輯頁繼續填入鳥種；編輯時可省略時地距人；不檢查地點，開始時間容許相差五分鐘，距離容許相差 10%。填入成功後一律改為完整清單。原清單已有鳥種時，填入後需人工確認儲存。
• 1.10.0 支援官方完整鳥名、計鳥頁的中文繁殖簡稱（唱歌／求偶／一對／巢雛等，舊 [S] 仍相容）與 ；描述 "自由文字"，描述會與 Heard 數量合併到同一個 observation comments 欄位。
• 桌面面板預設接近全高；提交頁底部預留操作空間。可拖曳下邊界調整高度並記住設定；行動裝置預設收合。
• 填寫完成後及送出後，會分別重新讀取 eBird 頁面中的正式地點（含自建地點）、日期時間、努力量、完整清單及鳥種欄位；找不到或不符時同時顯示預期值與原因。
• 完成頁支援沒有鳥種連結的其他分類（如燕科），從整列讀取數量；不把附註中的鳥名當作另一筆紀錄。
• 完成頁核對結果只會顯示於剛由助手填寫的該筆鳥單；瀏覽其他鳥單時顯示既有清單輸入助手，已有鳥種則預設收合。
• 完成頁優先使用結構化日期時間與努力量欄位，並可解析 eBird 原始中英文日期及 eBird Scripts 改寫後的日期。鳥種依頁面順序核對，包括顯示於親種連結下的亞種。
• 「確認成功後自動儲存」預設開啟，但只有輸入無辨識失敗且提交頁全部讀回吻合時才會送出；任一項不符即禁止自動送出。
• 編輯已送出的清單時可只貼鳥種與數量，不需再設定地點、時間或努力量；地點沿用原值；日期、時間或努力量超出容錯範圍時顯示橘色提醒並保留原值，不阻擋鳥種填寫。

安裝

1. 安裝 Tampermonkey
   這是一個可用於管理使用者腳本的瀏覽器擴充套件。

2. 選擇要安裝的腳本：

   • 安裝 eBird Scripts
   • 安裝 eBird 文字輸入助手

3. 會自動開啟 Tampermonkey Install 畫面，請按 Install 鈕安裝。

4. 若先前已開啟了 eBird 相關網頁，請重新整理網頁。

使用說明

eBird Scripts

• 進入 eBird 熱門鳥點 時，會要求取得位置之權限，只要選擇允許，就會預設定位到目前所在位置，時間範圍設定為今年全年。

• 在 eBird 熱門鳥點 中點開任一熱點時，會看到新增的「最近鳥種」和「最近紀錄」的連結。

• 在各 eBird 網頁的繁體中文介面中，日期會代換為 2021/10/21；含星期時則為 2021/10/21 (四)。英文介面不修改。

• 「日期和努力量」頁面的日期選單會由月、日、年改排為年、月、日。

• 若 我的 eBird 被導向帶有異常 ?continue 的網址，會自動移除該參數。

• 全站瀏覽列會同時顯示「資料探索」與「TW 資料探索」；兩者分別連至一般 eBird 與臺灣繁殖鳥類大調查的資料探索頁面。

eBird 文字輸入助手

1. 開啟 eBird「提交觀察紀錄」頁；助手會在 eBird 地點下拉清單前加入篩選欄位。
2. 貼上文字紀錄，右側會逐行顯示辨識結果。例如：

2026/8/30
  後港新公園
  8：38 開始 28 分鐘
  金背 1
  珠頸 6 唱歌，1 聽到
  麻雀 28
  

3. 已設定的地點簡稱會自動選到對應地點。若省略地點行，會使用勾選的預設地點；尚未設定預設地點時會以紅字要求選擇。新簡稱會用來篩選 eBird 地點，並自動展開「新增／管理地點」。
4. 在文字框下方確認本筆努力量。文字中的 km／公里 距離優先採用，未填才使用地點預設距離；0 km 保留為零。可選「附帶紀錄」，或輸入距離：0～0.03 公里為定點計數，超過 0.03 公里為行進計數。
5. 日期、地點與時間沒有紅字後，按「開始填寫紀錄」。若輸入仍有未知鳥種、重複鳥種、未知細節或必要資訊缺漏，「確認成功後自動儲存」會停用，其他已知項目仍可繼續填入供人工修正。
6. 到鳥種頁後，助手會隱藏未觀察鳥種；全部設定完成後，再從表單讀回正式地點、日期時間、努力量、耗時、距離、人數、完整清單，以及每種鳥的數量、繁殖代碼與附註。核對表依 eBird 頁面順序排列，吻合才顯示勾勾，不符則以紅字列出。
7. 若已勾選自動儲存，只有提交頁全部讀回吻合時才會送出；完成鳥單頁會再次讀取所有顯示內容。前後兩頁均符合時面板收合並以綠字顯示「全部檢查符合」，任一頁失敗則自動展開紅字結果。

日期輸入

日期下拉清單預設為今天，並列出今天起向前七天；貼上的日期若更早，會自動加入並選取。文字日期可使用：

• 年/月/日、年-月-日或年.月.日。
• 月/日或月-日。
• 0、-1 至 -6，分別代表今天及往前的天數。
• 一、二、三、四、五、六、日，代表今天或最近一次的該星期日。

地點篩選

篩選欄位支援中英文，右側顯示剩餘地點筆數。輸入欄內按上下鍵會展開清單並切換地點，Enter 或 Escape 收合清單。每個輸入字元會依序篩選所有地點名稱及 ID；若某個字元會使結果變成零筆，該字元會被忽略，因此清單絕不會完全消失。

設定

eBird Scripts

• 開啟 Tampermonkey 外掛畫面，或由 eBird 網站中 (除地圖外) 任意處按右鍵，選擇 Tampermonkey - eBird Scripts 之下，可看到設定功能

• 目前支援設定「設定經緯度增量範圍」，也就是開啟 eBird 熱門鳥點 時預設地圖放大的範圍，預設值 0.05。數字越小，預設顯示地圖越放大。

eBird 文字輸入助手

• 地點設定儲存在 Tampermonkey 本機空間，可自由新增、修改或刪除，不會上傳。
• 每個地名簡稱可設定 eBird 地點 ID、完整名稱、預設努力量與人數，並可勾選其中一個作為未填地點時的預設地點。
• 文字未提供距離時使用地點預設距離；也沒有預設距離才使用「附帶紀錄」。設定距離後，0～0.03 公里使用定點計數，超過 0.03 公里使用行進計數。
• 若文字中的日期、時間、地點或鳥種無法確定，右側會以紅字顯示；助手不會猜測後送出。

相關作品

請參考我製作的 eBird 鳥訊快報整理，幫助快速瀏覽 eBird 鳥訊快報郵件內容。

問題與建議

如果遇到任何問題或功能建議，請至 GitHub 頁面 提交 issue。

支援「灰頭紅尾伯勞」與「褐頭紅尾伯勞」，分別對應紅尾伯勞的灰頭、褐頭亞種。