Desenvolvedores
API e MCP
Uma chave, duas portas: a API REST v1 para suas ferramentas, o servidor MCP para seus assistentes de IA. Os dois leem as mesmas medições do seu portal - refeitas a cada 3 dias - e não disparam nada: somente leitura é uma escolha, não uma falta.
Sua chave
A chave é gerada no seu portal de gestão (seção « API e MCP »). Ela aparece uma única vez, uma chave ativa por conta - gerar uma nova revoga a antiga. Envie no cabeçalho:
curl https://waseit.net/api/v1/brands \
-H "Authorization: Bearer wa_live_VOTRE_CLE"A API v1, somente leitura
GET /api/v1/mea conta por trás da chave: plano, idioma, número de marcasGET /api/v1/brandssuas marcas monitoradas, com mercado, setor, concorrentes e datas de mediçãoGET /api/v1/brands/:id/snapshots?limit=24o histórico datado de uma marca, do mais recente ao mais antigo, com a URL do relatório público por pontoGET /api/v1/brands/:id/latesta última medição e seu delta frente à anterior (null enquanto houver um único ponto)
Descrição completa para máquinas: openapi.json
O servidor MCP
A mesma conta, falada por um assistente: ChatGPT, Claude ou qualquer cliente MCP pode listar suas marcas, ler a última medição e o histórico. Transporte « Streamable HTTP », autenticação pela mesma chave. Adicione este conector:
{
"mcpServers": {
"waseit": {
"url": "https://waseit.net/api/mcp",
"headers": { "Authorization": "Bearer wa_live_VOTRE_CLE" }
}
}
}Ferramentas expostas: list_brands, get_latest_measurement(brand), get_score_history(brand, limit). As marcas são endereçadas pelo nome.
O que a API não vai fazer
- Disparar uma medição: as medições chegam pela cadência de 3 dias, a API as lê. Uma API de escrita seria uma superfície de abuso antes de ser um serviço.
- Dar um número que o portal não tem: a API expõe os snapshots que o produto fabrica, nunca um cálculo paralelo que possa divergir.
- Prometer uma posição: cada resposta é uma medição datada - essa é toda a tese.