OpenSincera MCP-Server

Ein Model Context Protocol (MCP)-Server, der Zugriff auf die OpenSincera-API zum Abrufen von Publisher-Metadaten, Verifizierungsinformationen und Analysen zur Werbequalität bietet.

Übersicht

OpenSincera ist eine Plattform, die Transparenz- und Verifizierungsdaten für digitale Werbe-Publisher bereitstellt. Dieser MCP-Server ermöglicht es KI-Assistenten und anderen Tools, auf die Publisher-Informationen von OpenSincera zuzugreifen, einschließlich Verifizierungsstatus, Metadaten, operativen Kennzahlen, Werbequalitätssignalen auf Geräteebene und Wettbewerbs-Benchmarks.

Related MCP server: NewsBreak MCP Server

Funktionen

• Publisher-Suche: Suche nach Publishern anhand der Domain oder Publisher-ID

• Abruf von Metadaten: Erhalten Sie detaillierte Publisher-Informationen, einschließlich Verifizierungsstatus, Kategorien und operativen Kennzahlen

• Kennzahlen auf Geräteebene: Vergleich von A2CR, sichtbaren Anzeigen, Anzeigenaktualisierungsraten und mehr zwischen Mobilgeräten und Desktops

• Wettbewerbs-Benchmarking: Vergleich eines Publishers mit ähnlichen Publishern im direkten Gegenüber

• Medienbewertung: Bewertung und Einstufung mehrerer Publisher für die Mediaplanung von Werbetreibenden

• Gesundheitsüberwachung: Überprüfung des Status der OpenSincera-API-Verbindung

• Fehlerbehandlung: Umfassende Fehlerbehandlung mit detaillierten Fehlermeldungen

• Eingabevalidierung: Robuste Eingabevalidierung mittels Zod-Schemas

Installation

Installieren Sie das Paket global über npm:

npm install -g opensincera-mcp-server

Voraussetzungen

• Node.js 18.0.0 oder höher

• OpenSincera API-Schlüssel

Einrichtung

1. Klonen Sie das Repository:

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

2. Installieren Sie die Abhängigkeiten:

npm install

3. Erstellen Sie das Projekt:

npm run build

4. Richten Sie die Umgebungsvariablen ein:

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

Verwendung

Starten des Servers

npm start

Entwicklung

npm run dev

Konfiguration mit Claude Desktop

Fügen Sie je nach Installationsmethode Folgendes zu Ihrer Claude Desktop-Konfigurationsdatei hinzu.

Die Datei befindet sich unter:

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

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

Option 1: Bei globaler Installation

Wenn Sie das Paket global über npm install -g installiert haben, ist der Befehl direkt im Systempfad verfügbar.

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

Option 2: Bei Verwendung eines lokalen Klons

Wenn Sie das Repository lokal geklont haben, müssen Sie den vollständigen Pfad zum Skript angeben. Denken Sie daran, /path/to/ durch den tatsächlichen absoluten Pfad zum Projektverzeichnis zu ersetzen.

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

Beispiel-Prompts für Claude Desktop

Nach der Konfiguration können Sie diese natürlichsprachlichen Prompts in Claude Desktop verwenden:

Grundlegender Gesundheitscheck

Check the OpenSincera API connection status

Suche nach Publisher-Domain

Get publisher information for yahoo.com from OpenSincera

Detaillierte Analyseanfrage

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

Vergleich auf Geräteebene

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

Wettbewerbs-Benchmarking

Compare businessinsider.com against its similar publishers

Mobil-fokussierte Medienbewertung

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

Suche nach Publisher-ID

Get detailed information for OpenSincera Publisher ID 2737

Fragen zum geschäftlichen Kontext

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?

Diese Prompts lösen automatisch die entsprechenden OpenSincera MCP-Tools aus und liefern formatierte Antworten mit detaillierten Erklärungen der Kennzahlen.

Verfügbare Tools

get_publisher_metadata

Abrufen von Publisher-Metadaten von der OpenSincera-API.

Parameter:

• publisherId (optional): Zu suchende Publisher-ID

• publisherDomain (optional): Zu suchende Publisher-Domain

• limit (optional): Maximale Anzahl der Ergebnisse (1-100)

• offset (optional): Anzahl der zu überspringenden Ergebnisse

Hinweis: Entweder publisherId oder publisherDomain muss angegeben werden.

Beispiel:

{
  "publisherDomain": "example.com"
}

get_publisher_by_domain

Abrufen eines einzelnen Publishers anhand des Domainnamens.

Parameter:

• domain (erforderlich): Zu suchende Publisher-Domain

Beispiel:

{
  "domain": "example.com"
}

get_publisher_by_id

Abrufen eines einzelnen Publishers anhand der Publisher-ID.

Parameter:

• publisherId (erforderlich): Zu suchende Publisher-ID

Beispiel:

{
  "publisherId": "12345"
}

compare_publishers

Vergleich eines Publishers mit ähnlichen Publishern (Wettbewerbs-Benchmark). Ruft den Ziel-Publisher und die von OpenSincera kuratierten ähnlichen Publisher ab und erstellt dann einen direkten Vergleich der wichtigsten Kennzahlen.

Parameter:

• domain (erforderlich): Zu benchmarkende Publisher-Domain

• device (optional): Gerätetyp für den Kennzahlenvergleich — overall (Standard), mobile oder desktop

Beispiel:

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

evaluate_media

Bewertung und Einstufung mehrerer Publisher-Domains für die Mediaplanung von Werbetreibenden. Jeder Publisher erhält eine Punktzahl (0–100) basierend auf Werbequalitätskennzahlen, Integrität der Lieferkette und Identitätsabdeckung, gewichtet nach Kampagnenziel.

Parameter:

• domains (erforderlich): Liste der zu bewertenden Publisher-Domains

• campaignGoal (optional): branding, performance oder balanced (Standard)

• language (optional): Ausgabesprache — en (Standard) oder ja

• device (optional): Gerätetyp für die Bewertung — overall (Standard), mobile oder desktop

Beispiel:

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

health_check

Überprüfung des Gesundheitsstatus der OpenSincera-API-Verbindung.

Parameter: Keine

Antwortformat

Antwort zu Publisher-Metadaten

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

Antwort zum Gesundheitscheck

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

Umgebungsvariablen

Fehlerbehandlung

Der Server bietet eine umfassende Fehlerbehandlung für häufige Szenarien:

• Authentifizierungsfehler (401): Ungültiger oder fehlender API-Schlüssel

• Autorisierungsfehler (403): Unzureichende Berechtigungen

• Nicht gefunden-Fehler (404): Publisher nicht gefunden

• Ratenbegrenzung (429): API-Ratenlimit überschritten

• Netzwerkfehler: Verbindungsprobleme oder Timeouts

• Validierungsfehler: Ungültige Eingabeparameter

Entwicklung

Skripte

• npm run build - TypeScript-Projekt bauen

• npm run dev - Im Entwicklungsmodus mit Hot-Reload ausführen

• npm test - Tests ausführen

• npm run lint - ESLint ausführen

• npm run format - Code mit Prettier formatieren

Projektstruktur

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

Mitwirken

1. Forken Sie das Repository

2. Erstellen Sie einen Feature-Branch

3. Führen Sie Ihre Änderungen durch

4. Fügen Sie Tests für neue Funktionen hinzu

5. Führen Sie die Test-Suite aus

6. Senden Sie einen Pull Request

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert - siehe die LICENSE-Datei für Details.

Support

Bei Problemen mit diesem MCP-Server öffnen Sie bitte ein Issue auf GitHub.

Für Probleme mit der OpenSincera-API wenden Sie sich bitte direkt an den OpenSincera-Support.

Changelog

v1.0.4

• Unterstützung für device_level_metrics hinzugefügt: Aufschlüsselung nach Mobilgerät und Desktop für A2CR, sichtbare Anzeigen, Anzeigenaktualisierungsrate (Durchschnitt/Min/Max) und Prozentsatz der Anzeigenplätze mit Aktualisierung

• compare_publishers-Tool hinzugefügt: Wettbewerbs-Benchmark im direkten Vergleich mit ähnlichen Publishern

• evaluate_media-Tool hinzugefügt: Bewertung und Einstufung mehrerer Publisher nach Kampagnenziel (Branding/Performance/Balanced)

• device-Parameter zu compare_publishers und evaluate_media für Analysen spezifisch für Mobilgeräte/Desktops hinzugefügt

• analysis.ts-Modul für Bewertungs- und Berichtslogik hinzugefügt

v1.0.3

• Funktionen zum Vergleich und zur Bewertung von Publishern hinzugefügt

• Struktur der Publisher-Metadaten um owner_domain, domain, parent_entity_id und similar_publishers aktualisiert

v1.0.2

• Versions-Update und Stabilitätsverbesserungen

v1.0.0

• Erstveröffentlichung

• Grundlegende Publisher-Suchfunktion

• Health-Check-Endpunkt

• Umfassende Fehlerbehandlung

• Eingabevalidierung