# Trendara: API y MCP

Radar de tendencias en español para México, Colombia y Argentina. Sólo datos agregados públicos.

## Acceso
Llave por organización en `Authorization: Bearer <llave>`. Se obtiene al contratar un plan en https://trendara.app/precios (se ve una vez al pagar y se rota en el panel).
Límite: 60 llamadas por minuto por llave (429 con `Retry-After` al pasarlo). Las llaves caducan a los 12 meses.

## MCP
- Endpoint (Streamable HTTP): `https://trendara.app/api/mcp`
- `claude mcp add --transport http trendara https://trendara.app/api/mcp --header "Authorization: Bearer <llave>"`
- `trends_list`: Lo que sube por red, país, idioma, sector y tipo, ordenado por velocidad, con fuente, fecha y avisos.
- `trends_for_brand`: Tendencias filtradas por sector, país y red de una marca y ordenadas por las palabras de su ADN. No juzga si le sirven.

## API REST
- `GET /api/v1/trends`: filtros `red`, `pais`, `idioma`, `sector`, `tipo`, `desde` (ISO 8601), `limite` (1–100).
- `GET /api/v1/trends/for-brand`: los mismos, más `adn` (palabras de la marca; sólo ordenan).
- `GET /api/muestra?pais=MX`: muestra pública sin llave.
- `GET /api/health`: estado del servicio y de cada fuente.
- OpenAPI: https://trendara.app/openapi.json

## Cada resultado
`titulo`, `tipo`, `red`, `pais`, `sector`, `puntuacion` (0–100) y `explicacion` («subió 6 lugares en 5 h; aparece en MX y CO»),
`fuente` (nombre, URL y fecha de publicación) y `avisos`. En audios, `usableComercial` (si, no o desconocido); en noticias,
`verificacion` (reportado o confirmado). La respuesta trae además `fuentes` (caídas o viejas) y avisos generales.

## Ejemplo
```
curl -H "Authorization: Bearer $TRENDARA_API_KEY" "https://trendara.app/api/v1/trends?pais=MX&tipo=busqueda&limite=5"
```