linkguard

linkguard

linkguard 是托管式 URL 安全扫描器的本地 stdio 前端。在 Agent 访问链接之前，linkguard 可以请求托管服务检查 URL：既可以同步检查并立即返回判定，也可以在扫描可能耗时较长时异步检查；如果你说明访问原因，还可以判断页面是否确实符合该意图。

linkguard 本身不执行任何扫描。每次工具调用都会作为 JSON-RPC tools/call POST 转发到托管的 PreClick 远程 MCP 端点 https://preclick.ai/mcp，并实质上原样返回上游答复。它支持普通 JSON 答复和 text/event-stream（SSE）答复。扫描质量、可用性和速率限制均由托管服务决定。

PRECLICK_API_KEY 是可选项。设置后，该密钥会作为托管端点文档中说明的 X-API-Key 标头发送；未设置时则不会发送此类标头，并使用无密钥试用层级。 设置后，LINKGUARD_ENDPOINT 会覆盖端点 URL。

上游服务将意图文本限制为 248 个字符；linkguard 会在发送前在本地执行该限制。

安装

npx @reneturcios/linkguard scan https://example.com
docker run -i ghcr.io/cloudcorprecords/linkguard

CLI

linkguard scan https://example.com
linkguard scan-intent https://example.com --intent "pay an invoice"
linkguard async-scan https://example.com
linkguard async-scan-intent https://example.com --intent "read the docs"
linkguard status <task_id>
linkguard result <task_id>
linkguard --version

异步命令会立即返回 task_id。使用 status 轮询，然后通过 result 获取已完成的扫描结果。

退出代码：0 表示成功，1 表示上游或验证错误，2 表示用法错误。

MCP 服务

npx -y @reneturcios/linkguard mcp

{
  "mcpServers": {
    "linkguard": {
      "command": "npx",
      "args": ["-y", "@reneturcios/linkguard", "mcp"],
      "env": { "PRECLICK_API_KEY": "your-key-if-you-have-one" }
    }
  }
}

env 块为可选项。

工具

工具	输入	返回内容
url_scanner_scan	url（字符串，必填）	URL 的上游扫描判定结果，同步返回。
url_scanner_scan_with_intent	url（字符串，必填），intent（字符串，可选，最多 248 个字符）	根据所述意图判定的上游结果。
url_scanner_async_scan	url（字符串，必填）	已提交扫描的 task_id，立即返回。
url_scanner_async_scan_with_intent	url（字符串，必填），intent（字符串，可选，最多 248 个字符）	已提交的意图感知扫描的 task_id。
url_scanner_async_task_status	task_id（字符串，必填）	异步任务的当前状态。
url_scanner_async_task_result	task_id（字符串，必填）	已完成的扫描结果；任务运行期间则返回任务状态。

上游故障——HTTP 错误、JSON-RPC 错误、主机无法访问——会作为工具错误报告，并附带底层错误消息。

开发

npm install
npm run build
npm test
npm run dev

测试完全使用模拟 fetch 测试夹具运行，涵盖普通 JSON 和 SSE 上游响应正文；不会使用网络，也不会对托管端点进行实时调用。

许可证

MIT — 参见 LICENSE。