Notipo

Notipo

AI エージェント向けのオープンソース WordPress パブリッシング — MCP サーバー、REST API、CLI。Notion からの同期にも対応します。

エージェント（Claude、Cursor、ChatGPT、n8n、任意の HTTP クライアント）を Notipo に接続するだけで、プラグインなしでセルフホストの WordPress に公開できます。Notipo は、Markdown から Gutenberg への変換、WordPress のメディアライブラリへの画像ホスティング、AI または Unsplash で生成したアイキャッチ画像の設定、公開時の Rank Math / Yoast / SEOPress / AIOSEO のメタデータ適用まで、パイプライン全体を処理します。

---

WordPress に公開する 2 つの方法

1. Notion から

Notion を接続し、ページのステータスを Post to Wordpress または Publish に変更すると、Notipo が残りの処理を行います。Markdown の抽出、WordPress メディアライブラリへの画像のキャッシュ、アイキャッチ画像の生成、Rank Math / Yoast / SEOPress / AIOSEO による SEO メタデータの設定に対応します。

2. AI エージェント、REST API、CLI、または n8n ワークフローから

Notipo は AI エージェント向けの 13 個のツールを備えた Model Context Protocol（MCP）サーバーに加え、REST API と CLI を提供します。Claude Desktop、Cursor、Windsurf、Claude Code、ChatGPT など、MCP 互換のエージェントであれば、投稿の公開を最初から最後まで実行できます。

# 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 エージェントとの連携について詳しくは、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（エージェント連携）
• その他： Sharp（画像）、Stripe（課金）、Resend（トランザクションメール）、Sentry（エラー）、PostHog（プロダクト分析）、Notion SDK、WordPress REST API
• CLI： 依存関係ゼロの npm パッケージ。ネイティブの fetch のみを使用

モノレポ（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、管理 UI、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 General Public License v3.0（AGPL-3.0）の下でライセンスされています。詳しくは LICENSE をご覧ください。

簡単に説明すると：

• ✅ 商用利用を含め、あらゆる目的で Notipo を使用、変更、セルフホストできます。
• ✅ フォークして、変更をコントリビュートできます。
• ⚠️ 変更したバージョンをホスト型サービスとして運用する場合、変更内容を同じライセンスの下で公開する必要があります。これは「Affero 条項」と呼ばれ、通常の GPL では防げないネットワークサービスの抜け穴をふさぎます。
• ✅ notipo CLI パッケージは MIT ライセンスの下で npm に公開されています（薄い API クライアントラッパーにすぎません）。
• ✅ notipo-seo-meta-writer WordPress プラグインは MIT ライセンスの下で公開されています（WordPress の GPL エコシステムと互換性があります）。

AGPL の義務なしで Notipo のコードを独自のホスト型製品に使用したい場合は、issue を作成してください。商用ライセンスを利用できる場合があります。

---

コントリビュート

PR を歓迎します。ガイドラインは CONTRIBUTING.md、コミュニティの行動規範は CODE_OF_CONDUCT.md をご覧ください。

セキュリティに関する報告については SECURITY.md をご覧ください。脆弱性について、公開 issue を作成しないでください。

---

リンク

• ホスト型 SaaS： notipo.com
• AI エージェント： notipo.com/ai-agents
• ブログ： notipo.com/blog
• Twitter/X： @kjetilfuras