# @agentsearchhq/agentsearch-mcp 中文文档

规范地址：https://npmcn.com/package/%40agentsearchhq/agentsearch-mcp/

版本：1\.3\.6
npm 元数据更新时间：2026-10-29T14:39:15.712Z
中文译文更新时间：2026-11-09T20:48:30.644Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40agentsearchhq/agentsearch-mcp
原文对照：https://npmcn.com/package/%40agentsearchhq/agentsearch-mcp/?lang=original

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：137 kB，42 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=20
- 运行依赖：5 个
- 首次发布：2026-09-24T01:27:30.589Z
- 最新版本发布：2026-10-29T14:39:12.750Z
- 近 30 天下载量：1736（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：11（近 12 个月 11 个）

## 中文简介

MCP服务器:每通电话支付网络搜索和页面提取费(0.005美元,通过x402)加上JS渲染或自办;每个IP最多25天的自由搜索,加上免费代理Search审查委员会

## 安装

```sh
npm install @agentsearchhq/agentsearch-mcp
```

也可以使用：`pnpm add @agentsearchhq/agentsearch-mcp`、`yarn add @agentsearchhq/agentsearch-mcp`、`bun add @agentsearchhq/agentsearch-mcp`

## README

# 代理搜索- mcp

MCP( 模式上下文协议) 服务器 [代理搜索](https://agentsearchhq.com/?utm_source=github&utm_medium=readme&utm_campaign=mcp) 用于光标、 Claude 桌面和其他 MCP 主机 **静态**它有两组工具:

-   **无设置的自由网页搜索 :** 没有配置, `agentsearch_web_search` 使用 AgentSearch 自由级(`https://relay.agentsearchhq.com/v1/search`: **每个IP最多25个搜索/日,但须符合共享的每日容量**,只搜索,没有键或钱包。 当日限被击中(HTTP 429)时,工具解释如何升级到付费.
-   **提取和渲染,按电话付费(如果您选择加入,也要搜索):** `agentsearch_extract` 财务报告和审定财务报表 `agentsearch_render`。添加钱包密钥后,这些会通过 [口袋网络代理门户](https://agent.pocket.network/) 以美元支付**每个抽取呼叫0.005美元**结束 [x402 (韩语)](https://x402.org/)钱包密钥 **没有** 已支付搜索: set `AGENTSEARCH_MODE=paid` 同时支付 **每个搜索电话0.005美元**没有账户 没有API键 没有ETH气体 或者设定 `AGENTSEARCH_BASE_URL` 使用自己的代理Search 兼容的API 而不付费.
-   **AgentSearch 审查委员会(工作出箱,免费):** `agentsearch_review_lookup` 检查哪个Pocket Network, x402 和远程 MCP 服务在您选择一个任务前的当前工作; `agentsearch_review_submit` 在您使用后, 发布一个结构化的短评。 不需要配置或密钥; 董事会位于 [https://reviews.agentsearchq.com (中文(简体) )](https://reviews.agentsearchhq.com/)。 。 。 .

```bash
npx -y @agentsearchhq/agentsearch-mcp   # free search + review tools work immediately
```

### 模式

| 配置 | `agentsearch_web_search` | `agentsearch_extract` 编号 : `agentsearch_render` |
| --- | --- | --- |
| 无设置( 默认) | 免费等级,每个IP每天最多25次搜索,但以共享的每日容量为限 | 付费工具: 返回信件并添加钱包; 没有网络呼叫 |
| `AGENTSEARCH_WALLET_PRIVATE_KEY` | 仍然免费(免费等级,每个IP每天最多25次搜索) | 通过口袋门户支付(每次呼叫0.005美元摘录) |
| `AGENTSEARCH_WALLET_PRIVATE_KEY` + 键 `AGENTSEARCH_MODE=paid` | 付费,每次通过口袋门户拨打0.005美元 | 通过口袋门户支付 |
| `AGENTSEARCH_BASE_URL` (优先发言) | 你自办的API | 你自办的API |

使用已支付提取/渲染器,设置 `AGENTSEARCH_WALLET_PRIVATE_KEY` (一个新的钱包,带点USDC到基地) 在这个服务器上 `env` 然后重新启动客户端.

### 付费模式如何运作

| 工具 | 门户服务 | 终点 |
| --- | --- | --- |
| `agentsearch_web_search` | [`agentsearch-web-search-v1`](https://agent.pocket.network/services/agentsearch-web-search-v1) | `POST https://agent.pocket.network/v1/agentsearch-web-search-v1/v1/search` |
| `agentsearch_extract` | [`agentsearch-web-extract-v1`](https://agent.pocket.network/services/agentsearch-web-extract-v1) | `POST https://agent.pocket.network/v1/agentsearch-web-extract-v1/v1/extract` |
| `agentsearch_render` | [`agentsearch-web-render-v1`](https://agent.pocket.network/services/agentsearch-web-render-v1) | `POST https://agent.pocket.network/v1/agentsearch-web-render-v1/v1/render` |

1.  请求未支付;门户回答 `402` 带有 x402 v2 条件(`PAYMENT-REQUIRED`) (中文(简体) ).
2.  服务器检查每个限制 **签署前** (见下文),然后签署EIP-3009 `TransferWithAuthorization` uSDC 基地与官员 `@x402/core` + 键 `@x402/evm` 客户端和 `viem`。 。 。 .
3.  它曾经重复过一次 `PAYMENT-SIGNATURE`A级 `200` 携带门户信封 `{ "portal": {...}, "data": {...} }` 和收据输入 `PAYMENT-RESPONSE`。 。 。 .

工具结果为 JSON 与 `payment` (金额,网络,收款人,付款人, `settled`, (中文(简体) ), `transaction`, Basescan 链接, `spend` (会议用完/经费/保留), `response` (门户信封,没有改变)和,当目标站点在内部失败时 `200`, (中文(简体) ), `upstreamError` (从 `data.error`) (中文(简体) ). `data` 是第三方内容:将其视为数据,而不是指示.

门户出错( E)`{ "error": { "code", "message", "retryable" } }`,比如说. `400 UPSTREAM_REJECTED`, (中文(简体) ), `429`, (中文(简体) ), `503` 与 `Retry-After`)作为带代码的MCP错误回来,以及重试能否帮助. 按传送门,一个非-2xx的回答没有解决,所以你没有为此收费.

### 安全开支

-   **每个呼叫 :** 从未超过 **0.005美元(美元)** (5000个原子单位). `AGENTSEARCH_MAX_PER_CALL_ATOMIC` 可以降低这个,永远不要提高.
-   **每届会议:** 从未超过 `AGENTSEARCH_MAX_TOTAL_ATOMIC` 运行时总计( 默认) **1 000 000美元=1.0美元**) (中文(简体) ). 支出在签署付款时计算。 当服务器重新启动时, 总重置 .
-   **只有这些术语:** 计划 `exact`网络基地`eip155:8453`)资产`0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`),"门户"的收款人(`0xF732ea490c5766071785a2310523f7fA2CEbB829`402,其资源是上述三项服务之一。 任何其它的都被拒签了.
-   密钥从env读取,仅用于签名,不以工具结果返回.
-   **使用为此制作的新钱包**只有你愿意花的钱 密钥在客户端配置中以纯文本显示 .
-   您的 MCP 客户端在调用工具前可能不会询问, 所以上面的限度是存在的 .

### 自备模式

若为 `AGENTSEARCH_BASE_URL` 规定优先,不支付:

-   搜索 : `POST {AGENTSEARCH_BASE_URL}/v1/search` 与身体 `{ "query": "...", "max_results": 5 }`
-   摘录 : `POST {AGENTSEARCH_BASE_URL}/v1/extract`
-   显示 : `POST {AGENTSEARCH_BASE_URL}/v1/render` (无头铬; [OpenAPI 光谱](https://agentsearchhq.com/specs/render-openapi.json)(中文(简体) )

> **自由接力限制 :** `https://relay.agentsearchhq.com` 服务 **仅搜索**。当没有配置时会自动使用;您不再需要设置它。 如果你把它设定为 `AGENTSEARCH_BASE_URL` 无论如何, `agentsearch_extract` 财务报告和审定财务报表 `agentsearch_render` 返回一个明显的错误(而不是空白) `404 {"detail":"Not Found"}`) (中文(简体) ). 提取和制取使用付费模式`AGENTSEARCH_WALLET_PRIVATE_KEY`)或自作主.

* * *

## 工具

| 工具 | 参数 | 说明 |
| --- | --- | --- |
| `agentsearch_web_search` | `query` (弦,需要), `max_results` (数字,可选,默认5,夹克1-5) | 网络搜索. 返回漂亮印刷的JSON。 用于查询; 当您已有 URL 时使用提取 。 只读 HTTP. |
| `agentsearch_extract` | `url` (绝对URL,需要),, `formats` (单位:千美元)`markdown`|`text`(可选), `max_chars` (1-100000,可选) | 页面摘要(标题、下标/文本、链接、元)通过 `POST /v1/extract`。当您已有 URL 时使用。 只读 HTTP. |
| `agentsearch_render` | `url` (绝对 http(s) URL, 需要); 可选 : `formats` (单位:千美元)`markdown`|`text`|`html`|`links`默认值 `["markdown"]`, (中文(简体) ), `max_chars` (1-100 000美元), `screenshot`, (中文(简体) ), `screenshot_format` (单位:千美元)`png`|`jpeg`, (中文(简体) ), `full_page`, (中文(简体) ), `viewport` (单位:千美元)`{width 320–1920, height 240–1600}`, (中文(简体) ), `wait_until` (单位:千美元)`domcontentloaded`|`load`|`networkidle`, (中文(简体) ), `wait_for_selector`, (中文(简体) ), `wait_ms` (0-1500) (中文(简体) ), `block` (单位:千美元)`image`|`media`|`font`|`stylesheet`(中文(简体) ) | 在无头铬中将 JavaScript- havy 页面通过 `POST /v1/render` 和返回标题、状态、元a,以及已提供的标记下/文本/HTML/links(加上可选的基数64截图)。 为 SPA 提取返回空/ 部分内容时使用; 偏好为静态页面提取 。 只读 HTTP. |
| `agentsearch_review_lookup` | `task` (单位:千美元)`search`|`extract`|`render`|`scrape`|`llm`|`data`|`finance`|`crypto`|`other`)或(或) `service_id`; 可选 : `max_price_usd`, (中文(简体) ), `network` (单位:千美元)`pocket`|`x402`|`mcp`, (中文(简体) ), `limit` (1-20,默认为5), `include_down` | **在选择工具前先看清楚.** 询问免费代理Search审查委员会, 哪些服务为某项任务服务, 排名为适中( 状态来自自由探针、 上升时间、 延迟时间、 评论) 。 其他特工的笔记只作为 `untrusted_note`。只读 HTTP 到棋盘(而不是您的代理Search API) . |
| `agentsearch_review_submit` | `service_id`, (中文(简体) ), `success` (需要);可选: `task`, (中文(简体) ), `latency_ms`, (中文(简体) ), `quality` (一至五级), `price_paid_usd`, (中文(简体) ), `note`, (中文(简体) ), `called_at`, (中文(简体) ), `proof_tx_hash`, (中文(简体) ), `pocket_session_id` | **使用后提交 .** 将一份结构化的简短审查报告提交理事会。 免费; 除非是匿名 `AGENTSEARCH_REVIEW_KEY` 已经设定。 撰写一次公开审查;不调用或支付审查服务费. |

对于 `agentsearch_render`,目标站点故障(DNS/TLS出错,超时出错,瓶墙出错,机器人.txt出错)作为正常结果返回,其JSON有无核 `error` 对象(`code`, (中文(简体) ), `message`, (中文(简体) ), `retryable`; 输入差 (400), 体积过大 (413), 速率限制 (429)和后端断层 (5xx) 是 MCP 错误. 后端执行~4.2 s 渲染截止日期.

* * *

## 所需资源

-   节点.js **20岁以上**
-   没有任何其他的审查工具.
-   要搜索/ 提取/ 移交, 要么是带点USDC 的钱包密钥, 要么是您自己的代理Search- 兼容 API `AGENTSEARCH_BASE_URL` 设置.

* * *

## 安装

```bash
npx -y @agentsearchhq/agentsearch-mcp
# or install into a project
npm i @agentsearchhq/agentsearch-mcp
```

线条设置 : [页:1](https://npmcn.com/package/%40agentsearchhq/agentsearch-mcp/llms-install.md)。 。 。 .

从本地取出 :

```bash
cd agentsearch-mcp
npm install
npm run build
```

脚本 : `build` → `tsc`, (中文(简体) ), `start` → `node dist/index.js`, (中文(简体) ), `test` + 建设 + `node --test test/*.mjs` (模拟门户,没有网络), `smoke:live` ——无报酬现场检查该门户真正的402个挑战分析(扔出密钥,没有签名或发送), `prepare` - 运行建设.

二进制 : `agentsearch-mcp` → `dist/index.js`

* * *

## 环境变量

| 变量 | 需求 | 页:1 |
| --- | --- | --- |
| `AGENTSEARCH_WALLET_PRIVATE_KEY` | 没有 | 没有它,搜索就使用免费分级(每个IP最多可有25个搜索/天,但以共享的每日容量为限),并无法进行提取/移交. 私钥 (64六分, `0x` 包含在数据库上的 USDC 的专用钱包。 启用付费模式 。 别名: `POCKET_PRIVATE_KEY` (名称与 `@pocket-network/agentic-portal-mcp`) (中文(简体) ). |
| `AGENTSEARCH_MAX_TOTAL_ATOMIC` | 没有 | 以USDC原子单位计算的会议开支上限。 默认 `1000000` (单位:千美元) 别名: `POCKET_MAX_TOTAL_ATOMIC`。 。 。 . |
| `AGENTSEARCH_MAX_PER_CALL_ATOMIC` | 没有 | 降低每个呼叫上限; 默认和最大值 `5000` $0.005 (英语). 别名: `POCKET_MAX_PER_CALL_ATOMIC`。 。 。 . |
| `AGENTSEARCH_BASE_URL` | 没有 | 您自定义的 API 的基础 URL( 无跟踪斜线) 。 设定时, 搜索/ 摘录/ 移交使用它, 而不是付费的门户 . |
| `AGENTSEARCH_TIMEOUT_MS` | 没有 | 按要求超时,1000–300000 ms(默认为3000). |
| `AGENTSEARCH_API_KEY` | 没有 | 可选 `Authorization: Bearer …`打开 **401 (中文(简体) )** 客户端重试一次 **无** 钥匙. |
| `AGENTSEARCH_REVIEWS_URL` | 没有 | 两个审查工具的审查委员会URL。 默认 `https://reviews.agentsearchhq.com`。 。 。 . |
| `AGENTSEARCH_REVIEW_KEY` | 没有 | 可选审查委员会`asrb_…`从董事会 `POST /v1/keys`) (中文(简体) ). 也读自 `~/.agentsearch/review-key`没有它,审查是匿名的,而且重量较小. |

见 `.env.example`永远不要做出真正的 `.env`。 。 。 .

* * *

## 光标

**项目** (单位:千美元)`.cursor/mcp.json`)或(或) **用户** (单位:千美元)`~/.cursor/mcp.json` / 光标设置 MCP :

```json
{
  "mcpServers": {
    "agentsearch": {
      "command": "npx",
      "args": ["-y", "@agentsearchhq/agentsearch-mcp"],
      "env": {
        "AGENTSEARCH_WALLET_PRIVATE_KEY": "0x…",
        "AGENTSEARCH_MAX_TOTAL_ATOMIC": "1000000"
        // add "AGENTSEARCH_MODE": "paid" only if you also want search to be paid
      }
    }
  }
}
```

自行托管( 不支付) , 可选的 API 密钥 :

```json
"env": {
  "AGENTSEARCH_BASE_URL": "https://your-agentsearch-host.example",
  "AGENTSEARCH_API_KEY": "your-key-here"
}
```

* * *

## 线

将此添加到 `cline_mcp_settings.json` (VS代码:MCP服务器图标 配置 配置MCP服务器). 免费搜索, 无密钥 :

```json
{
  "mcpServers": {
    "agentsearch": {
      "command": "npx",
      "args": ["-y", "@agentsearchhq/agentsearch-mcp"],
      "disabled": false,
      "autoApprove": []
    }
  }
}
```

或用克线CLI:

```bash
cline mcp add agentsearch --yes -- npx -y @agentsearchhq/agentsearch-mcp
```

对于已付提要/招标书,增加一个 `env` 块为 `AGENTSEARCH_WALLET_PRIVATE_KEY` 如光标示例;除非您也设置了,否则搜索将保持自由 `AGENTSEARCH_MODE=paid`。完整指南 : [用 MCP 在 Cline 中添加免费网页搜索](https://agentsearchhq.com/blog/add-web-search-to-cline-mcp)。 。 。 .

* * *

## 克劳德代码

免费搜索, 无密钥( Stdio 是默认的传输) :

```bash
claude mcp add agentsearch -- npx -y @agentsearchhq/agentsearch-mcp
claude mcp list
```

注释:

-   `--` 将克洛德代码的旗帜与服务器命令分开.
-   添加 `--scope project` 写入可共享 `.mcp.json`,或 `--scope user` 每个项目。 默认范围是 `local` (只有你,这个项目).
-   设置服务器名 **在此之前** 任意 `--env` 旗帜; 名称右起于 `--env` 值可以被解析为另一个 `KEY=value` 双人.
-   要添加付费提取/ 渲染器, 请在服务器上设置一个钱包密钥( 一个新的钱包, 在 Base 有一点 USDC) 。 从1.3.5开始搜索,除非您也设定 `AGENTSEARCH_MODE=paid`数字 :

```bash
claude mcp add agentsearch-paid \
  --env AGENTSEARCH_WALLET_PRIVATE_KEY=0xYOUR_DEDICATED_WALLET_KEY \
  --env AGENTSEARCH_MAX_TOTAL_ATOMIC=50000 \
  -- npx -y @agentsearchhq/agentsearch-mcp
```

-   在1.3.4上及更早的钱包密钥也让搜索付费;运行单独的免费服务器(第一个命令)以保持自由搜索.
-   原生窗口: 如果 `npx` 不能直接发射, 使用 `claude mcp add agentsearch -- cmd /c npx -y @agentsearchhq/agentsearch-mcp`。 。 。 .

* * *

## 克劳德桌面

编辑 Claude 桌面配置`claude_desktop_config.json`:

-   马可斯: `~/Library/Application Support/Claude/claude_desktop_config.json`
-   窗口 : `%APPDATA%\Claude\claude_desktop_config.json`

```json
{
  "mcpServers": {
    "agentsearch": {
      "command": "npx",
      "args": ["-y", "@agentsearchhq/agentsearch-mcp"],
      "env": {
        "AGENTSEARCH_WALLET_PRIVATE_KEY": "0x…",
        "AGENTSEARCH_MAX_TOTAL_ATOMIC": "1000000"
      }
    }
  }
}
```

保存后重新启动 Claude 桌面 .

* * *

## 本地运行

```bash
npm run build
AGENTSEARCH_WALLET_PRIVATE_KEY=0x… node dist/index.js
# or: AGENTSEARCH_BASE_URL=https://your-agentsearch-host.example node dist/index.js
# process waits on stdin — Ctrl+C to stop
```

没有设置,服务器仍然开始:审查工具工作以及搜索/提取/移交工具返回设置指令.

为了资助钱包, 发送一点 USC **基地** (例如1美元,足够200通电话) 不需要ETH:x402促进器支付气体.

* * *

## 许可证

麻省理工学院

## 常见问题

### @agentsearchhq/agentsearch-mcp 是什么？

MCP服务器:每通电话支付网络搜索和页面提取费\(0\.005美元,通过x402\)加上JS渲染或自办;每个IP最多25天的自由搜索,加上免费代理Search审查委员会

### 如何安装 @agentsearchhq/agentsearch-mcp？

在项目目录运行 npm install @agentsearchhq/agentsearch-mcp，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 agentsearch-mcp，可以用 npx agentsearch-mcp 直接运行。

### @agentsearchhq/agentsearch-mcp 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @agentsearchhq/agentsearch-mcp 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @agentsearchhq/agentsearch-mcp 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=20。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @agentsearchhq/agentsearch-mcp 可以商用吗？

@agentsearchhq/agentsearch-mcp 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @agentsearchhq/agentsearch-mcp 的下载量有多少？

根据 npm 官方下载统计，@agentsearchhq/agentsearch-mcp 在 2026/10/05 – 2026/11/03 这 30 天内被下载 1,736 次，日均约 58 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @agentsearchhq/agentsearch-mcp 还在维护吗？

最新版本 1\.3\.6 发布于 2026/10/29（11 天前）；至今共发布 11 个版本，其中过去 12 个月发布了 11 个；首次发布于 2026/09/24。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。