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


























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

使用 npm 安装软件包,创建路由,几分钟内即可开始接收文章。支持 Express 和各种 Node.js 框架。
将 Monok 集成到 Express 应用所需的步骤:
Install the package
1npm install @monok/server expressCreate 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 CMS15 } else {16 // save as draft (default)17 }18 }19 })20);21 22app.listen(3000);Add your endpoint URL to Monok settings: https://yoursite.com/monok

@monok/server 软件包会自动配置以下端点,用于与 Monok 通信
/monok/push?action=draft|publishMonok 将新文章数据推送到此端点,由你的 onArticle 回调处理。
token: <your-api-key>action— 根据用户在 Monok 界面中的选择,设为 draft 或 publish/monok/info?apikey=<your-api-key>Monok 获取你的网站信息,了解品牌、分类、标签和作者,从而提供更合适的内容推荐。
apikey— 用于身份验证的 Monok API 密钥getSiteInfo 回调getSiteInfo 时返回 404了解 Monok 发送的 JSON 数据
文章以 JSON 对象形式发送,结构如下
| Field | Type | Description |
|---|---|---|
title | String | 文章标题 |
shortTitle | String | 用于元标签的短标题,可预填 Yoast/RankMath |
description | String | 用于 SEO 的元描述,可预填 Yoast/RankMath |
content | String | 可直接用于 WordPress 的 HTML 文章 |
text | String | 包含 JSON 组件的 Markdown 文章 |
slug | String | 根据标题生成的 URL slug,可预填 Yoast/RankMath |
id | String | 唯一 ID,可通过 monok.com/puff/ID 访问 |
thumbImageData | String | 以 base64 编码的 PNG 特色图片 |
thumbImageDescription | String | 特色图片的替代文本 |
language | String | 目标语言/区域设置(例如 "fr"、"fr-ca") |
type | String | "blog" 或 "news" |
keywords | [String] | SEO 关键词数组 |
tags | [String] | 文章标签数组 |
vfImage | Object | 特色图片的详细元数据 |
sections | String | 文章分类名称 |
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}按换行符(\n)拆分文本,判断每一行是 Markdown 还是 JSON。使用 Drawdown(约 4 KB)等库将 Markdown 转换为 HTML。
对于 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/" + imageFile9});Monok 收到回传链接后,自动在社交媒体平台分享已发布的文章
Monok 了解已发布内容的结构,为后续文章推荐更合适的内部链接
跟踪文章表现,了解各篇内容的互动指标
发布后调用 sendMonokLinkback() 即可,其余工作交给 Monok
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 MonokArticle6} from "@monok/server";7 8const app = express();9 10app.use(11 "/monok",12 createMonokRouter({13 apiKey: process.env.MONOK_API_KEY!,14 imageDir: "./uploads", // optional15 // Optional: provide site info if you want Monok to query it16 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 immediately40 } else {41 // save as draft42 }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: imagePath51 // ? "https://example.com/uploads/" + require("path").basename(imagePath)52 // : undefined53 // });54 }55 })56);57 58app.listen(3000);Monok learns your existing categories and automatically assigns articles to the most relevant ones based on content analysis.
Provide your author list so Monok can suggest or assign the appropriate author to each article based on topic and expertise.
Monok uses your existing tag taxonomy to suggest relevant tags for each article, maintaining consistency across your content.
Share your site name and logo with Monok to ensure all generated content aligns with your brand identity and guidelines.
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。
常见问题及解决方法
许多服务器会限制接收的数据量。发送 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 配置中相应处理。
如果 Nginx 配置限制了 IP 地址,请将 Monok 服务器加入允许列表。
Solution:
请允许此地址:51.158.177.191
客户评价
我觉得非常好!我在我的风投支持的中文SaaS中使用了它,语言非常好
唐勋竹博士
创始人, NoahCode

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

与Monok合作是我们与服务提供商合作的最佳体验之一。Monok的产品路线图始终如一地预测市场需求。
Matt Kovelan
创始人, SportsWriters
Monok已被证明是理想的合作伙伴,一举让我们领先了数年,并显著改变了我们客户产品的灵活性。
Michael Davids
首席执行官, Splendor
我觉得非常好!我在我的风投支持的中文SaaS中使用了它,语言非常好
唐勋竹博士
创始人, NoahCode

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

与Monok合作是我们与服务提供商合作的最佳体验之一。Monok的产品路线图始终如一地预测市场需求。
Matt Kovelan
创始人, SportsWriters
Monok已被证明是理想的合作伙伴,一举让我们领先了数年,并显著改变了我们客户产品的灵活性。
Michael Davids
首席执行官, Splendor
覆盖知识领域外的主题,低量或高量均可。
定价
所有方案保持生产灵活。随时暂停,只为交付内容付费。
货币
更新汇率中…
Basic

Starter

Custom

常见问题
@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 即可测试。