Pinterest Browser Publisher
Browser-based Pinterest automation using Playwright. No API required. Supports jp.pinterest.com with Japanese copywriting.
Quick Start
1. Install Dependencies
CODEBLOCK0
2. First-Time Login (Save Cookies)
CODEBLOCK1
Opens browser → Log in manually → Cookies saved to INLINECODE0
3. Publish Pins
CODEBLOCK2
Scripts Overview
| Script | Purpose | Parameters |
|---|
| INLINECODE1 | Login & save cookies | None |
| INLINECODE2 |
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
INLINECODE9
CODEBLOCK3
Custom Publishing
Edit scripts/publish-fix.js pins array:
CODEBLOCK4
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
CODEBLOCK5
Fashion
CODEBLOCK6
Plants
CODEBLOCK7
Troubleshooting
Cookie Expired
CODEBLOCK8
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:
CODEBLOCK9
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
CODEBLOCK10
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
Pinterest 浏览器发布器
基于 Playwright 的浏览器端 Pinterest 自动化工具。无需 API。支持 jp.pinterest.com 及日语文案。
快速开始
1. 安装依赖
bash
npm install -g playwright
playwright install chromium
cd skills/pinterest-browser-publisher
npm install
2. 首次登录（保存 Cookies）
bash
node scripts/force-login.js
打开浏览器 → 手动登录 → Cookies 保存至 ~/.config/pinterest/cookies.json
3. 发布 Pin 图
bash
自动发布已配置的 Pin 图
node scripts/publish-fix.js
批量发布所有 Pin 图
node scripts/auto-publish-all.js
自定义参数发布单个 Pin 图
node scripts/publish-jp-direct.js --images ./pin.png --title タイトル --description 説明
脚本概览
| 脚本 | 用途 | 参数 |
|---|
| force-login.js | 登录并保存 cookies | 无 |
| publish-fix.js |
自动发布已配置的 Pin 图 | 内置配置 |
| auto-publish-all.js | 批量发布所有 Pin 图 | 内置配置 |
| publish-jp-direct.js | 发布单个 Pin 图 | --images, --title, --description |
配置
Cookie 存储
~/.config/pinterest/cookies.json（有效期约 30 天）
配置文件
~/.config/pinterest/config.json
json
{
headless: false,
slowMo: 100,
postDelay: 30000,
randomizeTiming: true
}
自定义发布
编辑 scripts/publish-fix.js 中的 pins 数组：
javascript
const pins = [
{
image: /path/to/image.png,
title: ✨ピンタイトル✨,
description: 説明テキスト #ハッシュタグ #日本語
}
];
最佳实践
标题优化
- - ✅ 使用表情符号（✨🌿💎🥐🪵）
- ✅ 包含关键词
- ✅ 控制在 50 字符以内
描述优化
- - ✅ 前 50 字符为核心信息
- ✅ 使用项目符号
- ✅ 添加 5-10 个标签
发布时段（日本标准时间）
- - 🌅 7:00-8:00（通勤时间）
- 🍱 12:00-13:00（午餐时间）
- 🌙 20:00-22:00（睡前时间）
频率限制
- - 每小时最多 10 个 Pin 图
- 每天最多 50 个 Pin 图
- Pin 图之间间隔 20-30 秒
图片要求
1000px |
| 比例 | 2:3 或 4:5（竖版） |
| 大小 | < 20MB |
Pin 图示例
家居装饰
javascript
{
image: ./pins/home01.png,
title: ✨轻奢×中古ミックス✨大人の部屋作りアイデア,
description: 高級感とヴィンテージの絶妙なバランス🏠 #轻奢风 #中古风 #家居灵感
}
时尚穿搭
javascript
{
image: ./pins/outfit01.png,
title: 👗优衣库神搭配👗5 着で 7 デイズコーデ,
description: 着回し力抜群のアイテムで、一週間コーデが完成！#优衣库 #穿搭 #日系
}
植物
javascript
{
image: ./pins/plant01.png,
title: 🌿室内绿植推荐🌿初心者でも育てやすい 10 選,
description: 日陰でも育つ、手間いらずの観葉植物まとめました🪴 #植物 #绿植 #室内
}
故障排除
Cookie 过期
bash
node scripts/force-login.js # 重新登录
上传失败
- - 检查图片路径是否正确
- 确认 PNG/JPG 格式
- 确保文件大小 < 20MB
标题/描述未填写
- - Pinterest UI 可能已变更
- 更新脚本中的选择器
- 可手动回退
发布后 Pin 图不可见
- - 等待 2-5 分钟审核
- 刷新 Pinterest 首页
- 检查垃圾箱文件夹
验证
发布后，检查截图：
/tmp/fix*-done.png
/tmp/rem*-done.png
成功标志：
- - 底部：「你的 Pin 图已发布！」
- 右侧边栏：「发布完成」
安全特性
- - ✅ 类人鼠标移动（贝塞尔曲线）
- ✅ 操作间随机延迟
- ✅ 真实浏览器（非无头模式）
- ✅ 会话持久化
- ✅ 内置频率限制
依赖项
- - Node.js 16+
- Playwright
- Chromium（自动安装）
安装
bash
全局安装 Playwright
npm install -g playwright
playwright install chromium
技能依赖项
cd skills/pinterest-browser-publisher
npm install
许可证
MIT 许可证
支持
- - 文档：https://clawhub.ai/skills/pinterest-browser-publisher
- 问题反馈：https://github.com/openclaw/openclaw/issues
- Discord：https://discord.com/invite/clawd
最后更新： 2026-03-26
作者： jp-girl-agent
版本： 1.0.1
