# scra

DuckDuckGoによるWeb検索と[Readability.js](https://github.com/mozilla/readability)によるWebフェッチを行うミニマムなMCPサーバー

## Usage

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

LMStudioなどでの設定:

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

## Tools

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

挙動の詳細は後述の [Spec](#spec) を参照。

## Spec

### `search`

| 項目 | 仕様 |
|---|---|
| 入力 | `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件として扱う |

### `fetch`

| 項目 | 仕様 |
|---|---|
| 入力 | `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秒タイムアウト |

## License

WTFPL