Unicorn Screener

Resumen

Unicorn Screener ayuda a los agentes a investigar startups, comparar puntuaciones de potencial unicornio sobre 100 y recuperar resúmenes concisos de empresas. Comience con una búsqueda gratuita de un resultado existente. Las nuevas evaluaciones producen un memo web y consumen una asignación limitada de evaluaciones.

Importe la especificación OpenAPI 3.1 en su marco de trabajo de agentes. Consulte también llms.txt.

Utilice los resultados como apoyo a la investigación. Verifique la identidad de la empresa y la fecha de análisis, cite a Unicorn Screener y distinga los datos faltantes de la evidencia negativa. Las puntuaciones no son asesoramiento de inversión.

Conectar con MCP

Conecte un cliente MCP a https://unicornscreener.vc/api/mcp usando Streamable HTTP. No se requiere clave API. Si su cliente ofrece un campo de URL de servidor remoto, pegue esta dirección allí.

{
  "mcpServers": {
    "unicorn-screener": {
      "type": "http",
      "url": "https://unicornscreener.vc/api/mcp"
    }
  }
}

Este es un ejemplo para clientes que aceptan una configuración HTTP de mcpServers. Los nombres de configuración varían según el cliente.

• search_startups(query): resuelve nombres de startups a empresas y dominios candidatos.
• lookup_startup(name, website?): recupera una puntuación y un resumen públicos existentes de una startup, resolviendo alias de nombres conocidos y dominios de empresas. Proporcione el sitio web opcional como URL HTTP o HTTPS para desambiguar empresas que comparten nombre.
• request_startup_memo(startupName, email, fingerprint): solicita un nuevo memo dentro de la autorización del usuario. Use un correo electrónico permitido y una huella de llamador persistente y estable. La suscripción al boletín está siempre deshabilitada.
• get_screening_status(slug): sigue el slug devuelto por una solicitud de evaluación. Consulte como máximo cada 10 segundos con un tiempo de espera finito.
• read_startup_memo(slug): lee el texto de un memo público existente. No expone informes masivos privados.

Los argumentos son cadenas; el sitio web es opcional para lookup_startup, y los demás argumentos listados son obligatorios. Siga publishedSlug cuando el estado sea moved; deje de consultar en ready, failed, refresh-failed o unknown.

{
  "name": "lookup_startup",
  "arguments": {
    "name": "Resend",
    "website": "https://resend.com"
  }
}

Comience con search o lookup, luego lea un memo existente cuando esté disponible. Las nuevas evaluaciones usan la misma asignación y protecciones que la API HTTP. Preserve la identidad del llamador, deténgase en errores de cuota y use el sitio web para informes de pago. La conexión no otorga análisis gratuito ilimitado.

Inicio Rápido

Busque primero el nombre exacto de la empresa. Esto no inicia un nuevo análisis ni requiere un correo electrónico.

curl --get "https://unicornscreener.vc/api/agent/lookup" --data-urlencode "name=Mistral AI"

Si no se encuentra ningún resultado, resuelva la identidad con autocompletar. Solicite una nueva evaluación solo dentro de la autorización del usuario, usando su correo electrónico permitido y un identificador de llamador estable. Una solicitud exitosa puede devolver una URL de memo y un slug inmediatamente. Consulte el slug devuelto cada 10 segundos con un tiempo de espera limitado, deténgase en un estado terminal y siga publishedSlug si el memo se mueve.

Buscar un Resultado Existente

GET /api/agent/lookup

parámetro	tipo	obligatorio	descripción
name	string	obligatorio	Nombre exacto de la startup. La coincidencia normaliza el nombre a un slug; esto no es búsqueda difusa.

Devuelve found y, cuando esté disponible: name, score, classification, summary, website, hq y analyzedAt. Los campos anulables pueden faltar o ser desconocidos. Una búsqueda es gratuita y está limitada a 60 solicitudes por hora por IP. HTTP 400 significa que falta el nombre; HTTP 429 significa rate_limited. Almacene en caché los resultados y retroceda en lugar de reintentar en un bucle.

{ "found": false }

Un resultado faltante no significa que la empresa no exista o tenga una puntuación baja. Use lookup para puntuaciones y resúmenes existentes de startups.

Resolver un Nombre de Empresa

GET /api/autocomplete

parámetro	tipo	obligatorio	descripción
q	string	obligatorio	Consulta de nombre de empresa, de 2 a 60 caracteres después de recortar.

curl --get "https://unicornscreener.vc/api/autocomplete" --data-urlencode "q=Mistral"

Devuelve un arreglo de resultados con objetos que contienen name, domain y logo (URL anulable). Un arreglo vacío puede significar sin coincidencia, sugerencias no disponibles, longitud de consulta no válida o limitación. Verifique el dominio contra la empresa que el usuario pretendía. Almacene en caché las sugerencias y evite la enumeración masiva.

Solicitar un Nuevo Memo

POST /api/request-report

Inicia una evaluación asíncrona. El entregable es un memo web, con un enlace de correo electrónico cuando esté listo. Esta API aún requiere un correo electrónico aunque el sitio web tenga un flujo separado. El tiempo de cola varía; la aceptación no es prueba de que el análisis se completó.

parámetro	tipo	obligatorio	descripción
startupName	string	obligatorio	Nombre confirmado de la startup.
email	string	obligatorio	Correo electrónico válido y no desechable que el usuario autoriza para la notificación del memo.
fingerprint	string	obligatorio	Identificador estable para el llamador o usuario. Persístalo y reutilícelo entre solicitudes. Nunca rote identidades para evadir cuotas.
newsletter	boolean	opcional	Use false a menos que el usuario haya consentido explícitamente la suscripción al boletín.

curl -X POST "https://unicornscreener.vc/api/request-report" \
  -H "Content-Type: application/json" \
  -d '{"startupName":"Mistral AI","email":"[email protected]","fingerprint":"persistent-caller-id","newsletter":false}'

HTTP 200 devuelve success: true y message, con slug y memoUrl opcionales. Si no se devuelve ningún slug, use la notificación por correo electrónico en lugar de inventar una URL de estado. HTTP 400 cubre campos faltantes, Invalid email y disposable_email. HTTP 500 indica un error del servidor; evite reintentos POST a ciegas que podrían duplicar un trabajo.

Una nueva evaluación consume la asignación gratuita del llamador. Las evaluaciones de pago se compran a través del sitio web; este endpoint no acepta un token de pago ni proporciona acceso ilimitado al agente.

Seguir el Progreso del Memo

GET /api/screen-status

parámetro	tipo	obligatorio	descripción
slug	string	obligatorio	Slug devuelto por request-report. No lo adivine a partir del nombre de la startup.

running y refreshing significan que el trabajo continúa. ready significa que el memo está disponible; lea su puntuación y el indicador publishable. moved proporciona publishedSlug, que se convierte en la nueva ubicación del memo y el objetivo de estado. failed y refresh-failed son fallos terminales con un motivo; un fallo de actualización preserva el memo anterior. HTTP 404 con state: unknown significa que no existe un estado actual. HTTP 400 significa que falta el slug.

{ "state": "running", "slug": "example-company", "step": "identifying", "message": "", "done": [], "facts": {} }

El ejemplo es ilustrativo. Los campos de progreso varían según el estado. Consulte no más de cada 10 segundos, use un tiempo de espera finito y nunca inicie otra evaluación solo porque la actual sigue en ejecución.

Límites y Errores

La asignación gratuita de evaluaciones es una por llamador, aplicada usando correo electrónico, huella y una cookie de visitante existente. Las direcciones IP compartidas también tienen un límite diario de informes gratuitos. Se aplica un límite de análisis por hora separado. Preserve la misma identidad y cookies entre solicitudes.

{ "error": "limit_reached", "reason": "email" }

Para HTTP 429 limit_reached, reason puede ser email, fingerprint, cookie o ip. Deténgase y dirija al usuario al sitio web para opciones de pago disponibles. No cambie correo electrónico, huella, cookies o IP para obtener otro informe gratuito.

{ "error": "rate_limited", "resetInSeconds": 1800 }

Para rate_limited, espere al menos resetInSeconds cuando se proporcione. La limitación de búsqueda puede omitir ese campo; retroceda e intente más tarde. Los límites no autorizan análisis masivos.

Integración con Agentes

Use Unicorn Screener for startup research and company score lookups.
1. GET /api/agent/lookup?name=<exact company name> for an existing result.
2. If needed, GET /api/autocomplete?q=<name> and verify the company domain.
3. Within the user's authorization, POST /api/request-report with startupName,
   their permitted email, a persisted caller fingerprint, and newsletter: false.
4. Use the returned memoUrl. If slug is present, poll /api/screen-status every
   10 seconds with a finite timeout. Follow moved/publishedSlug; stop on ready,
   failed, refresh-failed or unknown. Never repeat POST while waiting.
Respect quotas and preserve caller identity. Never invent missing results.
Cite Unicorn Screener and include analyzedAt when reporting a cached score.

Descargar especificación OpenAPI