1cent

1cent：面向 AI Agent 的网络情报服务

为 AI Agent 提供安全、受限的网络情报服务，无需订阅或 API 密钥，也无需向爬虫开放不受限制的网络访问权限。可从三个免费 MCP 工具开始；只需为实际使用的 URL 操作付费。生产环境使用 x402 v2、Base 主网 USDC 和 PayAI。

只需一条命令，即可尝试真实的安全抓取流程——固定使用 example.com，无需付费：

curl -sS https://1cent.maxzoa.ru/v1/demo/live-pulse

或者免费预览一个自选 URL，每个客户端每天（UTC）限一次：

curl -sS "https://1cent.maxzoa.ru/v1/demo/preview?url=https%3A%2F%2Fexample.com%2F"

• MCP：https://1cent.maxzoa.ru/mcp
• 免费产品演示：https://1cent.maxzoa.ru/v1/demo/pulse
• 免费实时演示：https://1cent.maxzoa.ru/v1/demo/live-pulse
• 实时目录/价格：https://1cent.maxzoa.ru/v1/catalog
• 公开信任状态：https://1cent.maxzoa.ru/status.json
• 买家指南：https://1cent.maxzoa.ru/docs/getting-started
• 浏览器购买入口：https://1cent.maxzoa.ru/try
• 结果套餐：https://1cent.maxzoa.ru/v1/products

0.8.1 版提供 43 个付费 REST/MCP 操作，以及三个免费 MCP 工具：

• catalog.tools.search — 查找合适的操作和实时价格，无需抓取 URL；
• demo.url.pulse — 查看固定的预计算输出样例，无需付费或访问网络。
• demo.live.pulse — 使用固定的 example.com 运行真实安全服务，并设有速率限制。

公开 MCP 发现采用可导航的点号表示法（web.url.status、web.site.openapi、 web.batch.url_status）。0.6 版之前的 下划线名称仍作为兼容别名接受，但会有意从 tools/list 中省略。

MCP 还提供一条买家提示词（choose_url_tool）和一项静态买家指南资源 （onecent://buyer-guide）。每个输入字段都包含约束、示例和机器可读说明，帮助 Agent 首次尝试就能正确选择并调用工具。

查找 1cent

• 官方 MCP Registry：ru.maxzoa/1cent；
• Glama 远程连接器：https://glama.ai/mcp/connectors/ru.maxzoa/1cent；
• Smithery：https://smithery.ai/servers/maxzoa27/onecent；
• MCP.so：https://mcp.so/servers/1cent；
• LobeHub：https://lobehub.com/mcp/maxzoa-1cent。
• MCPServers.org：https://mcpservers.org/ru/servers/maxzoa/1cent。

Glama 发布验证使用仓库的 onecent-glama stdio 入口点。它会加载与生产环境相同的 MCP 工具注册表以检查架构；它不会绕过支付，也不会为付费 URL 操作提供第二种实现。

目录状态会在市场质量报告中通过带日期的证据进行检查。页面仅返回 HTTP 200 不算成功收录：页面还必须可搜索、内容为最新且可安装。

买家配置从无需付款的诊断开始：

onecent doctor

生成或安装不含密钥的 MCP 客户端配置：

onecent install --client claude
onecent install --client cursor --apply
onecent install --client vscode --apply
onecent install --client codex

对于不支持原生 x402 签名的 MCP 客户端，请安装本地 Buyer Bridge：

pipx install "onecent[buyer]==0.8.1"
onecent wallet set
onecent bridge

默认采用手动逐次批准，且没有商业每日配额。买家密钥保存在操作系统密钥环中；1cent、远程 MCP 和目录服务都不会收到该密钥。UNKNOWN 结果绝不会重试。Claude、Cursor、VS Code 和 Codex 的配置请参阅 Buyer Bridge。

直接使用 CLI 时，除非买家明确提供最高金额、确认 Base Mainnet 并输入单次调用确认，否则 CLI 也会拒绝付费调用。请参阅 examples/buyer-python 和 examples/buyer-node。

Node 买家可以安装公开发布的软件包：

npm install --global [email protected]
onecent-buyer doctor

软件包源代码仍可在 packages/onecent-buyer 中获取。注册表页面：PyPI onecent 0.8.1 和 npm onecent-buyer 0.8.1。

有限批处理工具接受 1 到 5 个不同的公开 URL。其 x402 报价为实时单价乘以通过验证的 URL 数量，并且会在开始获取任何 URL 之前确定。结果保留输入顺序，并采用明确的部分失败约定；UNKNOWN 支付绝不会重试。

产品分母涵盖计划中、受外部因素阻碍以及不安全的结果，详见 WEB_INTELLIGENCE_COVERAGE_MATRIX.md，其中提供 JSON 和 CSV 格式。

onecent watch 提供有限且有上限的变更监控。该功能默认禁用，要求明确确认 Base 网络、资产和卖家；遇到 UNKNOWN 时会停止，不会发起新的付款尝试。

PostgreSQL 是工具可用性和 Base USDC 原子价格的运行时数据源。配置值仅作为干净安装时的回退值。只有支付检查成功后，才会开始付费 URL 处理。

安全约定

• 仅允许公开 HTTP/HTTPS；私有、环回、链路本地和重新绑定目标均会被拒绝；
• 输入架构严格；拒绝未知字段；
• 对重定向、响应正文、提取文本、并发数和队列深度设定上限；
• 使用支付标识符、请求指纹和幂等重放保护；
• UNKNOWN 结算结果绝不会自动重试；
• 服务端不使用卖家私钥、买家密钥、Docker 套接字或 JavaScript 执行；
• 远程 MCP 已启用 Streamable HTTP 主机/来源保护。
• 可选的已签名 x402 报价和结算收据使用专用的 Ed25519 did:web 密钥；它们绝不会暴露或重复使用买家或卖家私钥。

本地质量检查

python -m venv .venv
.venv/Scripts/pip install --require-hashes -r requirements-dev.lock
.venv/Scripts/pip install --no-deps -e .
ruff check .
mypy
pytest -q
python scripts/validate_release.py
docker compose --env-file .env.example config
docker compose --env-file .env.example build
pip-audit --no-deps -r requirements.lock --progress-spinner off

本地启动 Docker

将 .env.example 复制为 .env，替换占位符，保留 X402_ENVIRONMENT=testnet 和 X402_NETWORK=eip155:84532，然后运行：

docker compose up -d --build
docker compose ps

容器 UID/GID：10001:10001。无需将可写目录绑定挂载到主机。此本地示例特意使用测试网。启用生产主网需要所有者批准、最新的 PostgreSQL 备份、生产预检、禁用开发绕过以及做好回滚准备。

文档

• 当前生产状态
• 文档索引
• 公共 REST API
• 远程 MCP 服务
• 买家快速入门
• 本地 MCP 买家桥接
• 安全策略
• 版本历史
• 市场质量报告
• 扩展与信任门槛
• 生产运维
• 事件响应

依据 Apache-2.0 许可。请参阅 LICENSE 和 NOTICE。