API para desarrolladores

API y servidor MCP de Conference Partner

Acceso programático y de solo lectura a todo el conjunto de datos de Conference Partner: 5,799 congresos académicos y 1,213 revistas, con convocatorias y plazos de envío, fechas y sedes, rankings CCF / ICORE / QUALIS en paralelo, tasas de aceptación históricas, historial de ediciones, factores de impacto, ISSN y números especiales. Dos interfaces sobre los mismos datos: una API REST y un servidor MCP nativo para agentes de IA.

Pruébalo ahora mismo

Estos tres comandos funcionan tal cual, sin credenciales ni cuenta:

# Congresos del campo de la IA con plazo de envío en los próximos tres meses
# (no hace falta palabra clave: todos los parámetros de búsqueda son opcionales y combinables)
curl "https://www.myhuiban.com/api/conferences?field=ai&submission_date_start=2026-08-01&submission_date_end=2026-11-01"

# Congresos con convocatoria de artículos abierta
curl "https://www.myhuiban.com/api/conferences/rankings/cfp?per_page=5"

# Estadísticas de todo el sitio (totales, plazos por mes, niveles de ranking, áreas de investigación, países)
curl "https://www.myhuiban.com/api/statistics"

Cada respuesta incluye X-Quota-Limit y X-Quota-Remaining, así que puedes ver cuánto queda del día. CORS está abierto, por lo que también funcionan desde JavaScript en el navegador.

Endpoints REST

Endpoint Qué devuelve Autenticación
GET /api/conferences Búsqueda. Todos los parámetros son opcionales y combinables: query, ccf_rank, core_rank, qualis_rank, field (21 áreas de investigación), submission_date_start, submission_date_end, conference_date_start, conference_date_end, updated_since (sincronización incremental). ninguna
GET /api/conferences/rankings/{ranking} Listas seleccionadas: cfp, past_cfp, ccf, core, qualis, most_viewed, most_tracked, most_attended, most_competitive, upcoming, past, trending. ninguna
GET /api/journals Búsqueda. Todos los parámetros son opcionales: query, ccf_rank, issn, field, updated_since. ninguna
GET /api/journals/rankings/{ranking} Listas seleccionadas: cfp, ccf, highest_if, most_viewed, most_tracked, all. ninguna
GET /api/statistics Totales, próximos plazos por mes, convocatorias abiertas por nivel de ranking y distribuciones por país, área de investigación, factor de impacto y editorial. ninguna
GET /api/conferences/{id} Detalle completo: texto de la convocatoria, histórico de tasas de aceptación, historial de ediciones, valoraciones, comentarios y sedes relacionadas. cuenta
GET /api/journals/{id} Detalle completo: texto de la convocatoria, números especiales, valoraciones, comentarios y sedes relacionadas. cuenta
GET /api/researchers/{id} Perfil público de un investigador: institución, resumen de intereses de investigación generado automáticamente, CV y sedes seguidas o asistidas. Nunca incluye datos de contacto; solo por id: no hay búsqueda ni enumeración de investigadores. cuenta
POST /api/login Intercambia las credenciales de la cuenta por un JWT. ninguna

Pagina cualquier lista con page y per_page (máximo 100). Contrato completo legible por máquina: esquema OpenAPI 3.

Servidor MCP (para agentes de IA)

Un servidor Model Context Protocol nativo habla Streamable HTTP en POST https://www.myhuiban.com/mcp y está registrado en el registro oficial de MCP como com.myhuiban.www/conference-partner. Añádelo a cualquier cliente MCP, por ejemplo:

claude mcp add --transport http huiban https://www.myhuiban.com/mcp

Ocho herramientas: search_conferences, search_journals, list_conferences, list_journals, get_conference, get_journal, get_researcher, get_statistics.Las herramientas de búsqueda aceptan los mismos filtros opcionales que los endpoints REST de búsqueda (campo de investigación entre 21 áreas, rankings y rangos de fechas de envío o celebración).

Estas funcionan sin credenciales: search_conferences, search_journals, list_conferences, list_journals, get_statistics. Las tres herramientas de detalle (get_conference, get_journal, get_researcher) necesitan una credencial; consulta más abajo.

El servidor también ofrece prompts de MCP: tareas listas que tu cliente presenta como puntos de partida de un clic, para que no tengas que averiguar qué preguntar ante una lista de nombres de herramientas: upcoming_deadlines, where_to_submit, venue_snapshot, open_special_issues. Cada una se expande en una petición que nombra las herramientas a llamar y admite argumentos opcionales, como un área de investigación o cuántos días mirar hacia adelante.

Cada herramienta MCP tiene su equivalente REST (get_researcher ↔ GET /api/researchers/{id}, y así con el resto): ambas superficies usan la misma capa de consulta y devuelven cargas idénticas, por lo que puedes cambiar de transporte sin tocar tu lógica de parseo.

Obtener una credencial para los endpoints de detalle

  1. Regístrate gratis en myhuiban.com/registration y verifica tu correo electrónico.
  2. Crea una clave de API en myhuiban.com/account/api-keys. Se muestra una sola vez: nosotros solo guardamos su hash.
  3. Envíalo en cada solicitud: Authorization: Bearer <credential> 
    curl -H "Authorization: Bearer hb_..." \
  https://www.myhuiban.com/api/conferences/1

Así es también como se conecta un cliente MCP. Claude, ChatGPT, Cursor y VS Code permiten añadir un servidor MCP remoto indicando su URL (https://www.myhuiban.com/mcp) más una cabecera de petición fija: una clave de API encaja exactamente en ese formato, sin ninguna ronda de renovación de token.

Las claves de API no caducan y se pueden revocar una a una desde esa misma página; cada una se contabiliza por separado, así que puedes dar una a cada cliente. Si prefieres intercambiar credenciales en tiempo de ejecución, POST /api/login sigue devolviendo un JWT válido unos seis meses: sirve en todos los sitios donde sirve una clave, pero no se puede revocar por separado.

Todas las credenciales de una cuenta comparten el mismo límite diario (200 solicitudes al día), sumando la API REST y el servidor MCP.

Hay tres cosas que no son de autoservicio y están disponibles a petición: un límite mayor, la URL del sitio web propio de cada sede (las respuestas solo enlazan a detail_page), y una exportación masiva del conjunto de datos. Escribe a [email protected] contándonos qué estás construyendo y te diremos qué es posible: no hay lista de precios publicada, porque hasta ahora cada petición ha sido distinta.

Mantener sincronizada una copia

Haz una pasada completa una vez (sin updated_since) y luego consulta con updated_since fijado al updated_at más reciente que hayas visto. Solo se devuelven los registros modificados en esa fecha o después.

curl 'https://www.myhuiban.com/api/conferences?updated_since=2026-08-01&per_page=100'

Dos cosas a tener en cuenta: la resolución es de un día, así que volver a pedir la fecha más reciente es normal e idempotente; y los registros que nunca se han editado no tienen marca de cambio, por lo que solo aparecen en la pasada completa, nunca en el flujo incremental.

Cuotas y códigos de estado

  • 200 — correcto. Consulta X-Quota-Remaining para ver lo que queda hoy.
  • 401 — este endpoint necesita una credencial (solo la requieren los endpoints de detalle por sede), o la que enviaste no es válida, ha sido revocada o ha caducado. Para usar el nivel anónimo no envíes ninguna cabecera Authorization: una credencial inservible nunca se degrada silenciosamente a ese nivel.
  • 402 — la cuota diaria de tu cuenta se ha agotado. Retry-After indica cuántos segundos faltan para que se reinicie.
  • 429 — la cuota diaria anónima por IP se ha agotado; una clave de API gratuita eleva mucho el límite. Retry-After indica cuántos segundos faltan para que se reinicie: espera ese tiempo en lugar de reintentar antes, y usa updated_since para que una tarea programada solo vuelva a pedir lo que cambió.

Ejemplos de cliente y una instantánea descargable

github.com/sundou82/conference-partner-mcp es el repositorio público complementario: configuración MCP lista para copiar y pegar para Claude, Cursor y VS Code, clientes ejecutables en Python / Node / curl que no necesitan clave de API, y el documento OpenAPI que se vuelve a descargar de este sitio cada día. El servidor MCP y la API son un servicio alojado y no son de código abierto — no hace falta instalar nada del repositorio para usarlos.

También incluye una instantánea reconstruida a diario, en JSON y CSV: plazos próximos, los catálogos CCF y CORE, revistas CCF, convocatorias de números especiales abiertas y revistas por factor de impacto. Cubre exactamente lo que sirven sin credenciales los endpoints anteriores — el detalle de cada sede sigue detrás de la API. Un archivo queda obsoleto en cuanto se mueve un plazo, así que úsalo para explorar o cargar en bloque y llama a la API cuando tenga que ser exacto.

Condiciones de uso

La API es de solo lectura y de uso gratuito, incluso en productos comerciales, siempre que atribuyas a Conference Partner y enlaces de vuelta a la página de la sede en este sitio — cada respuesta incluye una URL detail_page justo para eso. Mantén una petición por segundo o menos al recorrer listados. Para redistribuir el conjunto de datos en bloque, usa la instantánea de datos publicada en lugar de un rastreo propio, y consúltanos antes para cualquier uso más amplio, en especial licencias del conjunto de datos y entrenamiento de modelos. Consulta también nuestra Metodología para saber de dónde vienen las clasificaciones y los datos.

Otros puntos de entrada legibles por máquina

Preguntas, informes de errores o un caso de uso que quieras que admitamos: [email protected].