Notipo 是为写作者、开发者和 AI 代理打造的开源 WordPress 发布工具，核心目标是简化内容从生成到发布的完整流程。
用途
Notipo 解决的是 WordPress 发布链路中的自动化问题：将 Markdown 转换为 Gutenberg 区块、把图片托管到 WordPress 媒体库、生成特色图片、并在发布时自动应用主流 SEO 插件的元数据。它同时面向三类使用者：写作者、开发者以及 AI 代理。
主要能力
- 发布操作：可创建、更新、发布和删除 WordPress 文章。
- 内容转换：Markdown 到 Gutenberg 的转换。
- 图片处理：将图片托管到 WordPress 媒体库；支持 AI 生成或 Unsplash 来源的特色图片。
- SEO 元数据：自动应用 Rank Math、Yoast、SEOPress、AIOSEO 的元数据。
- AI 代理集成：提供 MCP 服务器，含 13 个工具，支持 Claude Desktop、Cursor、Windsurf、Claude Code、ChatGPT 等兼容 MCP 的代理端到端发布文章。
- 其他接口：REST API、CLI（零依赖 npm 包，仅使用原生 fetch）、n8n 工作流。
- Notion 同步：连接 Notion，将页面状态改为 “Post to Wordpress” 或 “Publish”，Notipo 处理 Markdown 提取、图片缓存到 WP 媒体库、特色图片生成和 SEO 元数据。
- 无需 WordPress 插件即可发布到自托管 WordPress。
使用方式
可通过以下途径使用：
- 托管 SaaS：notipo.com 是官方支持、开箱即用的产品，含托管基础设施、自动升级、即时 Notion webhook 投递；免费套餐每月 5 篇，Pro 每月 19 美元，提供无限发布并含 AI 特色图片。
- 自托管：本仓库代码与托管产品相同，可依 AGPL-3.0 协议自托管。自托管需要 Docker、Docker Compose、指向服务器的域名、Notion 集成，以及启用了应用密码（WP 5.6+）的 WordPress 站点。
- 本地开发（不使用 Docker）：参见 DEVELOPMENT.md。
- AI 代理、REST API、CLI 或 n8n 工作流：参见官方文档（notipo.com/docs 及相关子页面）。
技术栈
- 后端：Fastify、TypeScript、Prisma、PostgreSQL 17
- 任务队列：pg-boss（基于 Postgres，无需 Redis）
- 前端（管理后台）：Next.js 16 + shadcn/ui + Tailwind
- AI：Google Gemini（特色图片）、Model Context Protocol（代理集成）
- 其他：Sharp（图像）、Stripe（计费）、Resend（事务邮件）、Sentry（错误）、PostHog（产品分析）、Notion SDK、WordPress REST API
- CLI：零依赖 npm 包，仅原生 fetch
- 仓库结构：Monorepo（Turborepo + npm workspaces）
部署
Docker Compose 堆栈会拉取来自 ghcr.io/kfuras/notipo-api 和 ghcr.io/kfuras/notipo-web 的多架构镜像（linux/amd64 + linux/arm64），同时支持 x86 服务器和 Apple Silicon / ARM 硬件。堆栈启动 Traefik + API + 管理 UI + Postgres，首次运行自动配置 Let's Encrypt TLS。
限制
- 自托管不受官方支持：仓库之外无额外帮助，无升级路径。
- 许可：项目采用 AGPL-3.0。可商用使用、修改和自托管；若将修改版作为托管服务运行，必须以相同许可发布修改。CLI 包（npm）和 notipo-seo-meta-writer WordPress 插件采用 MIT 许可。如需在专有托管产品中使用而不受 AGPL 约束，可开 issue 咨询商业许可。