dmgurus publica su información y sus herramientas de marketing en formatos que un agente de IA puede leer y ejecutar directamente, sin raspar el HTML del sitio. Todo lo de esta página es público y no necesita clave de API.

Puntos de entrada

Negociación de contenido en Markdown

Cualquier URL de dmgurus.com devuelve Markdown si la pides con la cabecera Accept: text/markdown, siguiendo la convención de acceptmarkdown.com. La respuesta llega con Content-Type: text/markdown y Vary: Accept. Con Accept: text/html se sigue sirviendo la página normal.

curl -sS -L -H 'Accept: text/markdown' https://dmgurus.com/

Las rutas que no existen devuelven HTTP 404 con un cuerpo en Markdown que explica el error y enlaza al índice del sitio.

Operaciones de la API

OperaciónMétodo y rutaQué devuelve
getAgencyProfileGET /agencyIdentidad, contacto, horario, cobertura y encargos para los que encajamos.
listServicesGET /servicesLas seis disciplinas con descripción y URL.
listIndustriesGET /industriesVerticales con casos entregados.
getPricingGET /pricingPrecios de arranque publicados por línea de trabajo.
listCaseStudiesGET /casesCasos filtrables por texto, vertical y servicio.
getCaseStudyGET /cases/{slug}Un caso concreto.
listResourcesGET /resourcesHerramientas gratuitas publicadas.
analyzeKeywordDensityPOST /tools/keyword-densityDensidad de términos y frases de un texto.
generateMetaTagsPOST /tools/meta-tagsTitle, description, Open Graph y Twitter Card con longitudes contadas.
getHealthGET /healthEstado del servicio.

Límite de peticiones

El límite es de 120 peticiones por 60 segundos por dirección IP. Cada respuesta incluye las cabeceras RateLimit y RateLimit-Policy en el formato de campos estructurados del IETF, además de RateLimit-Limit, RateLimit-Remaining y RateLimit-Reset. Al superarlo, la respuesta es 429 con la cabecera Retry-After en segundos.

RateLimit-Policy: "default";q=120;w=60
RateLimit: "default";r=118;t=54
Retry-After: 54   (sólo en 429)

Errores

Todos los errores de la API son JSON con la misma forma. Nunca se devuelve una página HTML de error a un cliente de API.

{
  "error": {
    "code": "not_found",
    "message": "No existe ningún caso publicado con ese slug.",
    "hint": "Llama a GET /cases para obtener la lista de slugs válidos.",
    "status": 404,
    "documentation_url": "https://dmgurus.com/developers/",
    "openapi_url": "https://dmgurus.com/api-spec.json",
    "request_id": "dmg_..."
  }
}

Servidor MCP

El servidor habla JSON-RPC 2.0 sobre HTTP POST (transporte Streamable HTTP) y no requiere autenticación. Expone seis herramientas —get_agency_profile, list_services, get_pricing, search_case_studies, keyword_density y generate_meta_tags— y siete recursos de lectura.

curl -sS -X POST https://dmgurus.com/mcp 
  -H 'Content-Type: application/json' 
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"mi-agente","version":"1.0"}}}'

Uso y límites

Los datos de la agencia y los casos se publican bajo CC BY 4.0: se pueden citar y reutilizar atribuyendo a dmgurus con enlace al sitio. Las herramientas son deterministas, no llaman a ningún modelo de lenguaje y no almacenan el texto que reciben. Para una consulta comercial real no uses la API: escribe a gonzalo@dmgurus.com.