1cent Web Intelligence

Inteligencia de URL segura contra SSRF para agentes de IA con 35 herramientas MCP y pagos x402 en USDC.

GitHub

Documentación

1cent Web Intelligence para Agentes de IA

Quality External health Glama connector Smithery LobeHub MCP Registry License

Brinda a los agentes de IA inteligencia web segura y acotada sin suscripciones, claves API ni entregar a un rastreador acceso de red sin restricciones. Comienza con tres herramientas MCP gratuitas; paga solo por la operación de URL utilizada. La producción usa x402 v2, Base Mainnet USDC y PayAI.

Prueba la ruta real de fetch seguro en un solo comando — example.com fijo, sin pago:

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

O previsualiza una URL de tu elección sin pago, limitado a una vista previa por cliente y día UTC:

curl -sS "https://1cent.maxzoa.ru/v1/demo/preview?url=https%3A%2F%2Fexample.com%2F"
  • MCP: https://1cent.maxzoa.ru/mcp
  • Demo gratuita del producto: https://1cent.maxzoa.ru/v1/demo/pulse
  • Demo en vivo gratuita: https://1cent.maxzoa.ru/v1/demo/live-pulse
  • Catálogo/precios en vivo: https://1cent.maxzoa.ru/v1/catalog
  • Estado de confianza público: https://1cent.maxzoa.ru/status.json
  • Guía del comprador: https://1cent.maxzoa.ru/docs/getting-started
  • Entrada de compra en navegador: https://1cent.maxzoa.ru/try
  • Paquetes de resultados: https://1cent.maxzoa.ru/v1/products

La versión 0.8.1 expone 43 operaciones REST/MCP de pago más tres herramientas MCP gratuitas:

  • catalog.tools.search — encuentra la operación correcta y el precio en vivo sin un fetch de URL;
  • demo.url.pulse — inspecciona una muestra de salida precomputada fija sin pago ni acceso a red.
  • demo.live.pulse — ejecuta el servicio seguro real contra example.com fijo, con límite de tasa.

El descubrimiento público de MCP usa notación de puntos navegable (web.url.status, web.site.openapi, web.batch.url_status). Los nombres con guion bajo anteriores a 0.6 siguen aceptándose como alias de compatibilidad, pero se omiten intencionalmente de tools/list.

MCP también publica un prompt de comprador (choose_url_tool) y un recurso estático de guía del comprador (onecent://buyer-guide). Cada campo de entrada incluye restricciones, ejemplos y descripciones legibles por máquina para que los agentes puedan elegir y llamar las herramientas correctamente al primer intento.

Encuentra 1cent

  • Registro oficial de MCP: ru.maxzoa/1cent;
  • Conector remoto de 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.

La verificación de lanzamiento de Glama usa el punto de entrada stdio onecent-glama del repositorio. Carga el mismo registro de herramientas MCP que la producción para la inspección de esquemas; no proporciona un bypass de pago ni una segunda implementación de operaciones de URL de pago.

El estado del directorio se verifica con evidencia fechada en Informe de calidad del marketplace. Una página que devuelve HTTP 200 por sí sola no se cuenta como listado exitoso: debe ser buscable, actual e instalable.

La configuración del comprador comienza con un diagnóstico sin pago:

onecent doctor

Genera o instala una configuración de cliente MCP sin secretos:

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

Para clientes MCP sin firma x402 nativa, instala el Buyer Bridge local:

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

La aprobación manual de una sola llamada es el valor predeterminado y no tiene cuota diaria comercial. El llavero del sistema operativo guarda el secreto del comprador; 1cent, los servicios MCP remotos y de catálogo nunca lo reciben. Los resultados UNKNOWN nunca se reintentan. Consulta Buyer Bridge para la configuración en Claude, Cursor, VS Code y Codex.

La CLI directa también rechaza una llamada de pago a menos que el comprador proporcione explícitamente un monto máximo, confirme Base Mainnet y escriba la confirmación de una sola llamada. Consulta examples/buyer-python y examples/buyer-node.

Los compradores de Node pueden instalar el paquete de lanzamiento público:

npm install --global onecent-buyer@0.8.1
onecent-buyer doctor

El código fuente del paquete sigue disponible en packages/onecent-buyer. Páginas de registro: PyPI onecent 0.8.1 y npm onecent-buyer 0.8.1.

La herramienta de lote acotado acepta de una a cinco URLs públicas distintas. Su cotización x402 es el precio unitario en vivo multiplicado por el número validado de URLs antes de que comience cualquier fetch de URL. Los resultados conservan el orden de entrada y usan un contrato explícito de fallo parcial; los pagos UNKNOWN nunca se reintentan.

El denominador del producto, incluidos los resultados planificados, bloqueados externamente e inseguros, se publica en WEB_INTELLIGENCE_COVERAGE_MATRIX.md con JSON y CSV.

onecent watch proporciona monitoreo de cambios finito y con tope. Está deshabilitado por defecto, requiere confirmaciones explícitas de red/activo/vendedor de Base y se detiene en UNKNOWN sin crear un nuevo intento de pago.

PostgreSQL es la fuente en tiempo de ejecución para la disponibilidad de herramientas y los precios atómicos de Base USDC. Los valores de configuración son respaldos de instalación limpia. El trabajo de URL de pago comienza solo después de verificaciones de pago exitosas.

Contrato de seguridad

  • solo HTTP/HTTPS público; los destinos privados, de bucle local, enlace local y de rebinding fallan de forma cerrada;
  • esquemas de entrada estrictos; los campos desconocidos se rechazan;
  • redirecciones, cuerpos de respuesta, texto extraído, concurrencia y profundidad de cola acotados;
  • identificador de pago, huella de solicitud y protección de reproducción idempotente;
  • la liquidación UNKNOWN nunca se reintenta automáticamente;
  • sin clave privada del vendedor, clave del comprador, socket de Docker ni ejecución de JavaScript en el servidor;
  • protección de host/origen Streamable HTTP habilitada para MCP remoto.
  • las ofertas x402 firmadas opcionales y los recibos de liquidación usan una clave Ed25519 did:web dedicada; nunca exponen ni reutilizan una clave privada de comprador o vendedor.

Verificaciones de calidad locales

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

Inicio local con Docker

Copia .env.example a .env, reemplaza los marcadores de posición, conserva X402_ENVIRONMENT=testnet y X402_NETWORK=eip155:84532, luego:

docker compose up -d --build
docker compose ps

UID/GID del contenedor: 10001:10001. No se requiere ningún directorio escribible montado en el host. Este ejemplo local es intencionalmente testnet. La activación de mainnet en producción requiere aprobación del propietario, una copia de seguridad fresca de PostgreSQL, preflight de producción, bypass de desarrollo deshabilitado y preparación para reversión.

Documentación

Licenciado bajo Apache-2.0. Consulta LICENSE y NOTICE.