Automatische Inhaltslieferung per API

Verbinden Sie Monok mit Ihrem eigenen CMS, Ihrer Express-App oder einem beliebigen Node.js-Backend. Empfangen Sie Artikel als Entwürfe über unsere einfach einzubindende API.

Inhalte geliefert an

Leistungsstarke API für eine nahtlose Integration

Mit dem Paket @monok/server verbinden Sie Ihr Backend einfach mit Monok. Installieren Sie es über npm, konfigurieren Sie Ihren Endpunkt und empfangen Sie Inhalte automatisch.

Schnelle Einrichtung mit npm

Schnelle Einrichtung

Installieren Sie das Paket mit npm, erstellen Sie einen Router und empfangen Sie in wenigen Minuten Artikel. Funktioniert mit Express und allen Node.js-Frameworks.

In drei Schritten starten

Alles, was Sie für die Integration von Monok in Ihre Express-App brauchen:

1. Install the package

Install the package

1npm install @monok/server express

2. Create the router

Create the router

1import express from "express";
2import { createMonokRouter } from "@monok/server";
3
4const app = express();
5
6app.use(
7 "/monok",
8 createMonokRouter({
9 apiKey: process.env.MONOK_API_KEY!,
10 onArticle: async (article, { saveThumbImage, action }) => {
11 const imagePath = await saveThumbImage();
12
13 if (action === "publish") {
14 // publish immediately in your CMS
15 } else {
16 // save as draft (default)
17 }
18 }
19 })
20);
21
22app.listen(3000);

3. Configure your webhook

Add your endpoint URL to Monok settings: https://yoursite.com/monok

Configure webhook in Monok settings

API-Endpunkte

Das Paket @monok/server richtet diese Endpunkte für die Kommunikation mit Monok automatisch ein

POST
/monok/push?action=draft|publish

Monok sendet neue Artikeldaten an diesen Endpunkt. Ihr onArticle-Callback verarbeitet den Artikel.

Header:token: <your-api-key>
Body:JSON-Nutzdaten mit den Artikeldaten
Abfrageparameter:action— Setzen Sie draft oder publish entsprechend der Auswahl in der Monok-Oberfläche
GET
/monok/info?apikey=<your-api-key>

Monok ruft Informationen zu Ihrer Website ab, um Ihre Marke, Kategorien, Tags und Autoren kennenzulernen. Das ermöglicht bessere Inhaltsempfehlungen.

Abfrageparameter:apikey— Ihr Monok-API-Schlüssel zur Authentifizierung
Konfiguration:Der Callback getSiteInfo muss konfiguriert sein
Antwort:Gibt 404 zurück, wenn getSiteInfo nicht angegeben ist

Datenstruktur eines Artikels

Die JSON-Nutzdaten von Monok verstehen

Felder im POST-Body

Artikel werden als JSON-Objekte mit folgender Struktur gesendet

FieldTypeDescription
titleStringTitel des Artikels
shortTitleStringKürzerer Titel für Meta-Tags, füllt Yoast/RankMath vorab aus
descriptionStringSEO-Meta-Beschreibung, füllt Yoast/RankMath vorab aus
contentStringArtikel als HTML für WordPress
textStringArtikel als Markdown mit JSON-Widgets
slugStringAus dem Titel erzeugter URL-Slug, füllt Yoast/RankMath vorab aus
idStringEindeutige ID, abrufbar unter monok.com/puff/ID
thumbImageDataStringBeitragsbild als Base64-kodiertes PNG
thumbImageDescriptionStringAlternativtext für das Beitragsbild
languageStringZielsprache/Gebietsschema (z. B. "fr", "fr-ca")
typeString"blog" oder "news"
keywords[String]Array mit SEO-Keywords
tags[String]Array mit Artikel-Tags
vfImageObjectDetaillierte Metadaten des Beitragsbilds
sectionsStringKategoriename des Artikels

Format des Artikeltexts

Das Feld text enthält Markdown mit eingebetteten JSON-Widgets für Tweets, Instagram-Beiträge, YouTube-Videos und Zitate.

Beispiel: Widget für einen eingebetteten Tweet

JSON Widget in Article Text

1{
2 "data": [
3 {
4 "name": "Phil Spencer",
5 "text": "Had good calls this week with leaders at Sony..."
6 }
7 ],
8 "id": "1484273335139651585",
9 "type": "twitter",
10 "url": "https://twitter.com/XboxP3/status/1484273335139651585",
11 "username": "XboxP3"
12}

Markdown verarbeiten

Teilen Sie den Text an Zeilenumbrüchen (\n) auf und prüfen Sie, ob jede Zeile Markdown oder JSON enthält. Wandeln Sie Markdown mit einer Bibliothek wie Drawdown (~4 KB) in HTML um.

JSON-Widgets verarbeiten

Für Twitter/YouTube können Sie das URL-Feld direkt einfügen – WordPress erkennt die Einbettungen. Verwenden Sie für Instagram ein iframe. Alternativ liefert das Feld content fertiges HTML.

Empfohlenes Vorgehen

Verwenden Sie für die meisten Integrationen (WordPress, Strapi usw.) das Feld content mit fertigem HTML für WordPress. Das ist einfacher, als Markdown und JSON-Widgets selbst zu verarbeiten.

Optional, aber ausdrücklich empfohlen

Links nach der Veröffentlichung zurückmelden

Teilen Sie Monok mit, wo Ihre Artikel veröffentlicht sind, um Social-Media-Kampagnen zu ermöglichen und die interne Verlinkung künftiger Inhalte zu verbessern

Beispiel einer Link-Rückmeldung

1import { sendMonokLinkback } from "@monok/server";
2
3await sendMonokLinkback({
4 monokId: article.id,
5 publicUrl: "https://example.com/blog/" + (article.slug ?? article.id),
6 title: article.title,
7 articleTextSample: article.text?.slice(0, 500),
8 thumbnailUrl: "https://example.com/uploads/" + imageFile
9});

Social-Media-Kampagnen starten

Teilen Sie veröffentlichte Artikel automatisch in sozialen Netzwerken, sobald Monok die Link-Rückmeldung erhält

Bessere interne Verlinkung

Monok lernt die Struktur Ihrer veröffentlichten Inhalte kennen und schlägt bessere interne Links für künftige Artikel vor

Leistungsanalyse

Verfolgen Sie die Leistung Ihrer Artikel und erhalten Sie Einblicke in die Interaktionen mit Ihren Inhalten

Einfache Integration

Rufen Sie nach der Veröffentlichung einfach sendMonokLinkback() auf – Monok erledigt den Rest

Advanced Configuration

Enhanced Integration with Site Info

Provide your site information to Monok for better content matching. Monok will automatically align categories, authors, and tags with your existing structure.

Advanced Setup with Site Info

1import express from "express";
2import {
3 createMonokRouter,
4 sendMonokLinkback,
5 type MonokArticle
6} from "@monok/server";
7
8const app = express();
9
10app.use(
11 "/monok",
12 createMonokRouter({
13 apiKey: process.env.MONOK_API_KEY!,
14 imageDir: "./uploads", // optional
15 // Optional: provide site info if you want Monok to query it
16 getSiteInfo: {
17 js_scripts: "Enabled",
18 version: "1.0.0",
19 name: "My Site",
20 logo: "https://example.com/logo.png",
21 categories: ["Content", "News Articles", "Uncategorized"],
22 post_types: ["post", "page"],
23 tags: ["Tech", "Health", "News"],
24 authors: [
25 {
26 name: "Jane Doe",
27 profile: "Editor-in-chief",
28 id: "1",
29 avatar: "https://example.com/avatars/jane.png",
30 roles: ["administrator"]
31 }
32 ]
33 },
34 onArticle: async (article: MonokArticle, { saveThumbImage, action }) => {
35 const imagePath = await saveThumbImage();
36 console.log("Received article:", article.title);
37
38 if (action === "publish") {
39 // publish immediately
40 } else {
41 // save as draft
42 }
43
44 // when you publish later, notify Monok:
45 // await sendMonokLinkback({
46 // monokId: article.id,
47 // publicUrl: "https://example.com/blog/" + (article.slug ?? article.id),
48 // title: article.title,
49 // articleTextSample: article.text?.slice(0, 500),
50 // thumbnailUrl: imagePath
51 // ? "https://example.com/uploads/" + require("path").basename(imagePath)
52 // : undefined
53 // });
54 }
55 })
56);
57
58app.listen(3000);

Automatic Category Matching

Monok learns your existing categories and automatically assigns articles to the most relevant ones based on content analysis.

Author Attribution

Provide your author list so Monok can suggest or assign the appropriate author to each article based on topic and expertise.

Smart Tag Suggestions

Monok uses your existing tag taxonomy to suggest relevant tags for each article, maintaining consistency across your content.

Branding Integration

Share your site name and logo with Monok to ensure all generated content aligns with your brand identity and guidelines.

Optional but Highly Recommended

The getSiteInfo configuration is entirely optional. However, providing this information significantly improves content quality and relevance by allowing Monok to understand your site's structure and existing content organization.

Einfacher Ablauf, starke Ergebnisse

Installieren Sie @monok/server über npm. Erstellen Sie einen POST-Endpunkt für Artikeldaten von Monok. Speichern Sie Bilder automatisch. Veröffentlichen Sie sofort oder speichern Sie Entwürfe. Melden Sie veröffentlichte Artikel mit ihrem Link zurück. Monok erledigt den Rest.

Fehlerbehebung

Häufige Probleme und ihre Lösungen

Fehler 413 Payload Too Large

Viele Server begrenzen die übertragbare Datenmenge. Das Feld thumbImageData kann diese Grenze überschreiten und den Fehler 413 Payload Too Large auslösen.

Solution:

Stellen Sie sicher, dass der Nginx-Wert für client_max_body_size größer als 5 MB ist.

Eingeschränkte Endpunkte

Manche Websites begrenzen POST- und GET-Aufrufe, indem sie Endpunkte in Nginx einschränken.

Geben Sie folgende Endpunkte frei:

  • • website.com/wp-json/monok/* (für WordPress)
  • • website.com/monok/* (für die API-Integration)

Der Platzhalter steht für die beiden Pfade. Berücksichtigen Sie diese in Ihrer Nginx-Konfiguration.

IP-Adressbeschränkungen

Wenn Ihre Nginx-Konfiguration IP-Adressen einschränkt, müssen Sie den Monok-Server freigeben.

Solution:

Geben Sie diese Adresse frei: 51.158.177.191

Was unsere Kunden sagen

Ich finde es sehr gut! Ich habe es für mein Venture-backed SaaS auf Chinesisch genutzt, die Sprache war sehr gut

Xunzhu Tang, PhD

Xunzhu Tang, PhD

Gründer, NoahCode

Plumjobs

Mit Monok zu arbeiten ist eines der innovativsten Dinge die wir als Business gemacht haben und definitiv ein Game Changer für uns. Monok ist unsere Geheimwaffe und die Zukunft!

Ivan Mackenzie

Ivan Mackenzie

Leiter, Plumjobs

SportsWriters

Mit Monok zu arbeiten war eine unserer besten Erfahrungen mit einem Service Provider. Monoks Product Roadmap sagt konstant Marktbedürfnisse voraus.

Matt Kovelan

Matt Kovelan

Gründer, SportsWriters

Monok hat sich als idealer Partner erwiesen und uns mit einem Schlag Jahre voraus gebracht und die Flexibilität unseres Client-Angebots dramatisch verändert.

Michael Davids

Michael Davids

CEO, Splendor

Ich finde es sehr gut! Ich habe es für mein Venture-backed SaaS auf Chinesisch genutzt, die Sprache war sehr gut

Xunzhu Tang, PhD

Xunzhu Tang, PhD

Gründer, NoahCode

Plumjobs

Mit Monok zu arbeiten ist eines der innovativsten Dinge die wir als Business gemacht haben und definitiv ein Game Changer für uns. Monok ist unsere Geheimwaffe und die Zukunft!

Ivan Mackenzie

Ivan Mackenzie

Leiter, Plumjobs

SportsWriters

Mit Monok zu arbeiten war eine unserer besten Erfahrungen mit einem Service Provider. Monoks Product Roadmap sagt konstant Marktbedürfnisse voraus.

Matt Kovelan

Matt Kovelan

Gründer, SportsWriters

Monok hat sich als idealer Partner erwiesen und uns mit einem Schlag Jahre voraus gebracht und die Flexibilität unseres Client-Angebots dramatisch verändert.

Michael Davids

Michael Davids

CEO, Splendor

Featured in

Jedes Thema im großen Maßstab

Deckt Themen außerhalb eurer Wissensdomäne ab, in geringem oder hohem Volumen.

Cover 1
Lokale News
Cover 2
Wellness & Gesundheit
Cover 3
Finanz-News
Cover 4
Sport-News
Cover 5
Immobilien
Cover 6
Fitness & Performance
Cover 7
Kultur & Lifestyle
Cover 8
Krypto & Blockchain News

Preise

Pläne die mit euren redaktionellen Ambitionen skalieren

Jede Stufe hält eure Produktion flexibel. Pausiert wann immer ihr wollt und zahlt nur für gelieferte Stories.

Währung

Aktualisiere Live-Kurse…

Basic

Paper plane preparing for takeoff
5 €/Monat
  • Ein von Menschen geschriebener Artikel
  • Social Media Marketing für jeden Artikel
  • Jederzeit pausieren, nur für gelieferte Arbeit zahlen
Ideal um Monok mit monatlicher Produktion zu testen.

Starter

Paper plane climbing in altitude
20 €/Monat
  • Zwei von Menschen geschriebene Artikel pro Woche, einer kurz und einer lang
  • Social Media Marketing für jeden Artikel
  • Jederzeit pausieren, nur für gelieferte Arbeit zahlen
Perfekt für Teams die Freelancer durch verlässlichen Workflow ersetzen.

Custom

Paper plane in formation
Ihr bestimmt Volumen, Länge und Frequenz/monatlich • pro Artikel
  • Wählt Wortzahlen, vertikalen Mix und Lieferrhythmus
  • Ihr wählt Menge und Länge jedes Artikels
  • Jederzeit pausieren, nur für gelieferte Arbeit zahlen
Volle Kontrolle, startet oder pausiert eure Content-Feeds wann ihr wollt

Häufige Fragen

Häufige Fragen zur API-Integration

@monok/server ist ein Node.js-Paket mit Express-Middleware zum Empfang von Artikeln von Monok. Es übernimmt Authentifizierung und Bildspeicherung und bietet Hilfsfunktionen für die Veröffentlichung und Link-Rückmeldungen.

Ja, ein Entwickler muss die Integration zunächst einrichten. Das Paket @monok/server vereinfacht die Arbeit: über npm installieren, API-Schlüssel konfigurieren und die Verarbeitung eingehender Artikel festlegen.

Zwei zentrale Endpunkte: POST /monok/push empfängt Artikeldaten (mit dem optionalen Abfrageparameter ?action=draft oder ?action=publish). GET /monok/info liefert bei entsprechender Konfiguration Website-Informationen wie Kategorien, Tags und Autoren.

Beitragsbilder werden als Base64-Daten gesendet. Mit der Hilfsfunktion saveThumbImage() im onArticle-Callback speichern Sie diese automatisch im imageDir-Verzeichnis Ihres Servers.

Ja. Übergeben Sie die Option imageDir an createMonokRouter(), um den Speicherort festzulegen. Standardmäßig werden Bilder unter './uploads' gespeichert.

Sie informiert Monok, wenn ein Artikel auf Ihrer Website veröffentlicht wird. Senden Sie mit sendMonokLinkback() die öffentliche URL, den Titel und das Beitragsbild. So kann Monok die Leistung verfolgen und Analysen bereitstellen.

Ja! Das Paket enthält TypeScript-Deklarationen. Sie erhalten Autovervollständigung und Typprüfung für Artikelobjekte, Konfigurationsoptionen und Hilfsfunktionen.

Derzeit ist @monok/server für Express ausgelegt. Sie können das Konzept auf andere Frameworks übertragen, indem Sie entsprechende POST- und GET-Endpunkte gemäß der API-Spezifikation erstellen.

Ihren Monok-API-Schlüssel finden Sie in den Kontoeinstellungen. Speichern Sie ihn sicher in Umgebungsvariablen wie process.env.MONOK_API_KEY und übernehmen Sie ihn niemals in die Versionsverwaltung.

Das Artikelobjekt enthält id, title, text, content (HTML), slug, Tags, Kategorie, Autoreninformationen, Bilddaten, Sprache und weitere Metadaten. Vollständige TypeScript-Typen sind im Paket enthalten.

Nein. Die API-Integration ist ohne Aufpreis in Ihrem Monok-Abonnement enthalten. Das Paket @monok/server ist kostenlos und Open Source.

Ja. Starten Sie Ihre Express-App lokal und machen Sie sie mit einem Tool wie ngrok vorübergehend über das Internet erreichbar. Tragen Sie die ngrok-URL zum Testen in den Monok-Einstellungen ein.

Starten Sie Ihre Integration noch heute

Verbinden Sie Monok in wenigen Minuten über unsere leistungsstarke API mit Ihrer Plattform.