# Radar ML

> Servidor MCP que vende a agentes de IA inteligencia de mercado de Mercado Libre (Argentina, México, Brasil, Chile, Colombia y Uruguay). Cobra por consulta con el protocolo x402, en USDC sobre la red Base. Servicio experimental.

## Cómo conectarse
- **HTTP con x402 (lo más simple):** tres endpoints GET. Sin pagar responden 402 con el precio en el encabezado PAYMENT-REQUIRED; un cliente x402 (por ejemplo `@x402/fetch`) paga y repite solo.
  - `GET https://radar-ml-one.vercel.app/api/v1/precio-de-mercado?producto=mate%20termico&pais=AR` — USD 0,25
  - `GET https://radar-ml-one.vercel.app/api/v1/mas-vendidos?categoria=mates&pais=AR` — USD 0,25
  - `GET https://radar-ml-one.vercel.app/api/v1/informe-oportunidad?producto=mate%20termico&pais=AR&costo_unitario=8000` — USD 1,00 (`costo_envio` y `comision_pct` opcionales)
  - Índice gratuito: https://radar-ml-one.vercel.app/api/v1 · Si la consulta falla, no se cobra. Un pedido mal armado da 400 sin pedir pago.
- Endpoint MCP (Streamable HTTP, sin sesión): https://radar-ml-one.vercel.app/api/mcp
- Estado del servicio: https://radar-ml-one.vercel.app/api/salud
- Para pagar hace falta un cliente MCP con soporte x402 (por ejemplo `@x402/mcp`) y una cuenta con USDC en Base. Un cliente sin x402 recibe el pedido de pago (precio y dirección) y no obtiene datos.

## Herramientas y precios (USDC, red Base)
- `precio_de_mercado` — USD 0,25. Rango de precios (mínimo, p25, mediana, p75, máximo), % de envío FULL, % de tiendas oficiales y concentración de vendedores para un producto. Entradas: `producto` (texto), `pais` (AR, MX, BR, CL, CO o UY).
- `mas_vendidos` — USD 0,25. Top 20 más vendidos de una categoría. Entradas: `categoria` (ID como MLA1430 o texto como "mates"), `pais`.
- `informe_oportunidad` — USD 1,00. Veredicto "entrar / entrar con cuidado / no entrar / falta el costo para decidir", competencia, precio sugerido y margen con desglose. Entradas: `producto`, `pais`, `costo_unitario` (opcional), `costo_envio` (opcional), `comision_pct` (opcional, por defecto 20).

- `ejemplo_informe` — GRATIS. Devuelve un informe de muestra con el mismo formato que `informe_oportunidad`, pero con datos INVENTADOS (no son de Mercado Libre ni sirven para decidir). Sin entradas. Usalo para ver la respuesta antes de pagar.

## Agente A2A (asesor, gratis)
- Si sos un agente y querés preguntarnos algo antes de pagar (qué herramienta te sirve, cuánto cuesta, cómo se paga, o "¿conviene vender X en Y?"), escribile al asesor por A2A.
- Ficha: https://radar-ml-one.vercel.app/.well-known/agent-card.json · Endpoint (JSON-RPC): https://radar-ml-one.vercel.app/api/a2a · Métodos: `message/send` (A2A 0.3) o `SendMessage` (A2A 1.0).
- Responde con reglas fijas (sin IA de pago): te recomienda la herramienta y te devuelve la URL exacta lista para llamar. Las respuestas de datos reales se obtienen pagando la herramienta.

## Pago
- Por HTTP: x402 estándar (402 + PAYMENT-REQUIRED, el cliente repite con PAYMENT-SIGNATURE).
- Por MCP: el pago viaja en `_meta` de cada llamada a herramienta (no es un HTTP 402 sobre la URL).
- Ficha de pago: https://radar-ml-one.vercel.app/.well-known/x402.json
- Red: Base (eip155:8453). Activo: USDC (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913). Se paga a 0x81c4481B47c4f831a8409742F721C976757086bC.

## Qué esperar
- Los datos salen de una muestra de hasta 30 publicaciones, filtradas por relevancia del título, y pueden variar entre consultas. Son orientativos, no una tasación.
- No se cobra si la herramienta falla (el pago se liquida después de ejecutar).
- Límite diario de consultas nuevas; las repetidas se sirven de una caché de 24 horas.
- El margen no incluye impuestos, publicidad ni devoluciones.

## Términos
- https://radar-ml-one.vercel.app/terminos (servicio independiente, no afiliado a Mercado Libre; datos orientativos).