scra

Enables web search via DuckDuckGo and content extraction from URLs using Readability.js.

README

DuckDuckGoによるWeb検索とReadability.jsによるWebフェッチを行うミニマムなMCPサーバー

git clone https://github.com/dncwolf/scra.git
cd scra && bun install

LMStudioなどでの設定:

{
  "mcpServers": {
    "scra": {
      "command": "bun",
      "args": ["run", "/path/to/scra/index.ts"]
    }
  }
}

ツール	説明
`search`	キーワードでDuckDuckGoを検索し、タイトル・URL・スニペットを番号付きで返す
`fetch`	URLを指定してページ本文をMarkdown形式（`# タイトル` + 本文）で返す。SPA対応

挙動の詳細は後述の Spec を参照。

項目	仕様
入力	`query: string`, `limit: int`（1〜20、デフォルト5。範囲外はスキーマ違反エラー）
出力	1件ごとに `N. {title}\n URL: {url}\n {snippet}`（スニペットなしは省略）を空行区切り。0件時は「検索結果が見つかりませんでした。」
取得先	`https://duckduckgo.com/?q={query}`（JSレンダリング版。HTMLエンドポイントはheadlessをbot遮断するため不可）
解析	結果セレクタ `[data-testid="result"]` の描画を最大12秒（全体30秒予算の残りでクランプ）待機し、短いnetwork idleの後に各要素から `[data-testid="result-title-a"]` のリンクと `[data-result="snippet"]` を抽出。http(s)以外のリンクは除外。duckduckgo.comへのリンクは `uddg` パラメータの復元のみ許可（`/y.js` スポンサー枠・内部リンクはここで除外）
エラー	HTTP非2xx（レート制限など）・ナビゲーション失敗、SERP自体が描画されない場合（bot対策ブロックの可能性）は `isError: true` + `search エラー: {理由}`。SERPは描画されたが結果セレクタが現れない場合は正当な0件として扱う

項目	仕様
入力	`url: string`（URL形式。違反はスキーマ違反エラー）
出力	`# {title}\n\n{本文}`。本文は各行trim → 3連以上の改行を2連へ圧縮 → 50,000文字超過分を切り捨て注記を付加（ページからの転送自体も200,000文字で上限）
描画	`domcontentloaded` 後、network idle（500ms静止）を最大2秒ベストエフォート待機。Readabilityをページ内へ注入して抽出（CSPはバイパス）。画像・フォント・メディアは取得しない（`search` も同様）
エラー	スキーマ違反 / SSRF拒否 / HTTPエラー / Readability抽出失敗 / リダイレクト遮断による到達失敗 / 20秒タイムアウト