通过 API 自动交付内容

将 Monok 连接到你的自定义 CMS、Express 应用或任意 Node.js 后端。通过简单易用的 API 接收文章草稿。

内容已交付至

强大的 API,轻松集成

@monok/server 软件包让后端与 Monok 的连接更简单。通过 npm 安装,配置端点,即可自动接收内容。

通过 npm 快速配置

快速配置

使用 npm 安装软件包,创建路由,几分钟内即可开始接收文章。支持 Express 和各种 Node.js 框架。

三步开始使用

将 Monok 集成到 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

Configure webhook in Monok settings

API 端点

@monok/server 软件包会自动配置以下端点,用于与 Monok 通信

POST
/monok/push?action=draft|publish

Monok 将新文章数据推送到此端点,由你的 onArticle 回调处理。

请求头:token: <your-api-key>
请求体:包含文章数据的 JSON 负载
查询参数:action— 根据用户在 Monok 界面中的选择,设为 draft 或 publish
GET
/monok/info?apikey=<your-api-key>

Monok 获取你的网站信息,了解品牌、分类、标签和作者,从而提供更合适的内容推荐。

查询参数:apikey— 用于身份验证的 Monok API 密钥
配置:需要配置 getSiteInfo 回调
响应:未提供 getSiteInfo 时返回 404

文章数据结构

了解 Monok 发送的 JSON 数据

POST 请求体字段

文章以 JSON 对象形式发送,结构如下

FieldTypeDescription
titleString文章标题
shortTitleString用于元标签的短标题,可预填 Yoast/RankMath
descriptionString用于 SEO 的元描述,可预填 Yoast/RankMath
contentString可直接用于 WordPress 的 HTML 文章
textString包含 JSON 组件的 Markdown 文章
slugString根据标题生成的 URL slug,可预填 Yoast/RankMath
idString唯一 ID,可通过 monok.com/puff/ID 访问
thumbImageDataString以 base64 编码的 PNG 特色图片
thumbImageDescriptionString特色图片的替代文本
languageString目标语言/区域设置(例如 "fr"、"fr-ca")
typeString"blog" 或 "news"
keywords[String]SEO 关键词数组
tags[String]文章标签数组
vfImageObject特色图片的详细元数据
sectionsString文章分类名称

文章文本格式

text 字段包含 Markdown,并嵌入 JSON 组件,用于呈现推文、Instagram 帖子、YouTube 视频和引用等丰富内容。

示例:嵌入式推文组件

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

按换行符(\n)拆分文本,判断每一行是 Markdown 还是 JSON。使用 Drawdown(约 4 KB)等库将 Markdown 转换为 HTML。

处理 JSON 组件

对于 Twitter/YouTube,直接插入 URL 字段即可,WordPress 会识别嵌入内容。Instagram 可使用 iframe。也可以直接使用 content 字段获取现成的 HTML。

推荐方式

对于大多数集成(WordPress、Strapi 等),建议使用 content 字段,获取可直接用于 WordPress 的 HTML。这比自行解析 Markdown 和 JSON 组件更简单。

可选,但强烈建议

发布后回传文章链接

告诉 Monok 文章的发布地址,以启用社交媒体推广,并改善后续内容的内部链接

链接回传示例

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

启动社交媒体推广

Monok 收到回传链接后,自动在社交媒体平台分享已发布的文章

优化内部链接

Monok 了解已发布内容的结构,为后续文章推荐更合适的内部链接

效果分析

跟踪文章表现,了解各篇内容的互动指标

轻松集成

发布后调用 sendMonokLinkback() 即可,其余工作交给 Monok

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.

简单流程,高效交付

通过 npm 安装 @monok/server。创建 POST 端点以接收 Monok 的文章数据,自动保存图片,立即发布或存为草稿。内容上线后,将文章链接回传给 Monok。其余工作交给 Monok。

故障排查

常见问题及解决方法

413 Payload Too Large 错误

许多服务器会限制接收的数据量。发送 thumbImageData 字段时,可能超出限制,导致 413 Payload Too Large 错误。

Solution:

请确保 Nginx 的 client_max_body_size 值大于 5 MB。

端点访问限制

部分网站通过 Nginx 限制端点访问,从而限制 POST 和 GET 请求。

请允许访问以下端点:

  • • website.com/wp-json/monok/*(用于 WordPress)
  • • website.com/monok/*(用于 API 集成)

通配符代表两个路径,请在 Nginx 配置中相应处理。

IP 地址限制

如果 Nginx 配置限制了 IP 地址,请将 Monok 服务器加入允许列表。

Solution:

请允许此地址:51.158.177.191

客户评价

我觉得非常好!我在我的风投支持的中文SaaS中使用了它,语言非常好

唐勋竹博士

唐勋竹博士

创始人, NoahCode

Plumjobs

与Monok合作是我们作为企业所做的最具创新性的事情之一,对我们来说绝对是一个游戏规则改变者。Monok是我们的秘密武器和未来!

Ivan Mackenzie

Ivan Mackenzie

负责人, Plumjobs

SportsWriters

与Monok合作是我们与服务提供商合作的最佳体验之一。Monok的产品路线图始终如一地预测市场需求。

Matt Kovelan

Matt Kovelan

创始人, SportsWriters

Monok已被证明是理想的合作伙伴,一举让我们领先了数年,并显著改变了我们客户产品的灵活性。

Michael Davids

Michael Davids

首席执行官, Splendor

我觉得非常好!我在我的风投支持的中文SaaS中使用了它,语言非常好

唐勋竹博士

唐勋竹博士

创始人, NoahCode

Plumjobs

与Monok合作是我们作为企业所做的最具创新性的事情之一,对我们来说绝对是一个游戏规则改变者。Monok是我们的秘密武器和未来!

Ivan Mackenzie

Ivan Mackenzie

负责人, Plumjobs

SportsWriters

与Monok合作是我们与服务提供商合作的最佳体验之一。Monok的产品路线图始终如一地预测市场需求。

Matt Kovelan

Matt Kovelan

创始人, SportsWriters

Monok已被证明是理想的合作伙伴,一举让我们领先了数年,并显著改变了我们客户产品的灵活性。

Michael Davids

Michael Davids

首席执行官, Splendor

Featured in

任何主题规模化

覆盖知识领域外的主题,低量或高量均可。

Cover 1
本地新闻
Cover 2
健康养生
Cover 3
金融新闻
Cover 4
体育新闻
Cover 5
房地产
Cover 6
健身表现
Cover 7
文化生活
Cover 8
加密区块链

定价

随编辑规模扩展的方案

所有方案保持生产灵活。随时暂停,只为交付内容付费。

货币

更新汇率中…

Basic

Paper plane preparing for takeoff
5 €/月
  • 一篇人工撰写的文章
  • 每篇文章的社交媒体营销
  • 随时暂停 — 只为交付工作付费
适合按月测试Monok。

Starter

Paper plane climbing in altitude
20 €/月
  • 每周两篇文章,一短一长
  • 每篇文章的社交媒体营销
  • 随时暂停 — 只为交付工作付费
适合用可靠流程替代自由职业者的团队。

Custom

Paper plane in formation
您设定数量、长度和频率/月 • 每篇
  • 选择字数、垂直混合和交付节奏
  • 您决定每篇文章的数量和长度
  • 随时暂停 — 只为交付工作付费
完全控制 — 随时启动或暂停内容流

常见问题

API 集成常见问题

@monok/server 是一个 Node.js 软件包,提供 Express 中间件,用于接收 Monok 的文章。它负责身份验证和图片存储,并提供发布及链接回传的辅助函数。

需要,首次集成需由开发者完成。不过,@monok/server 软件包简化了流程:通过 npm 安装,配置 API 密钥,然后定义如何处理收到的文章。

主要有两个端点:POST /monok/push 接收文章数据(支持可选查询参数 ?action=draft 或 ?action=publish);GET /monok/info 在配置后返回网站信息,包括分类、标签和作者。

文章的特色图片以 base64 数据发送。使用 onArticle 回调中的 saveThumbImage() 辅助函数,即可自动将图片保存到服务器的 imageDir 目录。

可以。向 createMonokRouter() 传入 imageDir 选项,指定存储位置。默认保存到 './uploads'。

文章在你的网站发布后,链接回传会通知 Monok。使用 sendMonokLinkback() 发送公开 URL、标题和特色图片,帮助 Monok 跟踪效果并提供分析数据。

支持!软件包内置 TypeScript 类型声明,为文章对象、配置选项和辅助函数提供完整的自动补全和类型检查。

目前 @monok/server 专为 Express 设计。你可以在其他框架中创建符合 API 规范的 POST 和 GET 端点,实现类似的集成。

你可以在 Monok 账户设置中找到 API 密钥。请将其安全地保存在环境变量中(如 process.env.MONOK_API_KEY),切勿提交到版本控制系统。

文章对象包含 id、title、text、content(HTML)、slug、标签、分类、作者信息、图片数据、语言及其他元数据。软件包中提供完整的 TypeScript 类型。

不需要。Monok 订阅已包含 API 集成,无需额外付费。@monok/server 软件包免费且开源。

可以。在本地运行 Express 应用,使用 ngrok 等工具临时将其开放到互联网,然后在 Monok 设置中添加 ngrok URL 即可测试。

立即开始集成

通过强大的 API,只需几分钟即可将 Monok 连接到你的平台。