Datos web

API de preparación para agentes

Audita cómo los sitios web públicos exponen rutas de descubrimiento, contenido útil, política de acceso y capacidades para agentes. La API devuelve una puntuación ponderada de 0 a 100, cuatro puntuaciones dimensionales, evidencias por comprobación, confianza, etiquetas de madurez, advertencias y recomendaciones.

Ver documentación Probar la herramienta gratuita Explorar todas las API

Endpoints Activo

GET /v1/agent-readiness

Solicitud de ejemplo

curl -G -H "X-API-Key: $DOMSCAN_API_KEY" --data-urlencode "url=https://example.com" https://domscan.net/v1/agent-readiness

Respuesta de ejemplo 200 OK

{
  "outcome": "complete",
  "summary": {
    "coverage": "multi_channel",
    "detected_signals": 2,
    "total_signals": 4
  },
  "signals": {
    "webmcp": { "status": "unknown", "validation": "runtime_required" },
    "remote_mcp": { "status": "not_detected" },
    "openapi": { "status": "detected", "validation": "confirmed" },
    "llms_txt": { "status"
...

Solicitud de ejemplo GET /v1/agent-readiness

Características principales 4

Preguntas frecuentes 4

Códigos de estado HTTP 200 / 400 / 401 / 402 / 429 / 502

Categoría Datos web

Endpoints 1

Características principales 4

Preguntas frecuentes 4

Utilizado por personas en estas empresas

Señales de confianza antes de integrar

Documentación transparente, solicitudes autenticadas y detalles visibles de fiabilidad facilitan evaluar DomScan antes de publicar.

En directo Estado del servicio

Consulta el estado del servicio en directo y las respuestas de error documentadas antes de integrar la API.

OpenAPI Artefactos de API

OpenAPI, Swagger, Postman, CLI, SDK y enlaces MCP están a un clic.

Claves API Acceso protegido

Los endpoints autenticados usan claves API con costes de créditos claros antes de llamarlos.

10,000 Créditos gratuitos

Empieza con 10.000 créditos mensuales y actualiza solo cuando crezca el uso.

Qué te ayuda a lanzar esta API

Usa esta página como un resumen de producción: endpoints, ejemplos, forma de respuesta y piezas de flujo necesarias para integrar DomScan en tu producto.

Flujos de producto

Integra comprobaciones de dominios, inteligencia DNS, señales de riesgo o enriquecimiento en onboarding, búsqueda y herramientas internas.

Automatización de analistas

Sustituye consultas manuales repetidas por tareas programadas, alertas y pasos de investigación reproducibles.

Datos JSON limpios

Usa campos previsibles, códigos de estado documentados y costes de créditos en lugar de raspar páginas de proveedores.

IA y operaciones

Alimenta agentes, paneles, playbooks SOAR y CRMs mediante OpenAPI, SDK, Postman o MCP.

Flujo de integración

Un camino simple desde la primera solicitud hasta un uso repetible en producción.

Autentica una vez

Envía tu clave API con la cabecera documentada y mantén solicitudes coherentes entre servicios.

Consulta con ejemplos

Empieza con las muestras curl y HTTP, y luego mapea los parámetros en el código de tu aplicación.

Opera y monitoriza

Usa códigos de estado, costes de créditos y campos de respuesta para crear reintentos, logs y alertas.

Kit para desarrolladores

Salta desde esta página a documentación legible por máquinas, colecciones de solicitudes, SDKs o herramientas para agentes.

Esquema OpenAPI

Genera clientes o inspecciona cada forma de solicitud y respuesta.

Colección Postman

Importa solicitudes listas para pruebas manuales y traspaso al equipo.

SDKs y CLI

Usa paquetes mantenidos y flujos de línea de comandos en vez de escribir boilerplate.

Integración MCP

Expón inteligencia de dominios a agentes de IA y asistentes internos.

Mapa de parámetros y respuesta

Revisa entradas, campos de salida y códigos de estado antes de conectar el endpoint a tu cliente.

Parámetros de solicitud

Parámetro

urldomainskip_cache

Campos de respuesta

Respuesta de ejemplo

outcomesummarysummary.coveragesummary.detected_signalssummary.total_signalssignalssignals.webmcpsignals.webmcp.statussignals.webmcp.validationsignals.remote_mcpsignals.remote_mcp.statussignals.openapi

Cobertura de estados

Códigos de estado HTTP

200400401402429502

Endpoints

GET /v1/agent-readiness

Créditos: 3Autenticación: Autenticación requerida

Señales de confianza antes de integrar

Documentación transparente, solicitudes autenticadas y detalles visibles de fiabilidad facilitan evaluar DomScan antes de publicar.

En directo Estado del servicio

Consulta el estado del servicio en directo y las respuestas de error documentadas antes de integrar la API.

OpenAPI Artefactos de API

OpenAPI, Swagger, Postman, CLI, SDK y enlaces MCP están a un clic.

Claves API Acceso protegido

Los endpoints autenticados usan claves API con costes de créditos claros antes de llamarlos.

10,000 Créditos gratuitos

Empieza con 10.000 créditos mensuales y actualiza solo cuando crezca el uso.

Características principales

Cuatro dimensiones de preparación

Puntúa el descubrimiento, el contenido, la política de acceso y las capacidades en una sola respuesta.

Puntuación y confianza transparentes

Las comprobaciones correctas obtienen todo el crédito, las advertencias obtienen crédito parcial y los fallos no obtienen crédito. Las comprobaciones desconocidas se excluyen de la puntuación y reducen la confianza.

Evidencias, advertencias y madurez

Revisa el estado, el peso, el método, las evidencias, las advertencias, la referencia y la etiqueta de madurez de cada comprobación.

Auditorías acotadas listas para automatizar

Usa puntuaciones y recomendaciones coherentes en comprobaciones de versiones, monitorización, revisiones de cartera y flujos internos de calidad sin ejecutar las herramientas descubiertas.

Solicitud de ejemplo

GET /v1/agent-readiness?url=https://example.com bash

curl -G -H "X-API-Key: $DOMSCAN_API_KEY" --data-urlencode "url=https://example.com" https://domscan.net/v1/agent-readiness

Respuesta de ejemplo

200 OK json

{
  "outcome": "complete",
  "summary": {
    "coverage": "multi_channel",
    "detected_signals": 2,
    "total_signals": 4
  },
  "signals": {
    "webmcp": { "status": "unknown", "validation": "runtime_required" },
    "remote_mcp": { "status": "not_detected" },
    "openapi": { "status": "detected", "validation": "confirmed" },
    "llms_txt": { "status": "detected", "validation": "confirmed" }
  },
  "recommendations": [
    { "code": "ADD_WEBMCP_TOOLS", "severity": "low" }
  ]
}

Preguntas frecuentes

¿Qué devuelve la API?

Devuelve una puntuación de 0 a 100 cuando hay comprobaciones concluyentes disponibles, cuatro puntuaciones dimensionales, más de 35 comprobaciones acotadas, confianza, evidencias, advertencias, etiquetas de madurez y recomendaciones.

¿Cómo debo interpretar Desconocido?

Desconocido significa que una comprobación no pudo concluirse con las evidencias disponibles. Se excluye de la puntuación y reduce la confianza. No lo trates como correcto ni como fallido.

¿La API ejecuta las herramientas descubiertas?

No. La comprobación de preparación evalúa las señales de descubrimiento y no invoca herramientas WebMCP ni herramientas de la aplicación descubiertas.

¿Cómo se calcula la puntuación de preparación para agentes de 0 a 100?

Las comprobaciones aplicables y concluyentes se ponderan según su importancia. Una comprobación correcta obtiene todo el crédito, una advertencia obtiene la mitad y un fallo no obtiene ninguno. Las comprobaciones desconocidas se excluyen y reducen la confianza. La puntuación no es una clasificación SEO ni una garantía de compatibilidad.

Herramientas y recursos relacionados

Códigos de estado HTTP

Documentamos los códigos de estado HTTP que debes gestionar para distinguir respuestas correctas, problemas de autenticación o créditos, límites de frecuencia, datos inexistentes y fallos del servicio de origen.

OK 200

Solicitud correcta

Solicitud incorrecta 400

Parámetros no válidos

No autorizado 401

Clave de API o sesión ausente o no válida.

Pago requerido 402

No tienes créditos suficientes para ejecutar esta solicitud.

Demasiadas solicitudes 429

Límite de frecuencia superado

Puerta de enlace incorrecta 502

Error del servicio RDAP de origen

Comprobar la preparación para agentes

Empezar gratis Ver documentación Probar la herramienta gratuita