MCP-сервер OpenSincera

Сервер протокола контекста модели (MCP), предоставляющий доступ к API OpenSincera для получения метаданных издателей, информации о верификации и аналитики качества рекламы.

Обзор

OpenSincera — это платформа, обеспечивающая прозрачность и данные верификации для издателей цифровой рекламы. Этот MCP-сервер позволяет ИИ-ассистентам и другим инструментам получать доступ к информации об издателях OpenSincera, включая статус верификации, метаданные, операционные метрики, сигналы качества рекламы на уровне устройств и конкурентный бенчмаркинг.

Related MCP server: NewsBreak MCP Server

Функции

• Поиск издателей: Поиск по домену или ID издателя

• Получение метаданных: Получение подробной информации об издателе, включая статус верификации, категории и операционные метрики

• Метрики на уровне устройств: Сравнение показателей A2CR для мобильных устройств и компьютеров, видимости рекламы, частоты обновления объявлений и многого другого

• Конкурентный бенчмаркинг: Сравнение издателя с похожими издателями бок о бок

• Оценка медиа: Оценка и ранжирование нескольких издателей для выбора рекламных площадок

• Мониторинг состояния: Проверка статуса подключения к API OpenSincera

• Обработка ошибок: Комплексная обработка ошибок с подробными сообщениями

• Валидация входных данных: Надежная проверка входных данных с использованием схем Zod

Установка

Установите пакет глобально с помощью npm:

npm install -g opensincera-mcp-server

Предварительные требования

• Node.js 18.0.0 или выше

• API-ключ OpenSincera

Настройка

1. Клонируйте репозиторий:

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

2. Установите зависимости:

npm install

3. Соберите проект:

npm run build

4. Настройте переменные окружения:

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

Использование

Запуск сервера

npm start

Разработка

npm run dev

Конфигурация с Claude Desktop

Добавьте следующее в файл конфигурации Claude Desktop в зависимости от метода установки.

Файл находится по адресу:

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

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

Вариант 1: При глобальной установке

Если вы установили пакет глобально через npm install -g, команда будет доступна непосредственно в системном пути.

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

Вариант 2: При использовании локального клона

Если вы клонировали репозиторий локально, необходимо указать полный путь к скрипту. Не забудьте заменить /path/to/ на фактический абсолютный путь к директории проекта.

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

Примеры промптов для Claude Desktop

После настройки вы можете использовать эти промпты на естественном языке в Claude Desktop:

Базовая проверка состояния

Check the OpenSincera API connection status

Поиск издателя по домену

Get publisher information for yahoo.com from OpenSincera

Запрос подробного анализа

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

Сравнение на уровне устройств

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

Конкурентный бенчмаркинг

Compare businessinsider.com against its similar publishers

Оценка медиа с фокусом на мобильные устройства

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

Поиск по ID издателя

Get detailed information for OpenSincera Publisher ID 2737

Вопросы о бизнес-контексте

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?

Эти промпты автоматически активируют соответствующие инструменты MCP OpenSincera и вернут отформатированные ответы с подробными пояснениями метрик.

Доступные инструменты

get_publisher_metadata

Получение метаданных издателя из API OpenSincera.

Параметры:

• publisherId (необязательно): ID издателя для поиска

• publisherDomain (необязательно): Домен издателя для поиска

• limit (необязательно): Максимальное количество результатов (1-100)

• offset (необязательно): Количество пропускаемых результатов

Примечание: Необходимо указать либо publisherId, либо publisherDomain.

Пример:

{
  "publisherDomain": "example.com"
}

get_publisher_by_domain

Получение одного издателя по доменному имени.

Параметры:

• domain (обязательно): Домен издателя для поиска

Пример:

{
  "domain": "example.com"
}

get_publisher_by_id

Получение одного издателя по ID издателя.

Параметры:

• publisherId (обязательно): ID издателя для поиска

Пример:

{
  "publisherId": "12345"
}

compare_publishers

Сравнение издателя с похожими издателями (конкурентный бенчмарк). Получает целевого издателя и похожих издателей, отобранных OpenSincera, а затем создает сравнительную таблицу ключевых метрик.

Параметры:

• domain (обязательно): Домен издателя для бенчмаркинга

• device (необязательно): Тип устройства для сравнения метрик — overall (по умолчанию), mobile или desktop

Пример:

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

evaluate_media

Оценка и ранжирование нескольких доменов издателей для выбора рекламных площадок. Каждый издатель получает оценку (0–100) на основе метрик качества рекламы, состояния цепочки поставок и охвата идентификаторов, взвешенную по цели кампании.

Параметры:

• domains (обязательно): Список доменов издателей для оценки

• campaignGoal (необязательно): branding, performance или balanced (по умолчанию)

• language (необязательно): Язык вывода — en (по умолчанию) или ja

• device (необязательно): Тип устройства для оценки — overall (по умолчанию), mobile или desktop

Пример:

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

health_check

Проверка состояния подключения к API OpenSincera.

Параметры: Нет

Формат ответа

Ответ с метаданными издателя

{
  "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
}

Ответ проверки состояния

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

Переменные окружения

Обработка ошибок

Сервер обеспечивает комплексную обработку ошибок для типичных сценариев:

• Ошибки аутентификации (401): Неверный или отсутствующий API-ключ

• Ошибки авторизации (403): Недостаточно прав

• Ошибки поиска (404): Издатель не найден

• Ограничение частоты запросов (429): Превышен лимит API

• Сетевые ошибки: Проблемы с подключением или тайм-ауты

• Ошибки валидации: Неверные входные параметры

Разработка

Скрипты

• npm run build - Сборка TypeScript-проекта

• npm run dev - Запуск в режиме разработки с горячей перезагрузкой

• npm test - Запуск тестов

• npm run lint - Запуск ESLint

• npm run format - Форматирование кода с помощью Prettier

Структура проекта

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

Участие в разработке

1. Сделайте форк репозитория

2. Создайте ветку для новой функции

3. Внесите изменения

4. Добавьте тесты для новой функциональности

5. Запустите набор тестов

6. Отправьте pull request

Лицензия

Этот проект лицензирован по лицензии MIT — подробности см. в файле LICENSE.

Поддержка

По вопросам, связанным с этим MCP-сервером, пожалуйста, создайте issue на GitHub.

По вопросам работы API OpenSincera, пожалуйста, обращайтесь напрямую в службу поддержки OpenSincera.

Журнал изменений

v1.0.4

• Добавлена поддержка device_level_metrics: разбивка по мобильным устройствам и компьютерам для A2CR, видимости рекламы, частоты обновления (средняя/мин/макс) и процента рекламных слотов с обновлением

• Добавлен инструмент compare_publishers: конкурентный бенчмарк бок о бок с похожими издателями

• Добавлен инструмент evaluate_media: оценка и ранжирование нескольких издателей по цели кампании (брендинг/перформанс/сбалансировано)

• Добавлен параметр device в compare_publishers и evaluate_media для анализа по мобильным устройствам/компьютерам

• Добавлен модуль analysis.ts для логики оценки и отчетности

v1.0.3

• Добавлены функции сравнения и оценки издателей

• Обновлена структура метаданных издателя: добавлены owner_domain, domain, parent_entity_id и similar_publishers

v1.0.2

• Обновление версии и улучшения стабильности

v1.0.0

• Первый выпуск

• Базовая функциональность поиска издателей

• Эндпоинт проверки состояния

• Комплексная обработка ошибок

• Валидация входных данных