CiteWire

citewire.org · Openly Useful

Infraestructura MCP que prioriza la atribución para el descubrimiento de noticias e investigación.

CiteWire ofrece a los agentes acceso estructurado y de solo lectura a metadatos de noticias e investigación, al tiempo que preserva el crédito y el tráfico del publicador original. Puede exponer una plataforma de noticias compatible como herramientas MCP tipadas, consultar APIs opcionales de proveedores públicos o hacer ambas cosas en un mismo servidor.

La edición Community es útil por sí sola. Incluye el núcleo MCP, los transportes stdio y HTTP, el adaptador genérico de plataforma y todos los adaptadores de proveedores de este repositorio bajo la licencia MIT. La dirección comercial del producto es adicional y se centra en operaciones gestionadas, personalización, flujos de trabajo, colaboración, historial retenido y soporte. Consulta Niveles de producto.

Para qué sirve CiteWire

• Operadores de plataformas de noticias pueden exponer una API de lectura compatible mediante news.list, news.get, news.topics y news.about.

• Investigadores y desarrolladores de agentes pueden habilitar únicamente los proveedores de noticias e investigación que deseen consultar.

• Quienes se autoalojan pueden ejecutar el mismo servidor a través de stdio, HTTP sin estado o dentro de una función serverless de Node.

• Colaboradores de proveedores pueden añadir un adaptador concreto sin introducir, una dependencia de tiempo de ejecución.

CiteWire no es un servicio de ingesta de texto completo, un rastreador, un publicador, una plataforma editorial ni un servicio de autorización de derechos. No almacena ni vuelve a publicar los cuerpos de los artículos. La disponibilidad de un proveedor no sustituye la revisión de los términos vigentes de dicho proveedor para tu caso de uso.

Related MCP server: agentpulse-mcp

Inicio rápido

Requisitos: Node.js 18 o posterior. Community es un paquete de Node solo ESM; no proporciona un punto de entrada CommonJS.

Crea citewire.config.json con un proveedor habilitado:

{
  "providers": {
    "openalex": { "enabled": true }
  }
}

Ejecuta el servidor sobre stdio:

npx -y citewire --config citewire.config.json

stdio es el transporte por defecto y la opción habitual cuando un cliente MCP lanza citewire como proceso local.

Configuración del cliente MCP

Usa una ruta de configuración absoluta, porque los clientes no siempre se lanzan desde el directorio del proyecto:

{
  "mcpServers": {
    "citewire": {
      "command": "npx",
      "args": [
        "-y",
        "citewire",
        "--config",
        "/absolute/path/to/citewire.config.json"
      ]
    }
  }
}

Que especifique HTTP

Ejecuta el transporte HTTP sin estado en el puerto 8722:

npx -y citewire --config citewire.config.json --http 8722

El endpoint local acepta JSON-RPC sobre POST /. No ofrece sesiones ni un flujo de eventos.

Dos formas de usarlo

1. Envolver una plataforma de noticias compatible

Declara una plataforma con un nombre visible, una URL del sitio y una base de API de lectura:

{
  "platform": {
    "name": "Example Industry News",
    "siteUrl": "https://news.example",
    "apiBase": "https://news.example/api/v1/news"
  }
}

Esa configuración expone cuatro herramientas:

La superficie HTTP necesaria se documenta en el Code HTTP de lectura de la plataforma.

2. Habilitar herramientas de proveedores

Los adaptadores de proveedor se incluyen en Community y están deshabilitados por defecto. Aproveedor solo se activa cuando su entrada de configuración define enabled con valor true.

{
  "providers": {
    "gdelt-doc": { "enabled": true },
    "arxiv": { "enabled": true },
    "crossref": {
      "enabled": true,
      "mailto": "operator@example.com"
    }
  }
}

Crossref exige el correo de contacto del operador del despliegue para que las solicitudes identifiquen al operador en su persona (Ver [[Figure 1]]. No copie la dirección del ejemplo.

Los adaptadores actuales son los siguientes:

Sé Proveedores antes de habilitar uno. Ese documento registra el endpoint, la documentación, la base de acceso gratuito y los límites de cortesía conocidos de cada adaptador. La propia documentación del proveedor sigue siendo la fuente de verdad.

Comportamiento de la configuración

• platform es opcional.

• providers es opcional.

• Un proveedor omitido de la configuración permanece deshabilitado.

• Una configuración vacía es válida y no expone herramientas.

• Una configuración no válida falla antescomenzar con el campo mencionado en el error.

• tools/list es la lista autoritativa de herramientas para un despliegue en ejecución, porque las herramientas habilitadas dependen de la configuración de ese despliegue.

Un despliegue puede combinar herramientas de plataforma y de proveedores:

{
  "platform": {
    "name": "Example Industry News",
    "siteUrl": "https://news.example",
    "apiBase": "https://news.example/api/v1/news"
  },
  "providers": {
    "openalex": { "enabled": true }
  }
}

Base de políticas opcional de Comunidad

CiteWire puede exponer una base local y de solo lectura para la política de fuentes, la atribución de derechos y el scoring de inclusión en modo sombra:

{
  "community": {
    "enabled": true,
    "classifierMode": "shadow",
    "thresholds": {
      "adjacent_min": 0.5,
      "standard_min": 0.6
    }
  }
}

Toda fuente incluida permanece deshabilitada por defecto. Esta configuración no realiza llamadas de red, no carga credenciales y no puede publicar. Las comprobaciones de derechos basadas en credenciales evalúan referencias opacas del gestor de secretos en memoria, pero nunca devuelven esas referencias. El clasificador se fuerza a una modo sombra y siempre informa publishable: false hasta que existan un sistema editorial y un corpus de evaluación revisados por separado.

Consulta Registro de fuentes y derechos para la validación de ejecución, la política de cierre ante fallos, las herramientas y recursos MCP canónicos y las limitaciones actuales.

Límites de diseño

• MIT y cero dependencias. El paquete usa módulos integrados de Node y no tiene dependencias de ejecución ni de desarrollo.

• Node ESM. Community compatible con Node.js 18 o superior mediante ESM. No ofrece compatibilidad con CommonJS viene una compilación CommonJS.

• Solo lectura. Las herramientas incluidas consultan las superficies de lectura de el proveedor o la plataforma.

• Sin estado. El servidor de la plataforma no tiene cuentas, sesiones, búsquedas guardadas ni historial retenido.

• Primero la atribución. Los resultados conservan los metadatos y enlaces de la fuente proporcionados por la plataforma o el proveedor de origen.

• Impulsado por la configuración. El desplegador decide qué herramientas están presentes. Nada se activa por sí solo.

• Sin almacenamiento. El núcleo no conserva las respuestas de los proveedores ni el contenido de las fuentes.

Estos límites se mantienen a través de la política de gobernanza del proyecto.

Ecosistema y documentación del producto

• Niveles de producto define el valor permanente de Community y la frontera comercial adicional.

• Distribución contiene la lista de verificación exacta de registro y catálogo. Las no presentadas están marcadas como PENDING.

• Gobernanza explica las decisiones, el cuidado de los proveedores, la compatibilidad y las licencias.

• Proveedores documenta cada proveedor ascendente.

• Contrato de plataforma define la API de lectura de noticias compatible.

• Contribución cubre setup de desarrollo, pruebas, altas de proveedores y expectativas de pull requests. | Releasing/Release define controles de publicación de paquetes y registros.

• Soporte SUPPORT.md | Seguridad y el Código de conducta definen los canales de funcionamiento de la comunidad.

Origen del proyecto

Citewire tomó forma durante su primer despliegue para Karaya Group Industry Notes. El contrato de plataforma público es general y “envuelve” cualquier API de lectura compatible.

Si haciendo pairing

Ejecuta la comeback de pruebas con npm test. No se necesita ningún paso de instalación. Consulta CONTRIBUTING.md antes de proponer un proveedor o un cambio en un contrato público.

Licencia

Community está bajo la Licencia MIT. Consulta LICENSE.comunidad