Pinterest Browser Publisher

Automate Pinterest pin publishing via browser automation (Playwright). No API key needed. Supports jp.pinterest.com, single pins, carousels, and batch publishing. Cookie persistence for repeated use.

Browser-based Pinterest automation using Playwright. No API required. Supports jp.pinterest.com with Japanese copywriting.

Quick Start

1. Install Dependencies

npm install -g playwright
playwright install chromium
cd skills/pinterest-browser-publisher
npm install

2. First-Time Login (Save Cookies)

node scripts/force-login.js

Opens browser → Log in manually → Cookies saved to ~/.config/pinterest/cookies.json

3. Publish Pins

# Auto-publish configured pins
node scripts/publish-fix.js

# Batch publish all pins
node scripts/auto-publish-all.js

# Single pin with custom params
node scripts/publish-jp-direct.js --images "./pin.png" --title "タイトル" --description "説明"

Scripts Overview

Script	Purpose	Parameters
force-login.js	Login & save cookies	None
publish-fix.js	Auto-publish configured pins	Built-in config
auto-publish-all.js	Batch publish all pins	Built-in config
publish-jp-direct.js	Single pin publish	--images, --title, --description

Configuration

Cookie Storage

~/.config/pinterest/cookies.json (valid ~30 days)

Config File

~/.config/pinterest/config.json

{
  "headless": false,
  "slowMo": 100,
  "postDelay": 30000,
  "randomizeTiming": true
}

Custom Publishing

Edit scripts/publish-fix.js pins array:

const pins = [
  {
    image: '/path/to/image.png',
    title: '✨ピンタイトル✨',
    description: '説明テキスト #ハッシュタグ #日本語'
  }
];

Best Practices

Title Optimization

• ✅ Use emoji (✨🌿💎🥐🪵)
• ✅ Include keywords
• ✅ Keep under 50 characters

Description Optimization

• ✅ First 50 chars = core message
• ✅ Use bullet points
• ✅ Add 5-10 hashtags

Posting Schedule (JST)

• 🌅 7:00-8:00 (commute)
• 🍱 12:00-13:00 (lunch)
• 🌙 20:00-22:00 (bedtime)

Rate Limits

• Max 10 pins/hour
• Max 50 pins/day
• 20-30s delay between pins

Image Requirements

Property	Requirement
Format	PNG, JPG
Min Width	1000px
Ratio	2:3 or 4:5 (portrait)
Size	< 20MB

Example Pins

Home Decor

{
  image: './pins/home01.png',
  title: '✨轻奢×中古ミックス✨大人の部屋作りアイデア',
  description: '高級感とヴィンテージの絶妙なバランス🏠 #轻奢风 #中古风 #家居灵感'
}

Fashion

{
  image: './pins/outfit01.png',
  title: '👗优衣库神搭配👗5 着で 7 デイズコーデ',
  description: '着回し力抜群のアイテムで、一週間コーデが完成！#优衣库 #穿搭 #日系'
}

Plants

{
  image: './pins/plant01.png',
  title: '🌿室内绿植推荐🌿初心者でも育てやすい 10 選',
  description: '日陰でも育つ、手間いらずの観葉植物まとめました🪴 #植物 #绿植 #室内'
}

Troubleshooting

Cookie Expired

node scripts/force-login.js  # Re-login

Upload Failed

• Check image path is correct
• Verify PNG/JPG format
• Ensure file size < 20MB

Title/Description Not Filled

• Pinterest UI may have changed
• Update selectors in script
• Manual fallback available

Pin Not Visible After Publish

• Wait 2-5 minutes for review
• Refresh Pinterest homepage
• Check spam folder

Verification

After publishing, check screenshots:

/tmp/fix*-done.png
/tmp/rem*-done.png

Success indicators:

• Bottom: 「你的 Pin 图已发布！」
• Right sidebar: 「发布完成」

Safety Features

• ✅ Human-like mouse movement (Bezier curves)
• ✅ Random delays between actions
• ✅ Real browser (non-headless)
• ✅ Session persistence
• ✅ Rate limiting built-in

Dependencies

• Node.js 16+
• Playwright
• Chromium (auto-installed)

Installation

# Global Playwright
npm install -g playwright
playwright install chromium

# Skill dependencies
cd skills/pinterest-browser-publisher
npm install

License

MIT License

Support

• Docs: https://clawhub.ai/skills/pinterest-browser-publisher
• Issues: https://github.com/openclaw/openclaw/issues
• Discord: https://discord.com/invite/clawd

---

Last Updated: 2026-03-26
Author: jp-girl-agent
Version: 1.0.1