Consegna automatica dei contenuti via API

Collega Monok al tuo CMS personalizzato, alla tua app Express o a qualsiasi backend Node.js. Ricevi gli articoli come bozze tramite la nostra semplice API.

Prova gratis

Contenuti consegnati a

Un'API potente per un'integrazione semplice

Il pacchetto @monok/server semplifica il collegamento del tuo backend a Monok. Installalo tramite npm, configura il tuo endpoint e inizia a ricevere contenuti automaticamente.

Configurazione rapida

Installa il pacchetto con npm, crea un router e ricevi articoli in pochi minuti. Funziona con Express e qualsiasi framework Node.js.

Inizia in tre passaggi

Ecco tutto ciò che serve per integrare Monok con la tua app Express:

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

Endpoint API

Il pacchetto @monok/server configura automaticamente questi endpoint per comunicare con Monok

POST

/monok/push?action=draft|publish

Monok invia i dati dei nuovi articoli a questo endpoint. L'articolo viene elaborato dalla callback onArticle.

Header:token: <your-api-key>

Corpo:Payload JSON contenente i dati dell'articolo

Parametro di query:action— Imposta draft o publish in base alla scelta dell'utente nell'interfaccia Monok

GET

/monok/info?apikey=<your-api-key>

Monok recupera le informazioni del tuo sito per conoscere il tuo brand, le categorie, i tag e gli autori. Questo consente di suggerire contenuti più pertinenti.

Parametro di query:apikey— La tua chiave API Monok per l'autenticazione

Configurazione:Richiede la configurazione della callback getSiteInfo

Risposta:Restituisce 404 se getSiteInfo non è definita

Struttura dei dati dell'articolo

Scopri il payload JSON che riceverai da Monok

Campi del corpo POST

Gli articoli vengono inviati come oggetti JSON con la seguente struttura

Field	Type	Description
`title`	String	Titolo dell'articolo
`shortTitle`	String	Titolo breve per i meta tag, precompila Yoast/RankMath
`description`	String	Meta descrizione SEO, precompila Yoast/RankMath
`content`	String	Articolo in HTML pronto per WordPress
`text`	String	Articolo in Markdown con widget JSON
`slug`	String	Slug URL generato dal titolo, precompila Yoast/RankMath
`id`	String	ID univoco, accessibile su monok.com/puff/ID
`thumbImageData`	String	Immagine in evidenza come PNG codificato in base64
`thumbImageDescription`	String	Testo alternativo dell'immagine in evidenza
`language`	String	Lingua/locale di destinazione (ad es. "fr", "fr-ca")
`type`	String	"blog" o "news"
`keywords`	[String]	Array di parole chiave SEO
`tags`	[String]	Array di tag dell'articolo
`vfImage`	Object	Metadati dettagliati dell'immagine in evidenza
`sections`	String	Nome della categoria dell'articolo

Formato del testo dell'articolo

Il campo text contiene Markdown con widget JSON incorporati per tweet, post Instagram, video YouTube e citazioni.

Esempio: widget di tweet incorporato

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}

Elaborare il Markdown

Dividi il testo in corrispondenza delle interruzioni di riga (\n) e verifica se ogni riga contiene Markdown o JSON. Converti il Markdown in HTML con una libreria come Drawdown (~4 KB).

Gestire i widget JSON

Per Twitter/YouTube, inserisci direttamente il campo URL: WordPress riconosce i contenuti incorporati. Per Instagram, usa un iframe. In alternativa, usa il campo content per ottenere HTML pronto all'uso.

Approccio consigliato

Per la maggior parte delle integrazioni (WordPress, Strapi, ecc.), usa il campo content, che fornisce HTML pronto per WordPress. È più semplice che interpretare da solo Markdown e widget JSON.

Facoltativo ma fortemente consigliato

Invia i link dopo la pubblicazione

Comunica a Monok dove vengono pubblicati i tuoi articoli per attivare campagne sui social e migliorare i link interni nei contenuti futuri

Esempio di notifica con link

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});

Avvia campagne sui social

Condividi automaticamente gli articoli pubblicati sui social quando Monok riceve il link

Link interni più pertinenti

Monok apprende la struttura dei contenuti pubblicati e suggerisce link interni migliori per gli articoli futuri

Analisi delle prestazioni

Monitora i risultati degli articoli e scopri come gli utenti interagiscono con i tuoi contenuti

Integrazione semplice

Chiama sendMonokLinkback() dopo la pubblicazione: Monok si occupa del resto

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.

Un flusso semplice, risultati concreti

Installa @monok/server tramite npm. Crea un endpoint POST che riceva i dati degli articoli da Monok. Salva le immagini automaticamente. Pubblica subito o salva come bozza. Invia il link quando il contenuto è online. Monok si occupa del resto.

Risoluzione dei problemi

Problemi comuni e come risolverli

Errore 413 Payload Too Large

Molti server limitano la quantità di dati che possono ricevere. Il campo thumbImageData può superare tale limite e causare un errore 413 Payload Too Large.

Solution:

Assicurati che il valore Nginx di client_max_body_size sia superiore a 5 MB.

Restrizioni degli endpoint

Alcuni siti limitano le chiamate POST e GET restringendo l'accesso agli endpoint tramite Nginx.

Consenti l'accesso ai seguenti endpoint:

• website.com/wp-json/monok/* (per WordPress)
• website.com/monok/* (per l'integrazione API)

Il carattere jolly rappresenta i due percorsi: gestiscili nella tua configurazione Nginx.

Restrizioni degli indirizzi IP

Se la configurazione Nginx limita gli indirizzi IP, devi autorizzare il server di Monok.

Solution:

Autorizza questo indirizzo: 51.158.177.191

Cosa dicono i nostri clienti

Penso che sia davvero fantastico! L'ho usato per la mia SaaS supportata da venture in cinese, la lingua era davvero buona

Xunzhu Tang, PhD

Fondatore, NoahCode

Collaborare con Monok è una delle mosse più innovative che abbiamo fatto e ha davvero cambiato il gioco per noi. Monok è la nostra arma segreta e il futuro!

Ivan Mackenzie

Responsabile team, Plumjobs

Lavorare con Monok è stata una delle migliori esperienze con un fornitore di servizi. La roadmap di prodotto di Monok anticipa costantemente i bisogni del mercato.

Matt Kovelan

Fondatore, SportsWriters

Monok si è dimostrato il partner ideale e in un attimo ci ha portati anni avanti, cambiando radicalmente la flessibilità della nostra offerta.

Michael Davids

Amministratore delegato, Splendor

Penso che sia davvero fantastico! L'ho usato per la mia SaaS supportata da venture in cinese, la lingua era davvero buona

Xunzhu Tang, PhD

Fondatore, NoahCode

Collaborare con Monok è una delle mosse più innovative che abbiamo fatto e ha davvero cambiato il gioco per noi. Monok è la nostra arma segreta e il futuro!

Ivan Mackenzie

Responsabile team, Plumjobs

Lavorare con Monok è stata una delle migliori esperienze con un fornitore di servizi. La roadmap di prodotto di Monok anticipa costantemente i bisogni del mercato.

Matt Kovelan

Fondatore, SportsWriters

Monok si è dimostrato il partner ideale e in un attimo ci ha portati anni avanti, cambiando radicalmente la flessibilità della nostra offerta.

Michael Davids

Amministratore delegato, Splendor

Featured in

Qualsiasi argomento in scala

Copri argomenti oltre la tua conoscenza a basso o alto volume.

Notizie Locali

Benessere e Salute

Notizie Finanziarie

Notizie Sportive

Immobiliare

Fitness e Performance

Cultura e Lifestyle

Notizie Crypto e Blockchain

Prezzi

Piani che crescono con le tue ambizioni

Ogni piano mantiene la produzione flessibile. Metti in pausa quando vuoi e paghi solo ciò che consegnamo.

Valuta

Aggiornamento tassi…

Basic

Inizia con la pubblicazione automatica

5 €/mese

Un articolo scritto da persone
Marketing social per ogni articolo
Pausa quando vuoi — paghi solo il lavoro consegnato

Starter

Scala i contenuti settimanali

20 €/mese

Due articoli a settimana, uno breve e uno lungo
Marketing social per ogni articolo
Pausa quando vuoi — paghi solo il lavoro consegnato

Custom

Costruisci la tua media house

Tu scegli volume, lunghezza e frequenza/mensile • per articolo

Scegli conteggio parole, mix verticale e ritmo
Decidi quantità e lunghezza di ogni articolo
Pausa quando vuoi — paghi solo il lavoro consegnato

Domande frequenti

Domande frequenti sull'integrazione API

@monok/server è un pacchetto Node.js che offre middleware Express per ricevere articoli da Monok. Gestisce autenticazione e salvataggio delle immagini e include funzioni per la pubblicazione e l'invio dei link degli articoli pubblicati.

Sì, l'integrazione iniziale richiede uno sviluppatore. Il pacchetto @monok/server semplifica il lavoro: installalo tramite npm, configura la chiave API e definisci come gestire gli articoli in arrivo.

Due endpoint principali: POST /monok/push riceve i dati degli articoli (con il parametro facoltativo ?action=draft o ?action=publish), mentre GET /monok/info restituisce le informazioni del sito, se configurate (categorie, tag e autori).

Le immagini in evidenza vengono inviate come dati base64. Usa la funzione saveThumbImage() nella callback onArticle per salvarle automaticamente nella directory imageDir del server.

Sì. Passa l'opzione imageDir a createMonokRouter() per specificare la cartella. Per impostazione predefinita, le immagini vengono salvate in './uploads'.

Informa Monok quando un articolo viene pubblicato sul tuo sito. Usa sendMonokLinkback() per inviare URL pubblico, titolo e immagine in evidenza. Monok può così monitorare le prestazioni e fornire statistiche.

Sì! Il pacchetto include dichiarazioni TypeScript. Hai completamento automatico e controllo dei tipi per gli oggetti articolo, le opzioni di configurazione e le funzioni di supporto.

Al momento @monok/server è progettato per Express. Puoi adattare il concetto ad altri framework creando endpoint POST e GET conformi alla specifica dell'API.

La chiave API Monok è disponibile nelle impostazioni dell'account. Conservala in modo sicuro nelle variabili d'ambiente (come process.env.MONOK_API_KEY) e non inserirla mai nel controllo di versione.

L'oggetto articolo include id, title, text, content (HTML), slug, tag, categoria, informazioni sull'autore, dati dell'immagine, lingua e altri metadati. I tipi TypeScript completi sono disponibili nel pacchetto.

No. L'integrazione API è inclusa nell'abbonamento Monok senza costi aggiuntivi. Il pacchetto @monok/server è gratuito e open source.

Sì. Avvia l'app Express in locale e usa uno strumento come ngrok per renderla temporaneamente accessibile su Internet. Aggiungi l'URL ngrok alle impostazioni Monok per i test.

Inizia oggi la tua integrazione

Collega Monok alla tua piattaforma in pochi minuti con la nostra potente API.

Inizia

Prodotto

Hosting

Tecnologia

Integrazioni