# Pinterest AI Operator

这是一个面向 Pinterest 的综合自动化运营项目规划仓库。目标不是做单点脚本，而是把内容运营、趋势研究、Pin/图板管理、商品目录、广告分析、商机开发、CRM 跟进和 OpenClaw 指令入口整合成一个可审计的本地运营系统。

参考项目：`/Users/momo/Project/Facebook-auto`。

Pinterest 版应采用更稳的路线：

- 官方 API 优先：Pin、Board、Analytics、Ads、Catalog、Trends 等能力优先走 Pinterest API。
- 浏览器辅助兜底：登录态、页面诊断、人工确认、创建器 UI 检查等再用 Chrome/CDP。
- 人工确认优先：发布、关注、评论、消息、保存等对外动作默认进入审核队列。
- 不做未经许可的数据抓取：Pinterest 开发者指南明确限制自动抓取/提取 Pinterest 信息。

## 核心闭环

```text
用户自然语言指令
-> OpenClaw / 本地 Web 后台
-> Pinterest-auto MCP 工具
-> 运营计划
-> 任务队列
-> API 执行器 / 浏览器执行器
-> Pinterest / Business / Ads / Catalog
-> 证据与分析
-> CRM / 内容库 / 日报
```

## 第一阶段目标

1. 搭建 Next.js + TypeScript 本地后台，沿用 Facebook-auto 的本地 JSON store 原型。
2. 建立 Pinterest 专用数据模型：账号、图板、Pin、内容计划、趋势、商机、CRM、任务、审计日志。
3. 接入 Pinterest OAuth 和 API 客户端，先支持列出图板、创建图板、创建 Pin、读取 Pin 分析。
4. 建立 OpenClaw MCP 工具层：health、summary、create_daily_plan、queue_pin_publish、run_plan、analyze_content。
5. 浏览器执行器只做页面状态诊断、人工审核辅助和 API 不覆盖的低风险流程。

完整规划见 [docs/pinterest-operator-plan.md](/Users/momo/Project/pinterest-auto/docs/pinterest-operator-plan.md)。

OAuth 设置见 [docs/pinterest-oauth-setup.md](/Users/momo/Project/pinterest-auto/docs/pinterest-oauth-setup.md)。
