Notipo

Notipo

面向 AI Agent 的开源 WordPress 发布工具——MCP 服务、REST API 和 CLI。也可以从 Notion 同步。

让你的 Agent（Claude、Cursor、ChatGPT、n8n 或任何 HTTP 客户端）连接 Notipo，即可将内容发布到自托管的 WordPress，无需安装插件。Notipo 会处理完整流程：将 Markdown 转换为 Gutenberg 格式、将图片托管到你的 WordPress 媒体库、生成 AI 或 Unsplash 特色图片，并在发布时自动应用 Rank Math / Yoast / SEOPress / AIOSEO 元数据。

---

两种发布到 WordPress 的方式

1. 从 Notion 发布

连接 Notion，将页面状态更改为 Post to Wordpress 或 Publish，剩下的交给 Notipo 处理——提取 Markdown、将图片缓存到 WP 媒体库、生成特色图片，并通过 Rank Math / Yoast / SEOPress / AIOSEO 添加 SEO 元数据。

2. 通过 AI Agent、REST API、CLI 或 n8n 工作流发布

Notipo 提供一个包含 13 种工具的 Model Context Protocol (MCP) 服务，供 AI Agent 使用，同时还提供 REST API 和 CLI。Claude Desktop、Cursor、Windsurf、Claude Code、ChatGPT——任何兼容 MCP 的 Agent 都能端到端发布文章。

# CLI: publish a post end-to-end
npm install -g notipo
notipo posts create --title "Why Every Dev Should Have a Blog" --publish

# REST API: one call runs the full pipeline
curl -X POST https://app.notipo.com/api/posts/create \
  -H "X-API-Key: $NOTIPO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"Hello","body":"## Intro\n\nMarkdown in, WordPress out.","publish":true}'

// MCP: drop into Claude Desktop config
{
  "mcpServers": {
    "notipo": {
      "type": "http",
      "url": "https://app.notipo.com/api/mcp",
      "headers": { "x-api-key": "your-api-key" }
    }
  }
}

完整了解 AI Agent 集成方式，请参阅 notipo.com/ai-agents。

---

托管 SaaS 与自托管

notipo.com 上的托管版本是受支持、开箱即用的产品——包含托管基础设施、自动升级、即时 Notion Webhook 投递，以及每月可发布 5 篇文章的免费方案。Pro 版每月 19 美元，可无限发布文章并生成 AI 特色图片。

本仓库包含的代码与托管产品运行的代码相同。你可以根据 AGPL-3.0 许可证自行托管——本地开发请参阅 DEVELOPMENT.md，使用 Traefik + Let's Encrypt 进行生产部署请参阅 docker-compose.yml。

自托管不受支持——除本仓库中的内容外，我们不提供帮助，也没有升级途径。如果你需要这些服务，托管产品更快捷、更便宜，而且已经运行就绪。

---

技术栈

• 后端： Fastify、TypeScript、Prisma、PostgreSQL 17
• 任务队列： pg-boss（基于 Postgres，无需 Redis）
• 前端（管理端）： Next.js 16 + shadcn/ui + Tailwind
• AI： Google Gemini（特色图片）、Model Context Protocol（Agent 集成）
• 其他： Sharp（图片）、Stripe（计费）、Resend（事务邮件）、Sentry（错误监控）、PostHog（产品分析）、Notion SDK、WordPress REST API
• CLI： 零依赖 npm 包，仅使用原生 fetch

Monorepo（Turborepo + npm workspaces）：

apps/
  api/     — Fastify backend, MCP server, job workers
  web/     — Next.js admin UI
packages/
  cli/     — `notipo` npm package (MIT-licensed thin client)
  shared/  — TypeScript types and enums
plugins/
  notipo-seo-meta-writer/  — WordPress plugin for Yoast/AIOSEO metadata bridge

---

快速开始（自托管）

你需要：Docker、Docker Compose、指向服务器的域名、Notion 集成，以及启用了应用程序密码的 WordPress 网站（WP 5.6+）。

git clone https://github.com/kfuras/notipo-app.git
cd notipo-app
cp apps/api/.env.example .env
# Edit .env — at minimum set DATABASE_URL, ENCRYPTION_KEY, API_KEY,
# DOMAIN, ACME_EMAIL, RESEND_API_KEY
docker compose up -d

Compose 配置会从 ghcr.io/kfuras/notipo-api 和 ghcr.io/kfuras/notipo-web 拉取多架构镜像（linux/amd64 + linux/arm64）， 因此既适用于 x86 服务器，也适用于 Apple Silicon / ARM 设备。

Compose 配置会启动 Traefik、API、管理界面和 Postgres，并在首次运行时配置 Let's Encrypt TLS。详情请参阅 docker-compose.yml。

无需 Docker 的本地开发方式：

docker compose -f docker-compose.dev.yml up   # Postgres only
npm install
npm run migrate -w @notipo/api
turbo dev                                      # API on :3000, web on :3001

完整开发指南请参阅 DEVELOPMENT.md。

---

文档

• API 参考： notipo.com/docs/api/introduction
• MCP 服务（13 个工具）： notipo.com/docs/api/mcp
• CLI： notipo.com/docs/api/cli
• n8n 集成： notipo.com/docs/api/n8n
• 所有文档： notipo.com/docs
• 架构与开发： DEVELOPMENT.md 和 .claude/CLAUDE.md

---

许可证

本项目根据 GNU Affero 通用公共许可证 v3.0（AGPL-3.0）授权，详见 LICENSE。

简单来说：

• ✅ 你可以出于任何目的使用、修改和自托管 Notipo，包括商业用途。
• ✅ 你可以创建分支，并将修改贡献回项目。
• ⚠️ 如果你将修改后的版本作为托管服务运行，则必须根据相同的许可证发布你的修改。这就是“Affero 条款”——它堵住了普通 GPL 留下的网络服务漏洞。
• ✅ notipo CLI 软件包以 MIT 许可证发布到 npm（它只是一个轻量的 API 客户端封装）。
• ✅ notipo-seo-meta-writer WordPress 插件以 MIT 许可证发布（与 WordPress 的 GPL 生态系统兼容）。

如果你想在专有托管产品中使用 Notipo 的代码而不承担 AGPL 义务，创建一个 issue——可能可以获得商业授权。

---

贡献

欢迎提交 PR。请参阅 CONTRIBUTING.md 了解指南，并参阅 CODE_OF_CONDUCT.md 了解社区规范。

有关安全问题的披露，请参阅 SECURITY.md——请不要针对漏洞公开创建 issue。

---

链接

• 托管式 SaaS： notipo.com
• AI Agent： notipo.com/ai-agents
• 博客： notipo.com/blog
• Twitter/X： @kjetilfuras