Servidor MCP de OpenSincera

Un servidor del Protocolo de Contexto de Modelo (MCP) que proporciona acceso a la API de OpenSincera para recuperar metadatos de editores, información de verificación y análisis de calidad publicitaria.

Descripción general

OpenSincera es una plataforma que proporciona transparencia y datos de verificación para editores de publicidad digital. Este servidor MCP permite a los asistentes de IA y otras herramientas acceder a la información de los editores de OpenSincera, incluyendo el estado de verificación, metadatos, métricas operativas, señales de calidad publicitaria a nivel de dispositivo y evaluaciones comparativas competitivas.

Related MCP server: NewsBreak MCP Server

Características

• Búsqueda de editores: Busque editores por dominio o ID de editor

• Recuperación de metadatos: Obtenga información detallada del editor, incluyendo estado de verificación, categorías y métricas operativas

• Métricas a nivel de dispositivo: Compare A2CR móvil frente a escritorio, anuncios a la vista, tasas de actualización de anuncios y más

• Evaluación comparativa competitiva: Compare un editor con editores similares lado a lado

• Evaluación de medios: Puntúe y clasifique múltiples editores para la selección de medios del anunciante

• Monitoreo de salud: Compruebe el estado de la conexión a la API de OpenSincera

• Manejo de errores: Manejo integral de errores con mensajes detallados

• Validación de entrada: Validación robusta de entradas mediante esquemas Zod

Instalación

Instale el paquete globalmente usando npm:

npm install -g opensincera-mcp-server

Requisitos previos

• Node.js 18.0.0 o superior

• Clave de API de OpenSincera

Configuración

1. Clone el repositorio:

git clone https://github.com/miyaichi/opensincera-mcp-server.git
cd opensincera-mcp-server

2. Instale las dependencias:

npm install

3. Construya el proyecto:

npm run build

4. Configure las variables de entorno:

export OPENSINCERA_API_KEY="your-api-key-here"
export OPENSINCERA_BASE_URL="https://open.sincera.io/api"  # Optional
export OPENSINCERA_TIMEOUT="10000"  # Optional (milliseconds)

Uso

Ejecución del servidor

npm start

Desarrollo

npm run dev

Configuración con Claude Desktop

Añada lo siguiente a su archivo de configuración de Claude Desktop, dependiendo de su método de instalación.

El archivo se encuentra en:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%/Claude/claude_desktop_config.json

Opción 1: Si se instaló globalmente

Si instaló el paquete globalmente mediante npm install -g, el comando está disponible directamente en la ruta de su sistema.

{
  "mcpServers": {
    "opensincera": {
      "command": "opensincera-mcp-server",
      "env": {
        "OPENSINCERA_API_KEY": "your-api-key-here"
      }
    }
  }
}

Opción 2: Si utiliza un clon local

Si clonó el repositorio localmente, debe proporcionar la ruta completa al script. Recuerde reemplazar /path/to/ con la ruta absoluta real al directorio del proyecto.

{
  "mcpServers": {
    "opensincera": {
      "command": "node",
      "args": ["/path/to/opensincera-mcp-server/dist/index.js"],
      "env": {
        "OPENSINCERA_API_KEY": "your-api-key-here"
      }
    }
  }
}

Ejemplos de prompts para Claude Desktop

Una vez configurado, puede usar estos prompts en lenguaje natural en Claude Desktop:

Verificación de salud básica

Check the OpenSincera API connection status

Búsqueda de dominio de editor

Get publisher information for yahoo.com from OpenSincera

Solicitud de análisis detallado

Analyze the publisher metrics for cnn.com and explain:
- Their verification status
- Ad to content ratio and what it means
- Supply chain complexity
- Overall advertising quality

Comparación a nivel de dispositivo

Show me the mobile vs desktop ad quality metrics for nytimes.com

Evaluación comparativa competitiva

Compare businessinsider.com against its similar publishers

Evaluación de medios centrada en móviles

Evaluate these publishers for a mobile branding campaign:
- nytimes.com
- washingtonpost.com
- reuters.com
Use device: mobile

Búsqueda por ID de editor

Get detailed information for OpenSincera Publisher ID 2737

Preguntas de contexto empresarial

I'm considering running ad campaigns on forbes.com.
Can you check their OpenSincera profile and tell me:
- Is this a verified publisher?
- What's their ad refresh rate and is it good or bad?
- How many supply paths do they have?
- Would you recommend this publisher for quality ad placement?

Estos prompts activarán automáticamente las herramientas MCP de OpenSincera adecuadas y devolverán respuestas formateadas con explicaciones detalladas de las métricas.

Herramientas disponibles

get_publisher_metadata

Obtenga metadatos del editor desde la API de OpenSincera.

Parámetros:

• publisherId (opcional): ID del editor a buscar

• publisherDomain (opcional): Dominio del editor a buscar

• limit (opcional): Número máximo de resultados (1-100)

• offset (opcional): Número de resultados a omitir

Nota: Se debe proporcionar publisherId o publisherDomain.

Ejemplo:

{
  "publisherDomain": "example.com"
}

get_publisher_by_domain

Obtenga un solo editor por nombre de dominio.

Parámetros:

• domain (requerido): Dominio del editor a buscar

Ejemplo:

{
  "domain": "example.com"
}

get_publisher_by_id

Obtenga un solo editor por ID de editor.

Parámetros:

• publisherId (requerido): ID del editor a buscar

Ejemplo:

{
  "publisherId": "12345"
}

compare_publishers

Compare un editor con sus editores similares (evaluación comparativa competitiva). Recupera el editor objetivo y sus editores similares seleccionados por OpenSincera, luego genera una comparación lado a lado de métricas clave.

Parámetros:

• domain (requerido): Dominio del editor a evaluar

• device (opcional): Tipo de dispositivo a usar para la comparación de métricas — overall (predeterminado), mobile o desktop

Ejemplo:

{
  "domain": "businessinsider.com",
  "device": "mobile"
}

evaluate_media

Puntúe y clasifique múltiples dominios de editores para la selección de medios del anunciante. Cada editor recibe una puntuación (0–100) basada en métricas de calidad publicitaria, salud de la cadena de suministro y cobertura de identidad, ponderada por el objetivo de la campaña.

Parámetros:

• domains (requerido): Lista de dominios de editores a evaluar

• campaignGoal (opcional): branding, performance o balanced (predeterminado)

• language (opcional): Idioma de salida — en (predeterminado) o ja

• device (opcional): Tipo de dispositivo a usar para la puntuación — overall (predeterminado), mobile o desktop

Ejemplo:

{
  "domains": ["nytimes.com", "washingtonpost.com", "reuters.com"],
  "campaignGoal": "branding",
  "device": "desktop"
}

health_check

Compruebe el estado de salud de la conexión a la API de OpenSincera.

Parámetros: Ninguno

Formato de respuesta

Respuesta de metadatos del editor

{
  "publishers": [
    {
      "publisherId": "1",
      "publisherName": "Business Insider",
      "ownerDomain": "insider-inc.com",
      "domain": "businessinsider.com",
      "status": "active",
      "lastUpdated": "2026-04-14T01:00:25.419Z",
      "categories": [],
      "verificationStatus": "verified",
      "parentEntityId": 59072,
      "similarPublishers": [41, 67, 405],
      "deviceMetrics": {
        "mobile": {
          "avgAdsToContentRatio": 0.265,
          "maxAdsToContentRatio": 1.0,
          "minAdsToContentRatio": 0.0,
          "avgAdUnitsInView": 1.611,
          "maxAdUnitsInView": 4.0,
          "averageRefreshRate": 58.441,
          "maxRefreshRate": 420.0,
          "minRefreshRate": 5.0,
          "percentageOfAdSlotsWithRefresh": 98.78
        },
        "desktop": {
          "avgAdsToContentRatio": 0.231,
          "maxAdsToContentRatio": 1.0,
          "minAdsToContentRatio": 0.0,
          "avgAdUnitsInView": 2.577,
          "maxAdUnitsInView": 9.0,
          "averageRefreshRate": 81.096,
          "maxRefreshRate": 590.0,
          "minRefreshRate": 5.0,
          "percentageOfAdSlotsWithRefresh": 84.99
        }
      },
      "metadata": {
        "description": "Business Insider tells the global tech, finance...",
        "primarySupplyType": "web",
        "avgAdsToContentRatio": 0.249,
        "avgAdsInView": 2.088,
        "avgAdRefresh": 72.489,
        "totalUniqueGpids": 946,
        "idAbsorptionRate": 0.5,
        "avgPageWeight": 27.843,
        "avgCpu": 254.671,
        "totalSupplyPaths": 118,
        "resellerCount": 69,
        "slug": "business-insider"
      }
    }
  ],
  "totalCount": 1,
  "hasMore": false
}

Respuesta de verificación de salud

{
  "healthy": true,
  "timestamp": "2026-04-14T10:00:00Z"
}

Variables de entorno

Manejo de errores

El servidor proporciona un manejo integral de errores para escenarios comunes:

• Errores de autenticación (401): Clave de API inválida o faltante

• Errores de autorización (403): Permisos insuficientes

• Errores de no encontrado (404): Editor no encontrado

• Limitación de tasa (429): Límite de tasa de API excedido

• Errores de red: Problemas de conexión o tiempos de espera

• Errores de validación: Parámetros de entrada inválidos

Desarrollo

Scripts

• npm run build - Construir el proyecto TypeScript

• npm run dev - Ejecutar en modo de desarrollo con recarga en caliente

• npm test - Ejecutar pruebas

• npm run lint - Ejecutar ESLint

• npm run format - Formatear código con Prettier

Estructura del proyecto

src/
├── index.ts                 # Main MCP server entry point and tool definitions
├── opensincera-service.ts   # OpenSincera API client and data models
├── metadata-descriptions.ts # Field descriptions and formatted output
└── analysis.ts              # Scoring, comparison, and evaluation logic

Contribución

1. Bifurque el repositorio

2. Cree una rama de características

3. Realice sus cambios

4. Añada pruebas para la nueva funcionalidad

5. Ejecute el conjunto de pruebas

6. Envíe una solicitud de extracción (pull request)

Licencia

Este proyecto está bajo la Licencia MIT - vea el archivo LICENSE para más detalles.

Soporte

Para problemas relacionados con este servidor MCP, por favor abra un issue en GitHub.

Para problemas con la API de OpenSincera, por favor contacte directamente al soporte de OpenSincera.

Registro de cambios

v1.0.4

• Se añadió soporte para device_level_metrics: desgloses móviles y de escritorio para A2CR, anuncios a la vista, tasa de actualización de anuncios (promedio/mín/máx) y porcentaje de espacios publicitarios con actualización

• Se añadió la herramienta compare_publishers: evaluación comparativa competitiva lado a lado contra editores similares

• Se añadió la herramienta evaluate_media: puntúe y clasifique múltiples editores por objetivo de campaña (branding/performance/balanced)

• Se añadió el parámetro device a compare_publishers y evaluate_media para análisis específicos de móvil/escritorio

• Se añadió el módulo analysis.ts para la lógica de puntuación y generación de informes

v1.0.3

• Se añadieron características de comparación y calificación de editores

• Se actualizó la estructura de metadatos del editor con owner_domain, domain, parent_entity_id y similar_publishers

v1.0.2

• Actualización de versión y mejoras de estabilidad

v1.0.0

• Lanzamiento inicial

• Funcionalidad básica de búsqueda de editores

• Endpoint de verificación de salud

• Manejo integral de errores

• Validación de entrada