Periskop

Periskop — Descubrimiento de Productos para Agentes de IA

Descubrimiento de productos para agentes de IA. Una sola llamada MCP convierte una intención de compra en lenguaje natural en resultados de productos estructurados y clasificados — mejores opciones, alternativas, paquetes, advertencias, precios y enlaces a comerciantes — de tiendas independientes en la web comercial abierta.

Periskop es un servidor MCP remoto y alojado (código cerrado). Te conectas a través del endpoint HTTPS público con una clave API de Periskop — nada que instalar o ejecutar. Es la capa de descubrimiento para el comercio agéntico: un agente pregunta en lenguaje natural y Periskop devuelve productos clasificados con enlaces de vuelta al comerciante. Se detiene en el descubrimiento — sin pago, sin pagos, sin pedidos.

• Sitio web: https://periskop.ai
• Portal para desarrolladores / obtener una clave API: https://periskop.ai/developer
• Documentación: https://periskop.ai/developer/docs
• Endpoint MCP: https://mcp.periskop.ai/v1/mcp (HTTP Streamable, JSON-RPC 2.0)

Para quién es

Cualquier producto que necesite convertir intención en resultados de productos confiables sin gestionar el pago — plataformas y orquestadores de agentes, plataformas de trabajo con IA, asistentes de compras con IA, agentes de navegador, copilotos de comercio, sistemas de recomendación, flujos de adquisición y abastecimiento B2B, monitores de precios y ofertas, bots de reposición/reorden, aplicaciones de regalos, flujos de reventa y arbitraje, y herramientas de compras accesibles. Concretamente: un agente que planifica un viaje de campamento y devuelve el equipo, un copiloto de adquisiciones que compara opciones entre proveedores, o un asistente de voz que muestra el producto correcto a partir de una sola frase.

Qué hace (y qué no hace)

Periskop devuelve resultados de productos y enlaces a comerciantes únicamente. No completa el pago, no crea carritos en el comerciante, no procesa pagos, no reserva inventario ni compra artículos. El usuario siempre completa cualquier compra en el sitio web del propio comerciante. Cada respuesta incluye un bloque purchase_boundary que reitera esto.

Conexión

Endpoint	https://mcp.periskop.ai/v1/mcp
Transporte	HTTP Streamable — JSON-RPC 2.0 sobre HTTP POST (una respuesta JSON por POST; sin SSE)
Protocolo de red	2024-11-05
Autenticación	Authorization: Bearer <YOUR_PERISKOP_API_KEY> (las claves se ven como dp_…)
Obtener una clave	https://periskop.ai/developer

Las solicitudes no autenticadas reciben 401 con un encabezado WWW-Authenticate: Bearer.

Nota: Periskop también admite OAuth 2.1 (Código de Autorización + PKCE) para hosts que lo prefieran (los tokens se ven como dpo_…). La clave API es la vía más simple y es todo lo que necesitas para las configuraciones a continuación.

Herramientas

Todas las herramientas aceptan un único argumento de objeto JSON. Los esquemas a continuación son la superficie pública de las herramientas.

run_shopping_discovery

Encuentra, elige, navega, recomienda, obtén el mejor producto o arma un paquete a partir de una solicitud en lenguaje natural. El único campo obligatorio es prompt.

Campo	Tipo	Obligatorio	Notas
prompt	string	✅	Intención de compra en lenguaje natural
mode	string | null		auto | browse | recommend | best | bundle (predeterminado auto)
store	string | null		auto, un id de tienda, o un nombre/pista de tienda
country	string | null		p. ej. PT, ES
currency	string | null		p. ej. EUR
language	string | null		p. ej. en, pt
max_results	integer | null		Límite de productos devueltos
response_format	string | null		full (predeterminado) | simple

get_discovery_result

Recupera un resultado anterior por result_id. Los resultados son temporales y pueden expirar.

Campo	Tipo	Obligatorio
result_id	string	✅
response_format	string | null

discover_supported_stores

Inspecciona las tiendas públicas que Periskop puede usar. Devuelve solo las capacidades de tiendas públicas.

Campo	Tipo	Obligatorio
country	string | null
category	string | null
capability	string | null (search | bundle | product_links)

report_result_feedback

Informa si un resultado fue bueno, malo o mixto.

Campo	Tipo	Obligatorio
result_id	string	✅
rating	string (good | bad | mixed)	✅
reason	string | null
selected_product_id	string | null
freeform_feedback	string | null

suggest_store_coverage

Sugiere una tienda/comerciante/mercado que Periskop debería admitir en el futuro. Sin cargo. No busca ni rastrea la tienda y no garantiza soporte futuro.

Campo	Tipo	Obligatorio
store_name	string	✅
store_url	string | null
country / region / category	string | null
context	string | null (p. ej. unsupported_store, no_match)

Ejemplo

Solicitud (JSON-RPC tools/call)

curl -sS -X POST https://mcp.periskop.ai/v1/mcp \
  -H "Authorization: Bearer YOUR_PERISKOP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "run_shopping_discovery",
      "arguments": { "prompt": "wireless noise-cancelling headphones for travel under 200€", "mode": "best" }
    }
  }'

Respuesta (recortada — datos de muestra/ficticios, no reales)

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"result_id\":\"res_example_8f2a1c\",\"mode_used\":\"best\",\"products\":[{\"title\":\"SampleAudio Aero NC\",\"price\":\"€179.00\",\"currency\":\"EUR\",\"merchant\":\"Example Store\",\"url\":\"https://store.example/p/aero-nc\",\"role\":\"best_pick\"},{\"title\":\"Acme Quietline 2\",\"price\":\"€149.00\",\"currency\":\"EUR\",\"merchant\":\"Example Store\",\"url\":\"https://store.example/p/quietline-2\",\"role\":\"alternative\"}],\"caveats\":[\"Prices and availability may change on the merchant site.\"],\"purchase_boundary\":{\"checkout_created\":false,\"payment_processed\":false,\"stock_reserved\":false,\"user_must_complete_purchase_on_merchant_site\":true}}"
      }
    ]
  }
}

El payload estructurado se devuelve como texto en result.content[0].text. Cada respuesta y el encabezado de respuesta X-Request-ID llevan un id de solicitud por llamada.

Precios (resumen)

Billetera prepagada, se factura solo por solicitudes de descubrimiento exitosas. Errores de autenticación, solicitudes mal formadas, fallos internos/tiempo de ejecución, límites de velocidad y falta de coincidencia total nunca se facturan. Consulta la tarifa vigente en https://periskop.ai/developer/billing.

Configuración del cliente

Configuraciones de copiar y pegar están en config-snippets/: Cursor (.cursor/mcp.json), Claude Desktop, Claude Code y un ejemplo de curl sin procesar.