notipo— agent skill

Install Notipo CLI if it doesn't exist

npm install -g notipo

• npm release: https://www.npmjs.com/package/notipo
• notipo docs: https://notipo.com/docs/api/introduction
• notipo cli docs: https://notipo.com/docs/api/cli

Setup

Sign up at notipo.com, connect your Notion database and WordPress site through the dashboard, then grab your API key from Settings → Account.

Set the environment variables:

export NOTIPO_URL="https://notipo.com"
export NOTIPO_API_KEY="ntp_your-api-key"

Core Workflow

1. Generate — AI agent creates title, body (markdown), category, tags, SEO keyword
2. Fetch context — get categories and tags from Notipo to pick valid values
3. Publish — notipo posts create with all fields
4. Monitor — notipo jobs to check completion status

Essential Commands

Check connection status

notipo status

Fetch categories and tags

# Get available categories (for picking a valid category)
curl -s $NOTIPO_URL/api/categories \
  -H "X-API-Key: $NOTIPO_API_KEY" | jq '.data[].name'

# Get available tags
curl -s $NOTIPO_URL/api/tags \
  -H "X-API-Key: $NOTIPO_API_KEY" | jq '.data[].name'

Create a post (draft)

notipo posts create \
  --title "Your Post Title" \
  --body "## Introduction\n\nYour markdown content here.\n\n## Main Section\n\nMore content." \
  --category "Tutorials" \
  --tags "automation,ai" \
  --seo-keyword "your focus keyword" \
  --image-title "Featured Image Title" \
  --slug "custom-url-slug"

Create and publish immediately

notipo posts create \
  --title "Your Post Title" \
  --body "Markdown content here." \
  --category "Guides" \
  --seo-keyword "focus keyword" \
  --publish

Create, publish, and wait for completion

notipo posts create \
  --title "Your Post Title" \
  --body "Markdown content here." \
  --category "Guides" \
  --publish --wait

The --wait flag polls until the job completes and returns the result with the WordPress URL.

Create with inline Unsplash images (Pro plan, curl only)

curl -X POST $NOTIPO_URL/api/posts/create \
  -H "X-API-Key: $NOTIPO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Your Post Title",
    "body": "## Introduction\n\nContent here.\n\n## Getting Started\n\nMore content.",
    "category": "Tutorials",
    "seoKeyword": "focus keyword",
    "images": [
      { "query": "developer workspace laptop", "afterHeading": "## Introduction" },
      { "query": "getting started tutorial", "afterHeading": "## Getting Started" }
    ],
    "publish": true
  }'

Update a post (fix content, change metadata, re-sync to WordPress)

notipo posts update POST_ID \
  --body "## Introduction\n\nUpdated content without the H1." \
  --seo-keyword "updated focus keyword" \
  --wait

Updates the Notion page content and/or properties, then triggers a re-sync to WordPress. Only the provided fields are updated — omitted fields stay unchanged. This is the correct way to fix post content after creation.

Check job status

notipo jobs

List posts

notipo posts

Trigger a sync (pick up Notion changes)

notipo sync

Delete a post

notipo posts delete POST_ID

Common Patterns

AI-generated blog post with full metadata

# 1. Fetch categories to pick a valid one
curl -s $NOTIPO_URL/api/categories -H "X-API-Key: $NOTIPO_API_KEY" | jq '.data[].name'

# 2. Create the post with all fields and wait for completion
notipo posts create \
  --title "10 Docker Best Practices for Production" \
  --body "## Introduction\n\nDocker containers are the standard...\n\n## Use Multi-Stage Builds\n\nReduce image size by separating build and runtime...\n\n## Pin Base Image Versions\n\nAvoid surprises by pinning specific tags..." \
  --category "DevOps" \
  --tags "docker,containers,production" \
  --seo-keyword "docker best practices production" \
  --image-title "Docker Best Practices" \
  --slug "docker-best-practices-production" \
  --publish --wait

Batch content pipeline

# Generate and publish multiple posts in sequence
for topic in "React hooks" "TypeScript generics" "Node.js streams"; do
  notipo posts create \
    --title "A Guide to $topic" \
    --body "## Overview\n\nGenerated content about $topic." \
    --category "Tutorials" \
    --seo-keyword "$(echo $topic | tr '[:upper:]' '[:lower:]')" \
    --wait
done

Full pipeline with inline images (curl)

curl -X POST $NOTIPO_URL/api/posts/create \
  -H "X-API-Key: $NOTIPO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "10 Docker Best Practices for Production",
    "body": "## Introduction\n\nDocker containers are the standard...\n\n## Use Multi-Stage Builds\n\nReduce image size...",
    "category": "DevOps",
    "tags": ["docker", "containers", "production"],
    "seoKeyword": "docker best practices production",
    "imageTitle": "Docker Best Practices",
    "slug": "docker-best-practices-production",
    "images": [
      { "query": "docker containers server", "afterHeading": "## Introduction" }
    ],
    "publish": true
  }'

CLI Reference

posts create flags

posts update flags

API Request Body Reference

PATCH /api/posts/:id (update)

Returns { jobId, postId, message }. The update writes to Notion first, then triggers a sync job to push changes to WordPress.

POST /api/posts/create

For curl/HTTP usage, POST /api/posts/create accepts:

What Notipo Handles

• Notion page creation from markdown (no Notion credentials needed)
• Markdown → Notion blocks → WordPress Gutenberg block conversion
• Image download from Notion and upload to WordPress media library
• Featured image generation (1200×628 with category background + title overlay)
• Inline Unsplash image insertion by search query (Pro plan)
• SEO metadata — Rank Math, Yoast, SEOPress, AIOSEO
• Post status management in Notion
• Failure notifications via Slack/Discord webhook

Common Gotchas

1. Use `posts update` to fix content — don't delete and recreate. notipo posts update <id> --body "..." updates the Notion page and re-syncs to WordPress in one call.
2. Include all fields for best results — only title is technically required, but AI agents should always generate body, category, tags, seoKeyword, imageTitle, and slug for a complete post.
3. Category must exist — the category name must match an existing WordPress category. Fetch valid options first.
4. `--publish` runs two jobs — first SYNC_POST (creates draft), then PUBLISH_POST (makes it live). Use --wait to block until both complete.
5. Images require Pro plan — the images array and featured image generation are Pro features. On Free plan, these fields are silently ignored.
6. Fire and forget — the API returns a jobId immediately. Processing happens in the background. Use notipo jobs to check status.
7. Markdown body format — use ## Heading for h2, ### Heading for h3. Paragraphs are separated by \n\n. Images can be included as ![alt](url).
8. Rate limits — notipo sync has a 15-second cooldown. notipo posts create has no rate limit.
9. API key format — keys start with ntp_. Get yours from Settings → Account in the dashboard.
10. Slug defaults — if not set, the slug is derived from the SEO keyword. If no SEO keyword, WordPress generates it from the title.