Notion Market Publish Skill

Overview

Automate publishing Notion templates to the official Notion template marketplace. This skill uses AI to generate intelligent metadata (locale detection, slug generation, category selection, descriptions) and scripts to execute concrete operations (API calls, image uploads, submission).

Prerequisites

Python 3.7+ with requests library:
```
pip install -r requirements.txt
```
Notion API key stored at ~/.config/notion/api_key
(Optional) Stripe account for paid templates

Workflow

Step 1: Gather User Input

Ask the user for:

Template URL (required) - e.g., https://opaque-bag-aa9.notion.site/3148eab86c0980cdaf39fc5cdeb3bcfb
Image directory (required) - e.g., ~/Documents/clipno/clipno-template/繁体/
Price in JPY (optional) - For paid templates
Stripe product ID (optional) - For paid templates

Step 2: Get Template Content

Use the script to fetch the template title and page content from Notion API:

python scripts/notion_api.py get-content <template_url>

This returns JSON with the title, sub-page names, headings, and paragraphs:

{
  "title": "知識庫管理系統",
  "subpages": ["📥 收件匣", "🗂️ 資料庫", "📝 每日筆記"],
  "headings": [
    {"level": 2, "text": "功能特色"},
    {"level": 2, "text": "使用方式"}
  ],
  "paragraphs": ["這是一個全功能的知識管理系統..."]
}

Step 3: AI Analysis and Generation

AI performs all intelligent generation (do NOT use scripts for this):

Detect Locale - Analyze the title to determine language:
- Korean characters (한국어) → ko-KR
- Japanese characters (日本語) → ja-JP
- Traditional Chinese (繁體中文) → zh-TW
- Simplified Chinese (简体中文) → zh-CN
- Default → en-US
Generate Slug - Create English slug from title:
- Translate key terms to English
- Convert to lowercase with hyphens
- Add 4 random digits
- Example: "知識庫管理系統" → "knowledge-base-management-system-1234"
Select Categories - Read category.json and select top 3 most relevant categories:
- Analyze title, subpages, and headings for full context
- Match with category names and descriptions
- Return 3 contentful_id values
Generate Emoji - Choose appropriate emoji based on title and content:
- 📚 for knowledge/learning
- 📝 for notes/content
- 🎨 for creative/design
- 💼 for business
- 📊 for projects/data
- etc.
Generate Descriptions (use title + subpages + headings + paragraphs as context):
- shortDescription: 1-2 sentences describing the template's core purpose, informed by actual page structure
- longDescription: Detailed description listing key features/modules derived from subpage names and headings
- Use the detected locale's language for descriptions
- Example: if subpages are ["📥 收件匣", "🗂️ 資料庫", "📝 每日筆記"], mention these as actual features

Step 4: Create Stripe Payment Link (If Paid)

If user provided price and Stripe product ID:

Use mcp__stripe__list_prices to check existing prices
Use mcp__stripe__create_price to create one-time JPY price
Use mcp__stripe__create_payment_link with:
- Price ID from step 2
- Quantity: 1
- Success URL: template URL

Convert JPY to USD (divide by 150, round to integer) for the price field.

Step 5: Get Notion Cookies (Automated)

Run the browser automation script to get cookies:

node scripts/get_cookies.js

This script will:

Launch Chrome browser (visible, not headless)
Navigate to https://www.notion.so/profile/templates
Wait for user to login if needed (5 seconds)
Extract all cookies and user_id
Save to ~/.config/notion/cookies.txt and ~/.config/notion/user_id.txt

The cookies will be automatically used by subsequent commands.

Note: If you don't have Node.js/puppeteer, you can manually:

Open browser → https://www.notion.so/profile/templates
Open DevTools (F12) → Network tab
Copy full Cookie header and save to ~/.config/notion/cookies.txt
Copy notion_user_id value and save to ~/.config/notion/user_id.txt

Step 6: Upload Images

Run the script to upload all images (cookies auto-loaded):

python scripts/notion_api.py upload-images <image_dir>

The script finds and uploads:

Desktop cover: desktop.*, cover.*, image.* → image (1920x1200)
Mobile cover: mobile_image.* → mobileImage (600x1200)
PC screenshots: pc1.jpg, pc2.jpg, etc. → screenshots[] (2048x1280)
Mobile screenshots: mobile1.*, mobile2.*, etc. → mobileScreenshots[] (750x2668)

Returns JSON with all uploaded URLs.

Step 7: Combine Data and Confirm

Merge all data into final submission payload:

{
  "url": "<template_url>",
  "name": "<title>",
  "locale": "<ai_detected_locale>",
  "shortDescription": "<ai_generated_short_desc>",
  "longDescription": "<ai_generated_long_desc>",
  "categories": ["<ai_selected_cat1>", "<ai_selected_cat2>", "<ai_selected_cat3>"],
  "image": { "url": "...", "height": 1200, "width": 1920 },
  "mobileImage": { "url": "...", "height": 1200, "width": 600 },
  "emoji": "<ai_selected_emoji>",
  "purchaseUrl": "<stripe_payment_link>",
  "price": <usd_price>,
  "slug": "<ai_generated_slug>",
  "screenshots": [...],
  "mobileScreenshots": [...],
  "videos": [],
  "verifiedInstantDelivery": true,
  "isDefaultLocale": true,
  "status": "in_review"
}

CRITICAL: Display complete JSON to user and get confirmation before submitting.

Step 8: Submit to Marketplace

After user confirms, submit using the script (cookies auto-loaded):

python scripts/notion_api.py submit '<data_json>'

Template will be submitted with status in_review.

Division of Responsibilities

AI Handles (Intelligent Generation)

Locale detection from title
Slug generation (translation + formatting)
Category selection (semantic matching)
Emoji selection (keyword matching)
Description generation (context-aware)

Scripts Handle (Concrete Operations)

Fetching title from Notion API
Uploading images to S3
Submitting data to marketplace API

Image Naming Conventions

Organize images in directory as:

image.jpg or desktop.jpg - Desktop cover
mobile_image.jpg or mobile_image.PNG - Mobile cover
pc1.jpg, pc2.jpg, pc3.jpg, pc4.jpg - PC screenshots
mobile1.PNG, mobile2.PNG, etc. - Mobile screenshots

Supported Locales

en-US: English (US)
ko-KR: 한국어
zh-CN: 简体中文
zh-TW: 繁體中文
ja-JP: 日本語
es-ES: Español
fr-FR: Français
de-DE: Deutsch
And more...

Error Handling

If Notion API key missing, instruct user to create it
If image upload fails, verify cookies are fresh
If submission fails, check all required fields present
Always confirm data with user before submission

Resources

scripts/notion_api.py - Unified script for all API operations
requirements.txt - Python dependencies
references/workflow.md - Detailed workflow documentation

notion-market-publish-skill