agentes.ai para desarrolladores

agentes.ai API

API REST pública, sin autenticación para lectura. Base URL: https://www.agentes.ai/api (proxy a https://nz0piekbg3.execute-api.eu-central-1.amazonaws.com/dev).

• GET /agencies — listar agencias con filtros q, category, department, premium, limit
• POST /agencies/{agencyId}/click — registrar click outbound (beacon)
• GET /news, GET /blog, GET /blog/{slug}, GET /reviews, GET /reviews/{slug}

Paginación por cursor (cursor base64), cache 120s, CORS abierto.

OpenAPI & Swagger — agentes.ai

Especificación OpenAPI 3.0 para que agentes descubran la superficie de la API automáticamente.

• agentes.ai OpenAPI JSON — /openapi.json
• agentes.ai OpenAPI YAML — /openapi.yaml
• agentes.ai API OpenAPI (via API) — /api/openapi.json (alias)

Valida con Swagger UI o Redoc. Ejemplo: curl https://www.agentes.ai/openapi.json | jq .info.title debe devolver agentes.ai API.

Autenticación — agentes.ai

Lectura es pública (sin auth). Escritura y admin requieren Cognito JWT (Authorization: Bearer <idToken>).

• User Pool: eu-central-1_alYnqJ91K — dominio: agentesai.auth.eu-central-1.amazoncognito.com
• Flujo: Hosted UI → /dashboard → fetchAuthSession().tokens.idToken
• Admin: solo `joinsito@gmail.com` (ver `admin_guard`).

Webhooks — agentes.ai

• POST /stripe_hook — Stripe Checkout → activa agencia, verifica firma Stripe-Signature con whsec_....
• POST /telegram/webhook — Telegram Bot → notifica admin y dispara workers de blog/review.
• Origen CloudFront: /api/* hace proxy a API Gateway (/dev).

MCP Server — agentes.ai

Servidor MCP para que agentes consulten el directorio sin scraping.

• Endpoint MCP (SSE): https://www.agentes.ai/mcp/sse (próximamente — ver roadmap)
• Manifiesto: https://www.agentes.ai/.well-known/mcp.json
• Tools: search_agencies, get_agency, list_blog_posts, get_review

Mientras se publica el MCP, usa la API REST directa con OpenAPI. El manifiesto .well-known ya está disponible para discovery.

Descubrimiento para agentes

• Sitemap: https://www.agentes.ai/sitemap.xml
• LLMs: https://www.agentes.ai/llms.txt y /llms-full.txt
• OpenAPI: https://www.agentes.ai/openapi.json
• Salud: GET https://www.agentes.ai/api/agencies?limit=1 debe devolver 200.