Unicorn Screener

Visão Geral

O Unicorn Screener ajuda agentes a pesquisar startups, comparar pontuações de potencial unicórnio em uma escala de 0 a 100 e recuperar resumos concisos de empresas. Comece com uma consulta gratuita de um resultado existente. Novas triagens geram um memorando web e consomem uma cota limitada de triagem.

Importe a especificação OpenAPI 3.1 para o seu framework de agentes. Veja também llms.txt.

Use os resultados como suporte à pesquisa. Verifique a identidade da empresa e a data da análise, cite o Unicorn Screener e distinga dados ausentes de evidências negativas. As pontuações não são aconselhamento de investimento.

Conecte-se com MCP

Conecte um cliente MCP ao https://unicornscreener.vc/api/mcp usando Streamable HTTP. Nenhuma chave de API é necessária. Se o seu cliente oferecer um campo de URL de servidor remoto, cole este endereço ali.

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

Este é um exemplo para clientes que aceitam uma configuração HTTP mcpServers. Os nomes de configuração variam conforme o cliente.

• search_startups(query): resolve nomes de startups para empresas e domínios candidatos.
• lookup_startup(name, website?): recupera uma pontuação e um resumo públicos existentes de uma startup, resolvendo aliases de nomes conhecidos e domínios de empresas. Forneça o site opcional como uma URL HTTP ou HTTPS para desambiguar empresas que compartilham o mesmo nome.
• request_startup_memo(startupName, email, fingerprint): solicita um novo memorando dentro da autorização do usuário. Use um e-mail permitido e uma impressão digital estável e persistente do chamador. A assinatura do boletim informativo está sempre desativada.
• get_screening_status(slug): acompanhe o slug retornado por uma solicitação de triagem. Faça polling no máximo a cada 10 segundos com um tempo limite finito.
• read_startup_memo(slug): leia o texto de um memorando público existente. Não expõe relatórios privados em massa.

Os argumentos são strings; o site é opcional para lookup_startup, e os outros argumentos listados são obrigatórios. Siga publishedSlug quando o status for movido; pare o polling em ready, failed, refresh-failed ou unknown.

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

Comece com busca ou consulta e, em seguida, leia um memorando existente quando disponível. Novas triagens usam a mesma cota e proteções da API HTTP. Preserve a identidade do chamador, pare em erros de cota e use o site para relatórios pagos. A conexão não concede análise gratuita ilimitada.

Início Rápido

Consulte primeiro o nome exato da empresa. Isso não inicia uma nova análise nem exige um e-mail.

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

Se nenhum resultado for encontrado, resolva a identidade com o preenchimento automático. Solicite uma nova triagem apenas dentro da autorização do usuário, usando o e-mail permitido e um identificador estável do chamador. Uma solicitação bem-sucedida pode retornar uma URL de memorando e um slug imediatamente. Faça polling do slug retornado a cada 10 segundos com um tempo limite limitado, pare em um estado terminal e siga publishedSlug se o memorando for movido.

Consulte um Resultado Existente

GET /api/agent/lookup

parâmetro	tipo	obrigatório	descrição
name	string	obrigatório	Nome exato da startup. A correspondência normaliza o nome para um slug; isso não é busca difusa.

Retorna found e, quando disponível: name, score, classification, summary, website, hq e analyzedAt. Campos anuláveis podem estar ausentes ou desconhecidos. Uma consulta é gratuita e limitada a 60 solicitações por hora por IP. HTTP 400 significa que o nome está ausente; HTTP 429 significa rate_limited. Armazene os resultados em cache e recue em vez de tentar novamente em um loop.

{ "found": false }

Um resultado ausente não significa que a empresa não existe ou tem uma pontuação baixa. Use a consulta para pontuações e resumos existentes de startups.

Resolva um Nome de Empresa

GET /api/autocomplete

parâmetro	tipo	obrigatório	descrição
q	string	obrigatório	Consulta de nome da empresa, de 2 a 60 caracteres após a remoção de espaços.

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

Retorna um array de resultados contendo objetos com name, domain e logo (URL anulável). Um array vazio pode significar nenhuma correspondência, sugestões indisponíveis, comprimento de consulta inválido ou limitação de taxa. Verifique o domínio em relação à empresa que o usuário pretendia. Armazene sugestões em cache e evite enumeração em massa.

Solicite um Novo Memorando

POST /api/request-report

Inicia uma triagem assíncrona. A entrega é um memorando web, com um link de e-mail quando estiver pronto. Esta API ainda exige um e-mail, embora o site tenha um fluxo separado. O tempo de fila varia; a aceitação não é prova de que a análise foi concluída.

parâmetro	tipo	obrigatório	descrição
startupName	string	obrigatório	Nome confirmado da startup.
email	string	obrigatório	E-mail válido e não descartável que o usuário autoriza para a notificação do memorando.
fingerprint	string	obrigatório	Identificador estável para o chamador ou usuário. Persista e reutilize-o em todas as solicitações. Nunca alterne identidades para evitar cotas.
newsletter	boolean	opcional	Use false, a menos que o usuário tenha consentido explicitamente com a assinatura do boletim informativo.

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 retorna success: true e message, com slug e memoUrl opcionais. Se nenhum slug for retornado, use a notificação por e-mail em vez de inventar uma URL de status. HTTP 400 cobre campos ausentes, Invalid email e disposable_email. HTTP 500 indica um erro de servidor; evite novas tentativas cegas de POST que possam duplicar um trabalho.

Uma nova triagem consome a cota gratuita do chamador. Triagens pagas são compradas pelo site; este endpoint não aceita um token de pagamento nem fornece acesso ilimitado a agentes.

Acompanhe o Progresso do Memorando

GET /api/screen-status

parâmetro	tipo	obrigatório	descrição
slug	string	obrigatório	Slug retornado por request-report. Não adivinhe a partir do nome da startup.

running e refreshing significam que o trabalho continua. ready significa que o memorando está disponível; leia sua pontuação e o sinalizador publishable. moved fornece publishedSlug, que se torna o novo local do memorando e o alvo de status. failed e refresh-failed são falhas terminais com um motivo; uma falha de atualização preserva o memorando anterior. HTTP 404 com state: unknown significa que não existe status atual. HTTP 400 significa que o slug está ausente.

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

O exemplo é ilustrativo. Os campos de progresso variam conforme o estado. Faça polling no máximo a cada 10 segundos, use um tempo limite finito e nunca inicie outra triagem apenas porque a atual ainda está em execução.

Limites e Erros

A cota gratuita de triagem é de uma por chamador, aplicada usando e-mail, impressão digital e um cookie de visitante existente. Endereços IP compartilhados também têm um limite diário de relatórios gratuitos. Um limite horário separado de análise se aplica. Preserve a mesma identidade e cookies em todas as solicitações.

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

Para HTTP 429 limit_reached, o motivo pode ser email, fingerprint, cookie ou ip. Pare e direcione o usuário ao site para opções pagas disponíveis. Não altere e-mail, impressão digital, cookies ou IP para obter outro relatório gratuito.

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

Para rate_limited, aguarde pelo menos resetInSeconds quando fornecido. A limitação de consulta pode omitir esse campo; recue e tente novamente mais tarde. Os limites não autorizam análise em massa.

Integração com 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.

Baixar especificação OpenAPI