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
- API REST:
https://dmgurus.com/wp-json/dmgurus/v1 - Especificación OpenAPI 3.1: /api-spec.json
- Servidor MCP (Streamable HTTP):
https://dmgurus.com/mcp— manifiesto en /mcp.json - Índice para modelos de lenguaje: /llms.txt
- Ficha de la agencia para agentes: /agents.json
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ón | Método y ruta | Qué devuelve |
|---|---|---|
getAgencyProfile | GET /agency | Identidad, contacto, horario, cobertura y encargos para los que encajamos. |
listServices | GET /services | Las seis disciplinas con descripción y URL. |
listIndustries | GET /industries | Verticales con casos entregados. |
getPricing | GET /pricing | Precios de arranque publicados por línea de trabajo. |
listCaseStudies | GET /cases | Casos filtrables por texto, vertical y servicio. |
getCaseStudy | GET /cases/{slug} | Un caso concreto. |
listResources | GET /resources | Herramientas gratuitas publicadas. |
analyzeKeywordDensity | POST /tools/keyword-density | Densidad de términos y frases de un texto. |
generateMetaTags | POST /tools/meta-tags | Title, description, Open Graph y Twitter Card con longitudes contadas. |
getHealth | GET /health | Estado 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.