agentfit

agentfit

你的网站已准备好迎接 AI Agent 了吗？agentfit 会向 AgentReady 服务请求网站的免费预览：包括 0-100 分的评分、A-F 等级，以及涵盖 Agent 访问、内容可读性、发现能力 和 Agent 接口等方面的类别评分。评分完全来自上游 — 本地不会计算、删减、重命名或总结任何内容；响应正文会原样返回， 与服务返回的内容完全一致。

仅限免费层级 — 不包含付费功能

AgentReady 还提供需通过 x402 付费的路由（/v1/lite 每次收费 $0.005，/v1/audit 每次收费 $0.03，以 USDC 支付），而其原始 stdio 服务在提供钱包私钥时，会按每次调用支付完整审计费用，私钥通过 AGENTREADY_X402_PRIVATE_KEY 提供。**此重建版本完全不实现这些功能。**它仅调用有文档说明的免费路由 GET /v1/preview?url=，这也是原始服务在未提供密钥时的默认行为。付费路由和钱包密钥模式均完全省略：此版本 不持有任何支付工具，不会读取 AGENTREADY_X402_PRIVATE_KEY 或任何其他钱包或支付环境变量，也不会发送 Authorization 标头。

上游将免费预览限制为每个 IP 每分钟 10 次请求；429 响应（与其他任何非 2xx 响应一样） 会以 agentready error: HTTP 429 的形式显示。

配置

两个环境变量用于控制客户端（均为此重建版本自有且有明确标注的变量）：

• AGENTREADY_API_URL（可选）— API 基础 URL。 默认值为 https://api.youraitools.co/agentready； 末尾的斜杠会被去除。
• AGENTREADY_TIMEOUT_MS（可选）— 每个请求的 超时时间，单位为毫秒，通过 AbortController 强制执行。默认值为 30000。

工具

• audit_website — 此网站是否已准备好迎接 AI Agent？返回免费预览：0-100 分的评分、A-F 等级以及类别评分。需要一个必填参数 url（文档中指定的 REST 参数；MCP 层的参数名称是经过标注的重建结果， 因为在捕获规范时，托管的 MCP 端点未能响应）。

上游返回非 2xx 响应时，操作会失败并显示 agentready error: HTTP <status> — 上游针对 400（无效、私有或内部 URL）、422 （无法解析的主机）和 429（预览速率限制）的响应 都会以这种方式显示。服务无法访问（包括超时）时，操作会失败并显示 agentready unreachable。

命令行界面

该工具是一个子命令，接收一个 JSON 参数字符串：

npx @reneturcios/agentfit audit_website '{"url":"https://example.com"}'
npx @reneturcios/agentfit --version

输出为工具的结果文本（成功时为上游响应正文）。退出代码：成功时为 0，运行时错误时为 1，用法错误时为 2。

MCP 服务

npx -y @reneturcios/agentfit mcp

MCP 客户端配置：

{
  "mcpServers": {
    "agentfit": {
      "command": "npx",
      "args": ["-y", "@reneturcios/agentfit", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/agentfit
docker run --rm ghcr.io/cloudcorprecords/agentfit audit_website '{"url":"https://example.com"}'

开发

npm install
npm run build   # tsc -> dist/
npm test        # tsx --test test/*.test.ts (fake fetch only, no network)
npm run dev     # run the CLI from source

许可证

MIT — Copyright (c) 2026 Rene Turcios