1cent Web Intelligence

Inteligência de URL segura contra SSRF para agentes de IA com 35 ferramentas MCP e pagamentos em x402 USDC.

GitHub

Documentação

1cent Web Intelligence para Agentes de IA

Quality External health Glama connector Smithery LobeHub MCP Registry License

Dê aos agentes de IA inteligência web segura e limitada, sem assinaturas, chaves de API ou entrega de um crawler com acesso irrestrito à rede. Comece com três ferramentas MCP gratuitas; pague apenas pela operação de URL utilizada. A produção usa x402 v2, Base Mainnet USDC e PayAI.

Experimente o caminho real de busca segura em um único comando — fixo example.com, sem pagamento:

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

Ou pré-visualize uma URL de sua escolha sem pagamento, limitado a uma pré-visualização por cliente e dia UTC:

curl -sS "https://1cent.maxzoa.ru/v1/demo/preview?url=https%3A%2F%2Fexample.com%2F"
  • MCP: https://1cent.maxzoa.ru/mcp
  • Demonstração gratuita do produto: https://1cent.maxzoa.ru/v1/demo/pulse
  • Demonstração ao vivo gratuita: https://1cent.maxzoa.ru/v1/demo/live-pulse
  • Catálogo/preços ao vivo: https://1cent.maxzoa.ru/v1/catalog
  • Status público de confiança: https://1cent.maxzoa.ru/status.json
  • Guia do comprador: https://1cent.maxzoa.ru/docs/getting-started
  • Entrada de compra no navegador: https://1cent.maxzoa.ru/try
  • Pacotes de resultados: https://1cent.maxzoa.ru/v1/products

A versão 0.8.1 expõe 43 operações REST/MCP pagas, além de três ferramentas MCP gratuitas:

  • catalog.tools.search — encontre a operação correta e o preço ao vivo sem buscar uma URL;
  • demo.url.pulse — inspecione uma amostra de saída pré-computada fixa sem pagamento ou acesso à rede.
  • demo.live.pulse — execute o serviço seguro real contra example.com fixo, com limite de taxa.

A descoberta pública de MCP usa notação de pontos navegável (web.url.status, web.site.openapi, web.batch.url_status). Nomes com sublinhado anteriores à versão 0.6 permanecem aceitos como aliases de compatibilidade, mas são intencionalmente omitidos de tools/list.

O MCP também publica um prompt de comprador (choose_url_tool) e um recurso estático de guia do comprador (onecent://buyer-guide). Cada campo de entrada inclui restrições, exemplos e descrições legíveis por máquina, para que os agentes possam escolher e chamar as ferramentas corretamente na primeira tentativa.

Encontre o 1cent

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

A verificação de versão do Glama usa o ponto de entrada stdio onecent-glama do repositório. Ele carrega o mesmo registro de ferramentas MCP da produção para inspeção de esquema; não fornece uma forma de contornar o pagamento nem uma segunda implementação das operações de URL pagas.

O status no diretório é verificado com evidências datadas no Relatório de qualidade do marketplace. Uma página que retorna HTTP 200 sozinha não é considerada uma listagem bem-sucedida: ela deve ser pesquisável, atual e instalável.

A configuração do comprador começa com um diagnóstico sem pagamento:

onecent doctor

Gere ou instale uma configuração de cliente MCP sem segredos:

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

Para clientes MCP sem assinatura nativa x402, instale o Buyer Bridge local:

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

A aprovação manual de uma única chamada é o padrão e não tem cota comercial diária. O chaveiro do sistema operacional guarda o segredo do comprador; o 1cent, o MCP remoto e os serviços de catálogo nunca o recebem. Resultados UNKNOWN nunca são repetidos. Consulte Buyer Bridge para configuração no Claude, Cursor, VS Code e Codex.

A CLI direta também recusa uma chamada paga, a menos que o comprador forneça explicitamente um valor máximo, confirme a Base Mainnet e digite a confirmação de chamada única. Consulte examples/buyer-python e examples/buyer-node.

Compradores Node podem instalar o pacote de versão pública:

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

O código-fonte do pacote permanece disponível em packages/onecent-buyer. Páginas de registro: PyPI onecent 0.8.1 e npm onecent-buyer 0.8.1.

A ferramenta de lote limitado aceita de uma a cinco URLs públicas distintas. Sua cotação x402 é o preço unitário ao vivo multiplicado pela contagem validada de URLs antes do início de qualquer busca de URL. Os resultados mantêm a ordem de entrada e usam um contrato explícito de falha parcial; pagamentos UNKNOWN nunca são repetidos.

O denominador do produto, incluindo resultados planejados, bloqueados externamente e inseguros, é publicado em WEB_INTELLIGENCE_COVERAGE_MATRIX.md com JSON e CSV.

onecent watch fornece monitoramento de mudanças finito e limitado. Ele fica desabilitado por padrão, exige confirmações explícitas de rede/ativo/vendedor da Base e para em UNKNOWN sem criar uma nova tentativa de pagamento.

PostgreSQL é a fonte em tempo de execução para disponibilidade de ferramentas e preços atômicos de USDC na Base. Os valores de configuração são fallbacks de instalação limpa. O trabalho pago de URL começa somente após verificações de pagamento bem-sucedidas.

Contrato de segurança

  • apenas HTTP/HTTPS público; destinos privados, loopback, link-local e de rebinding falham de forma fechada;
  • esquemas de entrada estritos; campos desconhecidos rejeitados;
  • redirecionamentos, corpos de resposta, texto extraído, concorrência e profundidade de fila limitados;
  • identificador de pagamento, impressão digital de solicitação e proteção de repetição idempotente;
  • liquidação UNKNOWN nunca repetida automaticamente;
  • sem chave privada do vendedor, chave do comprador, socket Docker ou execução de JavaScript no servidor;
  • proteção de host/origem Streamable HTTP habilitada para MCP remoto.
  • ofertas x402 assinadas opcionais e recibos de liquidação usam uma chave Ed25519 did:web dedicada; eles nunca expõem ou reutilizam uma chave privada de comprador ou vendedor.

Verificações locais de qualidade

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

Início local com Docker

Copie .env.example para .env, substitua os espaços reservados, mantenha X402_ENVIRONMENT=testnet e X402_NETWORK=eip155:84532, depois:

docker compose up -d --build
docker compose ps

UID/GID do contêiner: 10001:10001. Nenhum diretório gravável montado no host é necessário. Este exemplo local é intencionalmente testnet. A ativação da mainnet de produção exige aprovação do proprietário, um backup novo do PostgreSQL, pré-verificação de produção, bypass de desenvolvimento desabilitado e prontidão para rollback.

Documentação

Licenciado sob Apache-2.0. Consulte LICENSE e NOTICE.