用 tiny-browse 给本地 Agent 装一个免 API Key 的联网工具：doctor 自检、MCP 接入与硬 token 预算实操

node -v
# 需要 v22.x 或更高；低于 22 请先升级 Node

# 之后由 doctor 统一体检浏览器、速率预算与端口
tiny-browse doctor

# npm（推荐）
npm install -g @shubhamcodess/tiny-browse
tiny-browse doctor

# 从最新 GitHub Release 的 tgz 安装
npm install -g https://github.com/shubhamcodess/tiny-browse/releases/latest/download/tiny-browse.tgz

# 从源码
git clone https://github.com/shubhamcodess/tiny-browse.git
cd tiny-browse
npm ci
npm run build
npm link

# Claude Code
claude mcp add tiny-browse -- npx -y @shubhamcodess/tiny-browse mcp

# 让工具帮你打印对应客户端的配置片段
tiny-browse config claude-code
tiny-browse config vscode
tiny-browse config cursor

# Cursor / Claude Desktop 等通用写法
{
  "mcpServers": {
    "tiny-browse": {
      "command": "npx",
      "args": ["-y", "@shubhamcodess/tiny-browse", "mcp"]
    }
  }
}

web_search 参数（官方默认值）
query        字符串，必填；支持 site: 与引号等 Google 运算符
max_results  整数 1-10，默认 5，参与排序的结果数
read         整数 0-10，默认 3，真正打开并阅读的结果数；0 只回列表
max_tokens   整数 200-200000，默认 6000，整份答案的硬上限
site         字符串，限定域名
freshness    any / day / week / month / year，默认 any
return_images 布尔，默认 false

# 给 Agent 的一句指令示例
用 web_search 查 "Node.js 22 stream backpressure"，
max_results=5，read=2，max_tokens=2000，freshness=month，
把结论连同每条来源 URL 一起给我。

web_fetch 参数（官方默认值）
urls         字符串数组 1-10，以 http(s) 开头的完整地址
max_tokens   整数 200-200000，默认 8000，多个 URL 共用
focus        字符串，只返回与该问题最相关的段落
cursor       字符串，续读上次被截断的页面
render       auto / http / browser，默认 auto
return_images 布尔，默认 false

# 库方式调用（先 npm install @shubhamcodess/tiny-browse）
import { webSearch, webFetch } from "@shubhamcodess/tiny-browse";

const { results, pages, markdown } =
  await webSearch({ query: "node.js stream backpressure", read: 2 });
const docs = await webFetch({
  urls: ["https://go.dev/doc/effective_go"],
  focus: "goroutines", max_tokens: 2000
});
console.log(docs.pages[0].markdown);

# 默认只监听回环地址
tiny-browse serve --http 7777

# 需要显式指定主机或加访问令牌时
tiny-browse serve --http 7777 --host 127.0.0.1 --token SECRET

# 端点
POST /mcp      MCP over Streamable HTTP
POST /search   JSON API，返回 markdown / data / images
POST /fetch    JSON API，参数同 web_fetch
GET  /health   { ok, name, version }

# VS Code 的 HTTP 客户端配置
{ "servers": { "tiny-browse": {
  "type": "http", "url": "http://127.0.0.1:7777/mcp" } } }