Saltar al contenido
Another Vector

Documentación

API pública y endpoints para agentes de IA

Todo el contenido de este sitio está disponible en formato legible por máquina: una API JSON de solo lectura, un servidor MCP y un agente A2A. Sin claves, sin registro y sin nada que escribir.

Está publicado porque un asistente que responde a alguien preguntando por proveedores no debería tener que rascar HTML para saber qué hacemos. Los datos se extraen del propio contenido de la web al compilarla, así que dicen exactamente lo mismo que las páginas.

Puntos de entrada

Tres formas de leer lo mismo.

Elige según lo que sepa hablar tu cliente. El contenido es el mismo en las tres.

GET /api/v1/

API de contenido

HTTP + JSON

Servicios, sectores, cobertura geográfica, artículos, preguntas frecuentes e índice de páginas. Ficheros estáticos, sin estado.

Empieza por /api/v1/index.json, o pide /api/v1/bundle.json para llevártelo todo en una sola petición.

POST /mcp

Servidor MCP

Model Context Protocol, transporte Streamable HTTP

Siete herramientas de solo lectura: buscar, listar y consultar servicios y sectores, buscar en las preguntas frecuentes y orientar sobre el encaje de una empresa.

Envía un initialize por JSON-RPC. La tarjeta del servidor está en /.well-known/mcp/server-card.json.

POST /a2a

Agente A2A

Agent2Agent, JSON-RPC

Responde preguntas en lenguaje natural sobre la empresa, devolviendo siempre la URL de origen de cada fragmento.

Usa message/send. La tarjeta del agente está en /.well-known/agent-card.json.

Ejemplos

Copiar, pegar, ejecutar.

API de contenido

Colecciones y detalle. Cada recurso lleva la URL de su página humana en el campo url.

curl -sS https://anothervector.com/api/v1/services.json
curl -sS https://anothervector.com/api/v1/services/diagnostico-operativo.json
curl -sS https://anothervector.com/api/v1/faqs.json

Servidor MCP

JSON-RPC sobre HTTP. Empieza con initialize si tu cliente lo exige; tools/list funciona directamente.

curl -sS https://anothervector.com/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Agente A2A

Una pregunta en lenguaje natural. Responde con el contenido publicado y la fuente de cada fragmento, sin generar texto nuevo.

curl -sS https://anothervector.com/a2a \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"message/send","params":{"message":{
       "role":"user","parts":[{"kind":"text","text":"¿Cuándo no conviene usar IA?"}]}}}'

Descubrimiento

Dónde está cada cosa.

Ningún agente debería tener que adivinar rutas. Estas son todas las que hay.
RutaQué contiene
/.well-known/api-catalogCatálogo de APIs en formato linkset (RFC 9727).
/.well-known/mcp/server-card.jsonTarjeta del servidor MCP.
/.well-known/agent-card.jsonTarjeta del agente A2A.
/.well-known/ai-catalog.jsonManifiesto ARD de recursos agénticos.
/.well-known/agent-skills/index.jsonSkills publicadas, con su digest.
/llms.txtÍndice curado del sitio para modelos de lenguaje.
/auth.mdCómo se accede. Resumen: sin credenciales.
/api/v1/openapi.jsonEspecificación OpenAPI 3.1 de la API de contenido.

Límites

Lo que esto no hace.

No escribe nada. No hay ninguna operación que cree un contacto, envíe un correo o registre una solicitud. Una herramienta de escritura sin autenticación es un formulario de spam con otro nombre.

No genera texto. El agente A2A devuelve fragmentos publicados con su fuente. Poner un modelo detrás significaría que este endpoint puede afirmar cosas que nadie ha escrito, y eso incluye precios y plazos.

No expone datos de clientes. Solo hay contenido que ya es público en la web. No hay base de datos detrás.

Preguntas frecuentes

Lo que se suele preguntar

¿Hace falta una clave de API o registrarse?
No. Los tres endpoints son públicos y de solo lectura. No hay claves, no hay registro y no hay ningún flujo de autorización que completar. Una petición anónima recibe exactamente la misma respuesta que cualquier otra.
¿Se puede enviar un formulario o crear un contacto desde la API?
No, y es deliberado. Ninguno de los endpoints escribe nada. El formulario de la web lleva casilla de consentimiento, control de frecuencia y protección contra envíos automáticos, y nada de eso se puede reproducir en una llamada de agente. Un agente que quiera iniciar una conversación tiene que llevar a la persona al formulario, no rellenarlo por ella.
¿De dónde salen los datos que devuelve la API?
Del contenido publicado en la propia web. Se extraen en el momento de compilar el sitio, a partir de los datos estructurados que cada página ya emite. Por eso la API no puede describir algo distinto de lo que lee un buscador: es la misma fuente. Cada recurso incluye la URL de su página equivalente.
¿La API da precios o plazos?
No. No se publican precios ni cifras de resultado en ningún endpoint, igual que no se publican en la web. El alcance y las condiciones se cierran hablando con una persona.
¿Qué límite de peticiones hay?
No hay ninguno declarado: se sirven ficheros estáticos y una lectura en memoria, así que el coste por petición es bajo. Si necesitas el catálogo entero, pide /api/v1/bundle.json una vez en lugar de recorrer los recursos uno a uno.
¿Por qué una consultora publica una API de su propia web?
Porque cada vez más consultas sobre proveedores empiezan en un asistente conversacional y no en un buscador. Un modelo que quiere saber qué hace una empresa no debería tener que interpretar HTML de marketing. Y porque una empresa que dice construir sistemas debería poder enseñar los suyos.

Si esto te ha parecido razonable, es más o menos como trabajamos.

Sistemas que se pueden inspeccionar, con los límites escritos antes que las promesas.

Solicitar sesión de encaje