1broseidon/ketch

Fast, stateless CLI for web search and scrape. Built for AI agents.

What it solves

Ketch 簡化了人類與 AI 代理蒐集外部資料的流程，將多種搜尋、程式碼與文件提供者整合成單一、無狀態的 CLI 工具。使用者不必再管理多個 SDK、認證方式以及不同研究工具的回應格式，只要使用一個二進位檔即可執行網路搜尋、grep 開源程式碼、存取函式庫文件，並將網頁爬取成乾淨的 Markdown。

How it works

Ketch 充當統一介面，將請求路由至各種已設定的後端。它提供以下主要功能表面：

  • Web Search：整合 Brave、DuckDuckGo、SearXNG、Exa、Firecrawl 與 Keenable 等提供者。支援使用 Reciprocal Rank Fusion 的「rank‑fused」聯合搜尋，跨多個後端進行搜尋。
  • Code Search：透過 Grep、Sourcegraph 或 GitHub Code Search 搜尋公開 OSS 原始碼。
  • Documentation：透過 Context7 提供具版本感知的函式庫文件。
  • Scraping/Crawling：將 HTML 與文字型 PDF 轉換為乾淨的 Markdown。對於需要 JavaScript 渲染的頁面（SPA）會自動回退至無頭 Chrome 瀏覽器，並支援自訂 Cookie 以取得驗證內容。

此工具為無狀態，產生結構化的 JSON 輸出，讓 AI 代理能透過 shell 指令或作為 MCP（Model Context Protocol）伺服器輕鬆整合。

Who it’s for

  • AI Agent Developers：需要可預測、單一二進位檔的研究工具，免除撰寫特定提供者的黏合程式碼。
  • Power Users/Developers：想要快速的終端機替代方案，取代瀏覽器分頁或複雜的 curl | pandoc 流程，以抽取網頁內容。

Highlights

  • Unified Interface：一個工具同時支援網路搜尋、程式碼搜尋、文件與爬蟲。
  • Agent-Optimized：提供結構化 JSON 輸出、文件化的退出代碼以控制流程，並有 ketch config 探索指令可查詢功能。
  • Smart Extraction：對 SPA 自動使用 JS 渲染回退，內建純 Go PDF 解析器。
  • MCP Support：可作為 MCP 伺服器執行，將研究功能作為 AI 代理的工具提供。
  • Flexible Configuration：支援 CLI 旗標、環境變數與設定檔，並支援多金鑰輪替以管理速率限制。