Um agente de IA comprando, em tempo real.
Veja o protocolo IndexAgentic em ação: verificação criptográfica, negociação de preço, geração de PIX e confirmação — tudo em 4 segundos.
—
—
Agent Integration
Como agentes de IA consultam, verificam e transacionam com empresas brasileiras via IndexAgentic.
1. Decisão em 1 request
O jeito mais rápido de descobrir tudo sobre uma empresa: 1 GET ao agent-summary.json (≤ 3KB, assinado, cache 1h).
GET /nodes/{dominio}/agent-summary.json
Exemplo:
curl https://indexagentic.com.br/nodes/3dsuplementos.com.br/agent-summary.json
Retorna: CNPJ, score, seal, veredito (trust/action), MCP endpoint, price range, receipts, merkle root. Tudo o que você precisa decidir antes de recomendar ou comprar.
2. Verificação criptográfica
Cada artefato é assinado com Ed25519. As chaves públicas estão em:
GET /.well-known/jwks.json
GET /nodes/{dominio}/jwks.json
A assinatura no agent-summary.json tem kid que aponta para a chave correta em JWKS. Verificação:
# 1. Baixe o jwks.json e encontre a chave com kid == signature.kid # 2. Canonicalize o payload (remova o campo "signature") # 3. Verifique a assinatura Ed25519 contra o payload canonicalizado
Exemplo em Python:
import json, base64, urllib.request
from nacl.signing import VerifyKey
from nacl.exceptions import BadSignatureError
def b64url_to_bytes(s):
return base64.urlsafe_b64decode(s + "=" * (-len(s) % 4))
# 1. Buscar node + jwks
node = json.load(urllib.request.urlopen(
"https://indexagentic.com.br/nodes/3dsuplementos.com.br/agent-summary.json"))
jwks = json.load(urllib.request.urlopen(
"https://indexagentic.com.br/nodes/3dsuplementos.com.br/jwks.json"))
# 2. Achar chave
kid = node["signature"]["kid"]
key = next(k for k in jwks["keys"] if k["kid"] == kid)
verify_key = VerifyKey(b64url_to_bytes(key["x"]))
# 3. Verificar
signature = node["signature"]
del node["signature"]
payload = json.dumps(node, sort_keys=True, separators=(",", ":")).encode()
try:
verify_key.verify(payload, b64url_to_bytes(signature["proofValue"]))
print("Assinatura válida")
except BadSignatureError:
print("Assinatura inválida")
3. MCP — transacionar com a empresa
Para negociar preço e fechar pedido, use o endpoint MCP por domínio.
POST /mcp/{dominio}
Content-Type: application/json
{"jsonrpc":"2.0","id":1,"method":"tools/list"}
Tools disponíveis
| Tool | O que faz |
|---|---|
verify_entity | Retorna o nó assinado completo da empresa |
list_offerings | Lista ofertas com filtros (preço, categoria, limite) |
check_availability | Verifica preço, estoque e prazo de 1 oferta |
negotiate_price | ⭐ Negocia preço (Pix ≥3 → 10% off, Pix ≥10 → 15%, prazo >5d → +5%) |
create_checkout | ⭐ Gera PIX EMV válido + checkout_url |
Exemplo: negociar preço
curl -X POST https://indexagentic.com.br/mcp/3dsuplementos.com.br -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
"params":{"name":"negotiate_price","arguments":{
"offering_name":"BCAA","qty":3,"payment_rail":"pix"}}}'
Retorna negotiated_unit_price_brl, discount_pct, savings_brl.
Exemplo: gerar PIX
curl -X POST https://indexagentic.com.br/mcp/3dsuplementos.com.br -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
"params":{"name":"create_checkout","arguments":{
"offering_name":"BCAA","qty":3,"payment_rail":"pix",
"negotiated_unit_price_brl":62.91}}}'
Retorna pix_payload (EMV), checkout_url, expires_at (30min).
4. Trust context — "top X% do Brasil"
GET /nodes/{dominio}/trust-context.json
Retorna percentis global, por profile (ecommerce/SaaS/etc.) e por CNAE. Útil para o agente dizer "esta empresa está no top 9% do Brasil".
5. Discovery — links no HTML
A página mestra (/nodes/{dominio}) tem <link rel="alternate"> em todos os artefatos:
<link rel="alternate" type="application/json" href="/nodes/{dominio}/agent-summary.json">
<link rel="alternate" type="application/json" href="/nodes/{dominio}/trust-context.json">
<link rel="mcp-server" href="/nodes/{dominio}/mcp/server-card.json">
6. Códigos de erro
| HTTP | Significado |
|---|---|
| 200 | OK |
| 304 | Not Modified (cache hit via If-Modified-Since) |
| 404 | Domínio não indexado |
| 429 | Rate limit (60 req/min por IP por domínio) |
| 503 | Trust context temporariamente indisponível |
7. Ficha técnica
| Protocolo | MCP 2025-06-18 (JSON-RPC 2.0) |
| Assinatura | Ed25519 (verificável em /.well-known/jwks.json) |
| Auth | Nenhuma — público e gratuito |
| Rate limit | 60 req/min por IP por domínio |
| Cache | agent-summary 1h, JWKS 5min (após rotação) ou 24h |
| Tamanho | agent-summary ≤ 3KB |
IndexAgentic v3.0 · Protocolo aberto (MIT) · openapi.json · home