返回首頁

GitHub Repo

Firecrawl 淘汰舊 GitHub 搜尋介面,代理工具須遷移至 Developer Index

Firecrawl 官方文件將舊研究索引的 GitHub 搜尋端點標示為於 11 月 3 日移除,改回 HTTP 410 並引導至 Developer Index。遷移涉及回傳欄位與搜尋分類限制,既有程式須同步調整解析及錯誤處理。

Rsa · CC BY-SA 3.0 · Image source
zh-Hant

Firecrawl 的 GitHub 搜尋介面進入遷移階段。官方文件已將研究索引下的 GitHub 搜尋標示為於 2026 年 11 月 3 日移除:GET /v2/search/research/github 與舊別名 GET /v2/research/github 回傳 410 Gone,呼叫端應將原有 query、k 轉送至支援 GET、POST 的 /v2/search/developer。這會直接影響替編碼代理查找議題、修補紀錄與套件用法的檢索流程。官方文件

移除設計也明確區分了錯誤類型。相關 PR 將 410 處理放在驗證、速率限制與額度檢查之前,回應包含 ENDPOINT_REMOVED、替代路徑與文件連結,且不計費。對代理執行器而言,這代表應切換工具設定;若把它當暫時性故障反覆重試,將無法恢復搜尋。端點移除提案

另一項變更針對 /v2/search 的 github 分類。它原本只加入 site:github.com 網域條件;移除方案會對仍傳入該分類的請求回覆明確的 400。需要開發者索引可改用 developer,只需 GitHub 網頁結果則可使用 includeDomains: ["github.com"],兩者的檢索範圍並不相同。分類變更提案

解析結果也須調整。Developer Index 專用端點回傳穩定的 id 與命中段落 passages,取代舊介面的 snippet;文件結果可能沒有標題。若透過一般搜尋使用 developer 分類,結果則放在 web 群組,且該分類不能與其他分類混用。工程團隊應依是否需要段落與索引篩選條件選擇入口,並檢查既有欄位假設。回應格式與限制

主分支提交列表已出現 11 月 3 日的移除與後續修正紀錄,但查核取得的 PR 頁面仍顯示開啟,公開頁面存在狀態差異。本次未實測託管 API,也未確認對應 SDK 發行版本;部署前應核對實際服務回應、套件版本與解析相容性。提交紀錄

來源

  1. Developer Index
  2. Retire research index GitHub search with 410 Gone — PR #5537
  3. Remove the github search category with a precise 400 — PR #5538
  4. Firecrawl main branch commits