Entrega automatizada de conteúdo com API

Conecte o Monok ao seu CMS personalizado, aplicativo Express ou qualquer backend Node.js. Receba artigos como rascunhos por meio de nossa API simples.

Comece

Conteúdo entregue para

API poderosa para integração perfeita

O pacote @monok/server facilita a conexão de seu back-end ao Monok. Instale via npm, configure seu endpoint e comece a receber conteúdo automaticamente.

Configuração rápida

Instale o pacote com npm, crie um roteador e você estará pronto para receber artigos em minutos. Funciona com Express e qualquer estrutura Node.js.

Comece em 3 etapas

Aqui está tudo que você precisa para integrar o Monok ao seu aplicativo 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

Terminais de API

O pacote @monok/server configura automaticamente esses endpoints para comunicação com Monok

POST

/monok/push?action=draft|publish

Monok envia novos dados de artigos para este endpoint. O artigo é processado pelo seu retorno de chamada onArticle.

Cabeçalho:token: <your-api-key>

Corpo:Carga JSON contendo dados do artigo

Parâmetro de consulta:action— Defina como draft ou publish com base na seleção do usuário na GUI do Monok

GET

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

Monok busca informações do seu site para aprender sobre sua marca, categorias, tags e autores. Isso ajuda a fornecer melhores recomendações de conteúdo.

Parâmetro de consulta:apikey— Sua chave API Monok para autenticação

Configuração:Requer que o retorno de chamada getSiteInfo seja configurado

Resposta:Retorna 404 se getSiteInfo não for fornecido

Estrutura de dados do artigo

Compreendendo a carga JSON que você receberá do Monok

Campos do corpo do POST

Os artigos são enviados como objetos JSON com a seguinte estrutura

Field	Type	Description
`title`	String	O título do artigo
`shortTitle`	String	Um título mais curto para meta tags, pré-preenchido Yoast/RankMath
`description`	String	Meta descrição para SEO, pré-preenchimento Yoast/RankMath
`content`	String	O artigo como HTML pronto para WordPress
`text`	String	O artigo como markdown com widgets JSON
`slug`	String	Slug de URL gerado a partir do título, pré-preenchido Yoast/RankMath
`id`	String	ID exclusivo, acessível em monok.com/puff/ID
`thumbImageData`	String	Imagem apresentada como PNG codificado em base64
`thumbImageDescription`	String	Texto alternativo para a imagem em destaque
`language`	String	Idioma/localidade de destino (por exemplo, "fr", "fr-ca")
`type`	String	"blog" ou "notícias"
`keywords`	[String]	Matriz de palavras-chave SEO
`tags`	[String]	Matriz de tags de artigos
`vfImage`	Object	Metadados detalhados da imagem em destaque
`sections`	String	Nome da categoria do artigo

Formato do texto do artigo

O campo text contém markdown com widgets JSON incorporados para rich media, como tweets, postagens do Instagram, vídeos do YouTube e citações.

Exemplo: widget de tweet incorporado

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}

Processamento de Markdown

Divida o texto em novas linhas (\n) e valide se cada linha é markdown ou JSON. Compile o markdown para HTML usando uma biblioteca como Drawdown (~4 KB).

Tratamento de widgets JSON

Para Twitter/YouTube, insira o campo URL diretamente – o WordPress reconhece incorporações. Para Instagram, use um iframe. Ou simplesmente use o campo content para HTML pronto.

Abordagem recomendada

Para a maioria das integrações (WordPress, Strapi, etc.), use o campo content que fornece HTML pronto para WordPress. Isso é mais simples do que analisar você mesmo os widgets markdown e JSON.

Opcional, mas fortemente recomendado

Enviar linkbacks após a publicação

Deixe Monok saber onde seus artigos são publicados para permitir campanhas de mídia social e melhorar a interligação para conteúdo futuro

Exemplo de linkback

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

Acione campanhas sociais

Compartilhe automaticamente artigos publicados em plataformas de mídia social quando Monok receber o linkback

Interligação aprimorada

Monok aprende a estrutura do conteúdo publicado e sugere melhores links internos para artigos futuros

Análise de desempenho

Acompanhe o desempenho de seus artigos e obtenha insights sobre métricas de engajamento em todo o seu conteúdo

Fácil Integração

Basta chamar sendMonokLinkback() após a publicação - Monok cuida do 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.

Fluxo de trabalho simples, resultados poderosos

Instale @monok/server via npm. Crie um endpoint POST que receba dados de artigos do Monok. Salve imagens automaticamente. Publique imediatamente ou como rascunhos. Envie linkbacks quando o conteúdo for ao ar. É isso aí – Monok cuida do resto.

Solução de problemas

Problemas comuns e como resolvê-los

413 Erro de carga útil muito grande

Muitos servidores limitam a quantidade de dados que você pode enviar para eles. Quando um campo thumbImageData é enviado, ele pode exceder esse limite, gerando um erro 413 Payload Too Large.

Solution:

Certifique-se de que seu valor Nginx para client_max_body_size seja maior que 5 MB.

Restrições de endpoint

Em alguns casos, os sites têm chamadas POST e GET limitadas, restringindo endpoints por meio do Nginx.

Abra os seguintes endpoints:

• website.com/wp-json/monok/* (para WordPress)
• website.com/monok/* (para integração de API)

O curinga existe porque existem dois caminhos: as configurações do Nginx entendem os curingas.

Restrições de endereço IP

Se a sua configuração do Nginx restringir endereços IP, você precisará colocar o servidor do Monok na lista de permissões.

Solution:

Abra-o neste endereço: 51.158.177.191

O que nossos clientes dizem

Trabalhar com a Monok é uma das coisas mais inovadoras que fizemos como empresa e é definitivamente uma virada de jogo para nós. Monok é nossa arma secreta e o futuro!

Ivan Mackenzie

Chefe de, Plumjobs

Trabalhar com Monok tem sido uma de nossas melhores experiências com um provedor de serviços. O roteiro de produtos da Monok prevê consistentemente as necessidades do mercado.

Matt Kovelan

Fundador, SportsWriters

Monok nos permite dimensionar o conteúdo alinhado ao SEO sem adicionar sobrecarga interna. Os artigos são da marca, comercialmente precisos e criados para apoiar nossos funis de aquisição pagos, transformando o tráfego em crescimento mensurável de clientes.

Alexander Westerlund

Fundador, PPCjuice

Trabalhar com Monok fortaleceu a forma como publicamos em mobilen.nu. O que se destaca não é apenas a velocidade, mas a verdadeira nativização, o conteúdo não parece traduzido, parece escrito para o público sueco desde o início.

Joel Carlsson

Fundador, mobilen.nu

Eu acho que é muito bom! Usei-o para meu SaaS apoiado por ventura em chinês, o idioma era muito bom

Xunzhu Tang, PhD

Fundador, NoahCode

Trabalhar com a Monok é uma das coisas mais inovadoras que fizemos como empresa e é definitivamente uma virada de jogo para nós. Monok é nossa arma secreta e o futuro!

Ivan Mackenzie

Chefe de, Plumjobs

Trabalhar com Monok tem sido uma de nossas melhores experiências com um provedor de serviços. O roteiro de produtos da Monok prevê consistentemente as necessidades do mercado.

Matt Kovelan

Fundador, SportsWriters

Alexander Westerlund

Fundador, PPCjuice

Joel Carlsson

Fundador, mobilen.nu

Eu acho que é muito bom! Usei-o para meu SaaS apoiado por ventura em chinês, o idioma era muito bom

Xunzhu Tang, PhD

Fundador, NoahCode

Featured in

Qualquer tópico em grande escala

Cubra tópicos além do seu domínio de conhecimento em volume baixo ou alto.

Notícias locais

Bem-estar e saúde

Notícias financeiras

Notícias esportivas

Imobiliária

Fitness e desempenho

Cultura e estilo de vida

Notícias sobre criptografia e blockchain

Preços

Planos que se adaptam às suas ambições editoriais

Cada camada mantém sua produção flexível. Faça uma pausa sempre que precisar e pague apenas pelas histórias que entregamos.

Moeda

Atualizando taxas ao vivo…

Básico

Publicação automatizada Kickstart

5 €/mês

Um artigo escrito por humanos
Marketing de mídia social para cada artigo
Faça uma pausa a qualquer momento – pague apenas pelo trabalho entregue

Iniciante

Dimensione as quedas semanais de conteúdo

20 €/mês

Dois artigos escritos por humanos por semana, um curto e um longo
Marketing de mídia social para cada artigo
Faça uma pausa a qualquer momento – pague apenas pelo trabalho entregue

Personalizado

Construa sua própria casa de mídia

Você define o volume, duração e frequência/mensalmente • por artigo

Escolha a contagem de palavras, o mix vertical e o ritmo de entrega
Você escolhe a quantidade e o comprimento de cada artigo
Faça uma pausa a qualquer momento – pague apenas pelo trabalho entregue

Perguntas frequentes

Perguntas comuns sobre integração de API

@monok/server é um pacote Node.js que fornece middleware Express para receber artigos do Monok. Ele lida com autenticação, armazenamento de imagens e fornece auxiliares para publicação e notificações de linkback.

Sim, um desenvolvedor precisará configurar a integração inicial. No entanto, o pacote @monok/server torna isso simples - basta instalar via npm, configurar sua chave de API e definir como lidar com os artigos recebidos.

Dois pontos de extremidade principais: POST /monok/push recebe dados do artigo (com parâmetro de consulta opcional ?action=draft ou ?action=publish) e GET /monok/info retorna as informações do seu site, se configurado (categorias, tags, autores).

As imagens em miniatura dos artigos são enviadas como dados base64. Use o auxiliar saveThumbImage() fornecido no retorno de chamada onArticle para salvá-los automaticamente no diretório imageDir do seu servidor.

Sim. Passe uma opção imageDir para createMonokRouter() para especificar onde as imagens devem ser armazenadas. Por padrão, as imagens são salvas em './uploads'.

Um linkback notifica o Monok quando um artigo é publicado em seu site. Use sendMonokLinkback() para enviar o URL público, o título e a miniatura. Isso ajuda Monok a monitorar o desempenho e fornecer análises.

Sim! O pacote inclui declarações TypeScript integradas. Você obtém preenchimento automático completo e verificação de tipo para objetos de artigo, opções de configuração e funções auxiliares.

Atualmente @monok/server foi projetado para Express. No entanto, você pode adaptar o conceito a outras estruturas criando pontos de extremidade POST e GET semelhantes que correspondam à especificação da API.

Sua chave da API Monok está disponível nas configurações da sua conta. Armazene-o com segurança em variáveis de ambiente (como process.env.MONOK_API_KEY) e nunca envie-o para controle de versão.

O objeto do artigo inclui: id, título, texto (conteúdo HTML), slug, tags, categoria, informações do autor, dados da imagem em miniatura, idioma e outros metadados. Tipos TypeScript completos estão disponíveis no pacote.

A integração da API está incluída na sua assinatura do Monok sem nenhum custo extra. O pacote @monok/server é gratuito e de código aberto.

Sim. Execute seu aplicativo Express localmente e use uma ferramenta como o ngrok para expô-lo temporariamente à Internet. Adicione o URL do ngrok às configurações do Monok para teste.

Comece a integrar hoje

Conecte o Monok à sua plataforma em minutos com nossa poderosa API.

Comece

Produto

Hospedagem

Tecnologia

Integrações