代理搜索- mcp

MCP( 模式上下文协议) 服务器 代理搜索 用于光标、 Claude 桌面和其他 MCP 主机 静态它有两组工具:

• 无设置的自由网页搜索 : 没有配置, agentsearch_web_search 使用 AgentSearch 自由级(https://relay.agentsearchhq.com/v1/search: 每个IP最多25个搜索/日,但须符合共享的每日容量,只搜索,没有键或钱包。 当日限被击中(HTTP 429)时,工具解释如何升级到付费.
• 提取和渲染,按电话付费(如果您选择加入,也要搜索): agentsearch_extract 财务报告和审定财务报表 agentsearch_render。添加钱包密钥后,这些会通过 口袋网络代理门户 以美元支付每个抽取呼叫0.005美元结束 x402 (韩语)钱包密钥 没有 已支付搜索: 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 (中文(简体) )。 。 。 .

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

模式

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

付费模式如何运作

1. 请求未支付;门户回答 402 带有 x402 v2 条件(PAYMENT-REQUIRED) (中文(简体) ).
2. 服务器检查每个限制 签署前 (见下文),然后签署EIP-3009 TransferWithAuthorization uSDC 基地与官员 @x402/core + 键 @x402/evm 客户端和 viem。 。 。 .
3. 它曾经重复过一次 PAYMENT-SIGNATUREA级 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),"门户"的收款人(0xF732ea490c5766071785a2310523f7fA2CEbB829402,其资源是上述三项服务之一。 任何其它的都被拒签了.
• 密钥从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://relay.agentsearchhq.com 服务 仅搜索。当没有配置时会自动使用;您不再需要设置它。 如果你把它设定为 AGENTSEARCH_BASE_URL 无论如何, agentsearch_extract 财务报告和审定财务报表 agentsearch_render 返回一个明显的错误(而不是空白) 404 {"detail":"Not Found"}) (中文(简体) ). 提取和制取使用付费模式AGENTSEARCH_WALLET_PRIVATE_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 设置.

安装

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

线条设置 : 页:1。 。 。 .

从本地取出 :

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

环境变量

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

光标

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

{
  "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 密钥 :

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

线

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

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

或用克线CLI:

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

对于已付提要/招标书,增加一个 env 块为 AGENTSEARCH_WALLET_PRIVATE_KEY 如光标示例;除非您也设置了,否则搜索将保持自由 AGENTSEARCH_MODE=paid。完整指南 : 用 MCP 在 Cline 中添加免费网页搜索。 。 。 .

克劳德代码

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

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数字 :

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

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

保存后重新启动 Claude 桌面 .

本地运行

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促进器支付气体.

许可证

麻省理工学院