产品全案TanStack StartCloudflare Workers

PinPilot:把 Pinterest 流量放上自动驾驶

一款基于 TanStarter + Cloudflare 的 Pinterest 营销自动化 SaaS 的全案调研报告与网页版开发文档 —— 覆盖市场分析、GitHub 数据、产品定义、定价策略、交互原型与技术实现路线。

01执行摘要

一句话定位:PinPilot 是一款「输入网址 → 一分钟生成一个月 Pinterest 排期」的自动化营销工具,对标 BlogToPin,用 永久免费档 + 公开 API/MCP + Cloudflare 近零边际成本架构 三个竞品都没有的杠杆切入市场。

5.37 亿
Pinterest 月活(2026 Q1,同比 +7.8%)
$0.83
Pinterest 平均 CPC,主流社交平台最低
$16K
BlogToPin 单人产品 MRR(400+ 订阅者)
0 个
GitHub 上垂直此场景的开源/独立产品

为什么是现在、为什么能赢

  • 需求被验证:BlogToPin 由乌克兰独立开发者两年做到 $15-16K MRR,10-15% 月流失率意味着市场持续有新用户涌入、且现有产品留不住人 —— 留存做得更好就是机会。
  • 赛道成熟但供给粗糙:Tailwind 重而贵、不做「自动生成」;PinGenerator 只做批量设计、缺智能排期;BlogToPin 无免费档、无 API、按天限量惹人反感。三家均未提供 MCP/公开 API,无法接入用户自己的 AI 工作流。
  • 成本结构碾压:竞品跑在传统云上按量烧钱;PinPilot 用 Cloudflare Workers + D1 + R2 + Queues,免费档的边际成本近乎为零,敢送免费版做获客漏斗。
  • 技术底座现成:TanStarter 已内置认证(Better Auth)、订阅(Stripe/Creem)、存储(R2)、数据库(D1)、邮件、博客与后台,产品只需专注「爬取 → 生成 → 排期 → 发布」四个核心模块。
目标:12 周上线 MVP,第一年做到 300 付费用户 / $8K MRR(约为 BlogToPin 当前体量的一半),以免费档 + SEO 对比页("BlogToPin alternative" / "Tailwind alternative")+ 联盟计划为主要增长引擎。

02市场与竞品调研

2.1 平台基本盘:Pinterest 是"图片版 Google"

Pinterest 的本质是视觉搜索引擎而非社交网络:用户带着「找灵感 → 存起来 → 去购买」的意图而来,内容生命周期以月计(对比 Twitter/Instagram 以小时计)。这决定了它是内容站获取长尾自然流量的最佳渠道之一。

  • 月活 5.37 亿(2026 Q1),同比增长 7.8%,增长由国际市场(印度、巴西、德国)与男性用户(+12%)驱动;
  • 广告收入 2025 年 $36.5 亿,平均 CPC 约 $0.83、CPM 约 $9.2,为主流平台中最便宜的电商流量;
  • 网站集成量超 88 万个活跃域名,其中 80.3% 是 1-10 人的微型企业 —— 与 SaaS 工具的目标客群完全重合;
  • 优势类目:家居、美食、穿搭、美甲、手工、旅行等视觉型内容。

2.2 直接竞品对比

维度BlogToPinTailwindPinGenerator
定位网站 → AI 批量生成 + 自动排期(全自动)Pinterest 官方合作的排期与增长平台(半自动)批量 Pin 设计工具(偏设计端)
起步价$25/月(年付),月付 $39$14.99/月,有永久免费版$19/月(年付约 $8.5)
网站扫描自动生成✓ 核心能力部分(需逐页操作)
智能排期✓ Board 匹配 + 最佳时间✓ SmartSchedule/SmartLoop✗ 需搭配其他工具
免费档✗ 仅限量试用,且不退款✓ 每月 5 帖试用积分
公开 API / MCP
经营数据$15-16K MRR、400+ 订阅者、月流失 10-15%、累计上传 374 万 Pin品类第一,自称用户每月从 Pinterest 获 1 亿+ 点击自称 36,739+ 用户
主要弱点无免费档、UI 粗糙、无 API、按天限量、退款政策差贵且重、不做内容生成、功能拆分单独收费只解决设计不解决分发、积分制体验差
Tailwind 官网首页
Tailwind:品类老大,主打排期与分析,不做自动生成
PinGenerator 官网首页
PinGenerator:主打「1 分钟生成 1 个月内容」,与 BlogToPin 高度雷同
竞品数据可信度说明:各家宣传的流量倍数(3.2x 流量、2.8x 点击率等)均为厂商自述营销数据,缺乏第三方验证;BlogToPin 的 MRR 数据来自创始人在 Indie Hackers 与访谈中的自报,月度间有波动。本报告仅将其作为「模式可行性」的证据,不作为效果承诺。

2.3 GitHub 市场数据分析

我们检索了 GitHub 上与 Pinterest 及社交排期相关的仓库(2026-07 数据),结论是:通用社交排期赛道开源竞争激烈,但 Pinterest 垂直自动化几乎无人做

通用社交排期开源工具(星标数)

Postiz(含 AI Agent)32,644★
Mixpost(自托管)3,381★
social-media-agent2,645★
brightbean-studio1,931★

Pinterest 专属仓库(星标数)

php-pinterest-bot(非官方)413★
pinterest/api-quickstart(官方)190★
pinterest-api-php(已停更)171★
pinterest-python-sdk(官方)82★
头部开源排期工具其他通用排期工具Pinterest 专属仓库

三个关键读数:

  1. 「pinterest api」全站仅 740 个仓库,且头部多为过时的 PHP/Python API 包装器或爬虫,最近活跃维护的寥寥无几 —— 开发者生态是荒地;
  2. 「social media scheduler」有 1,764 个仓库,Postiz 一家独大(32.6K★)并已转向 Agent 化(提供 MCP CLI),证明「排期工具 + AI Agent 接口」是被开源社区强烈验证的方向 —— 但 Postiz 是通用工具,Pinterest 只是其众多渠道之一,没有网站扫描和 Pin 生成能力;
  3. 「网站扫描 → AI 生成 Pin → 智能排期」这条垂直链路在 GitHub 上完全空白,既没有开源实现,也没有独立产品的开源客户端。这意味着做出公开 API + MCP Server 后,PinPilot 可以成为 AI Agent 生态里 Pinterest 自动化的默认选择。

2.4 Pinterest API 接入可行性

项目Trial 试用层Standard 标准层
费用免费免费
速率限制全应用 1,000 次/天(Pin 对公众不可见)100 次/秒/用户,分类目另有每分钟配额
获取方式注册开发者应用即得提交完整 OAuth 流程演示视频人工审核
常见拒绝原因视频未展示 OAuth 全流程 / 未展示真实 Pinterest 集成 / 隐私政策链接无效

结论:API 免费且限额充裕(100 次/秒远超排期发布需求),唯一门槛是 Standard 审核,需在 MVP 阶段就准备好演示视频与隐私政策页。BlogToPin 已通过同样审核,证明此路径对第三方排期工具畅通。

2.5 市场空位总结

🎯 空位一:免费档

BlogToPin 无永久免费版且不退款,是用户吐槽最多的点。Cloudflare 架构让我们送得起免费档,把它变成获客漏斗顶端。

🤖 空位二:AI Agent 接口

三家竞品都无公开 API/MCP。2026 年内容创作者正在用 Claude/Cursor 等工具编排工作流,提供 MCP Server 即成为该生态唯一选择。

💰 空位三:价格锚点

BlogToPin 月付 $39 起。凭成本优势定价 $15 起,配合"BlogToPin 平替"SEO 对比页,直接截流其被流失率赶走的用户。

03产品名称

命名原则:2 个音节内可拼读、含 "Pin" 保证受众秒懂、带一个可传播的隐喻、.com 或 .io 域名有注册可能性。候选如下:

候选名隐喻 / 记忆点传播性风险
PinPilot ⭐ 推荐「自动驾驶仪」——把 Pinterest 放上 autopilot,一词说清产品价值;Slogan 顺手就有:"Put your Pinterest on autopilot."高:pilot 全球通用词,口播无歧义pinpilot.com 可能溢价,可用 pinpilot.io / getpinpilot.com
Pinflow「流水线」——内容像水一样自动流向 Pinterest中高:flow 是 SaaS 命名热词,略显同质化与多款 "xxflow" 工具撞名
Repinly「repin + ly」——强调持续转发扩散中:后缀 -ly 亲切,但未表达"自动"曾有同名分析工具(已死),需查商标
Pinloop「循环」——排期循环、内容循环利用中:与 Tailwind 的 SmartLoop 概念相近易被视为 Tailwind 附属功能
Pinlane「专用车道」——你的内容专属快车道中低:需要解释记忆点弱
定名:PinPilot。理由:① 受众广 —— "pin + pilot" 两个初中词汇,全球博主无理解成本;② 小众易传播 —— 在 Pinterest 工具这个小圈子里,"autopilot" 隐喻直接对标用户最想要的东西(挂机涨流量),适合口口相传与 SEO("pinterest autopilot" 是现成搜索词);③ 品牌延展性好 —— 后续功能可自然命名为 Copilot 模式(人工审核)/ Autopilot 模式(全自动)。

04用户群体

Pinterest 网站集成用户中 80.3% 是 1-10 人微型企业,付费决策链短、对价格敏感、对"省时间"极度买单。按优先级分四层:

P0 · 内容博主 首发人群

是谁:WordPress / Medium / Substack 上的美食、家居、DIY、旅行、母婴博主,靠广告与联盟变现。
痛点:每天需要 5-10 个 Pin 才能起量,手工设计一个要 5-10 分钟;请 VA 代做每月 $200+。
付费意愿:$15-40/月。BlogToPin 的主力客群,也是其流失率最高的人群(预算敏感)。
触达:Pinterest 增长类 YouTube/博客、Facebook 博主群、"BlogToPin alternative" 搜索词。

P0 · 电商卖家 客单价高

是谁:Etsy / Shopify / RedBubble / Amazon 卖家,商品天然是视觉素材。
痛点:SKU 多,逐个做 Pin 不现实;Pinterest 是家居/手工类目转化最好的免费流量。
付费意愿:$40-100/月,看重「导入商品目录 → 批量出 Pin」。
触达:Etsy 卖家社区、Shopify App Store(V2 阶段上架插件)。

P1 · 代运营机构 / VA 扩容器

是谁:管理 5-50 个客户 Pinterest 账号的小型机构与自由职业者。
痛点:按账号收费的工具(多数竞品)让成本随客户数线性上涨。
付费意愿:$80-150/月,前提是无限账号 + 团队协作 + 白标报表
价值:单客 LTV 最高、流失率最低,是从 $8K 到 $30K MRR 的关键人群。

P2 · 无图内容站 差异化人群

是谁:SaaS 博客、Newsletter、播客、YouTube 频道 —— 有内容但没有现成图片素材。
痛点:想吃 Pinterest 流量但"没有图",被多数工具拒之门外。
方案:纯文字模板 + AI 生图,这是 BlogToPin 已验证但做得浅的场景。
意义:拓宽 TAM,让"任何有 URL 的东西"都是潜在客户。

反用户画像(明确不服务谁):需要多平台一体化管理的团队(让给 Postiz/Buffer)、追求粉丝互动运营的品牌号(让给 Tailwind Communities)、灰产批量养号者(API 合规红线,主动风控拒绝)。聚焦让产品保持简单。

05功能规划

三阶段推进:MVP 先跑通「URL 进 → 排期出」的最小魔法时刻,V1 补齐智能化与留存功能,V2 建立生态壁垒。

MVP(第 1-6 周)—— 跑通核心链路

功能说明优先级
网站扫描输入 URL,解析 sitemap 与页面,抽取标题、正文摘要、全部可用图片;自动过滤推荐位、广告、头像等噪音图P0
AI 标题与描述为每个页面生成多组独一无二的 Pin 标题(≤100 字符)与描述(≤500 字符),自动嵌入关键词,支持语气选项P0
模板化 Pin 生成内置 10-15 套 2:3 竖版模板(文字叠加 / 拼贴 / 纯文字),批量渲染成图并存入 R2P0
Pinterest 连接与发布OAuth 授权、读取 Board 列表、创建 Pin;发布队列削峰、失败重试P0
基础排期选择每日条数与时间窗,自动铺满未来 30 天日历;可拖拽调整P0
CSV 导出导出 Pinterest 官方批量上传格式,服务想手动导入获得官方最佳分发的用户,也是免费档的核心价值P0
订阅计费复用 TanStarter 的 Stripe/Creem 集成,四档价格 + 用量计数P0

V1(第 7-12 周)—— 智能化与留存

功能说明
智能 Board 匹配按 Pin 内容与 Board 主题的语义相似度自动分配,替代手工逐条选择
最佳发布时间基于账号历史互动数据 + 类目基准,为每条 Pin 挑选时段
智能打乱同页面的多个 Pin 分散到不同日期、不同 Board、轮换落地链接,规避垃圾内容判定
Analytics 看板展示曝光、保存、出站点击;按模板/配色聚合,识别最能转化的设计
AI 生图与拼贴无图页面用 AI 生成配图;多图页面自动出拼贴 collage 提升点击率
低表现 Pin 清理自动归档表现垫底的 Pin,维护账号整体互动率

V2(第 13 周起)—— 生态壁垒

功能说明
公开 API + MCP Server全赛道唯一:让用户在 Claude、Cursor 等 Agent 里直接调用「扫描/生成/排期」,吃下 AI 工作流生态的默认位
Canva 模板导入兼容用户已有的 Canva 设计资产,降低迁移成本
商品目录集成Shopify / Etsy 应用市场插件,商品自动同步为 Pin 素材
团队协作与白标多成员、客户分组、白标报表,服务机构客群
A/B 模板实验同内容双模板小流量对比,胜者自动放量

06用户体验与 UI 交互

6.1 核心体验原则

10 分钟魔法时刻

注册到看见「30 天排期日历铺满」不超过 10 分钟。竞品的 aha moment 都藏在多步配置之后,我们把它前置到 Onboarding 内完成。

Copilot / Autopilot 双模式

新手默认 Copilot(生成后人工审核再发布),建立信任后一键切 Autopilot(全自动)。信任的渐进转移是留存关键。

批量优先

一切操作按「批」设计:批量选择、批量换模板、批量改 Board、批量重生成文案。单条编辑是例外而非常态。

6.2 核心用户旅程

STEP 1
接入
输入网址 → 扫描进度实况 → OAuth 连接 Pinterest
STEP 2
生成
选模板风格与语气 → AI 批量产出 Pin
STEP 3
审核
网格视图快速过审,不满意的批量重生成
STEP 4
排期
一键铺满 30 天日历,可拖拽微调
STEP 5
复盘
看板归因最佳模板/配色,反哺下一轮生成

6.3 关键界面与交互细节

界面设计要点
向导式 Onboarding三步向导(网址 → 扫描 → 连接 Pinterest),扫描时实时滚动展示"已发现 N 个页面 / M 张图片",用进度实况代替死等;扫描完成即预生成 3 条示例 Pin 作为即时奖励
Pin 审核网格2:3 卡片瀑布流 + 复选框;顶部工具条常驻「全选 / 换模板 / 重写文案 / 加入排期」;单卡 hover 出现快捷编辑;键盘 J/K 巡航 + X 勾选,服务重度用户
排期日历月视图为主,每天显示 Pin 缩略 chips;拖拽跨天移动;顶部密度滑杆(每天 N 条)改动即时重排;冲突(同 Board 同链接过近)用琥珀色标出并给一键修复
数据看板四指标卡(曝光/保存/出站点击/互动率)+ 趋势图 + 「最佳模板 Top3」模块;每个数字可下钻到具体 Pin 列表
设置与账号复用 TanStarter 现有 settings 布局(profile / billing / files 的同级导航),新增 Pinterest 账号管理与 API Key 页

6.4 状态设计(空 / 载入 / 出错)

  • 空状态即引导:空日历显示虚线占位 Pin + 「让 AI 填满这 30 天」按钮;空看板显示行业基准数据作参照,避免冷启动的荒凉感。
  • 长任务异步化:扫描与批量生成都是分钟级任务,一律进队列 + 页面实况进度 + 完成后邮件/站内通知,绝不让用户盯着转圈。
  • 失败可自愈:发布失败的 Pin 自动重试三次,仍失败则在日历上标红并附「一键重新排期」,不静默丢失。
  • 额度触顶友好:AI 配额用尽时不阻断流程,降级为「模板 + 原文摘要」继续生成,同时给出升级入口。

6.5 视觉语言

  • 色彩:主色取 Pinterest 红的邻近色(#E60023 → 品牌红 #EF3E56),中性色底 + 单强调色,界面本身要"素",让用户的 Pin 图成为唯一主角;
  • 布局:沿用 TanStarter 的 shadcn/ui 组件体系与 dashboard 布局,卡片圆角 12-14px,暗色模式一等公民;
  • 动效:只在两处用动效——排期成功时日历 chips 依次落位、看板数字滚动,其余保持克制。

07产品定价

策略:每一档都卡在竞品的心理价位之下,用免费档做漏斗、Solo 档做冲动购买、Pro 档做主力营收、Agency 档做利润。全档位不限网站数与 Pinterest 账号数(沿用 BlogToPin 已验证的差异化,且我们的成本结构支撑得起)。

Free 获客漏斗

$0
永久免费
  • 1 个网站
  • 3 Pin/天 自动发布
  • 20 AI Pin/月
  • CSV 导出无限制
  • 带 PinPilot 水印

Solo 主推

$15/月
年付 $144($12/月)
  • 无限网站 / 账号
  • 50 Pin/天
  • 600 AI Pin/月
  • 智能排期 + 基础分析
  • 去水印

Pro

$39/月
年付 $374($31/月)
  • 400 Pin/天
  • 1,500 AI Pin/月
  • 高级分析 + A/B 实验
  • 公开 API / MCP 访问
  • 优先支持

Agency

$89/月
年付 $854($71/月)
  • 1,200 Pin/天
  • 4,000 AI Pin/月
  • 团队成员 + 客户分组
  • 白标报表
  • 迁移协助 + 策略通话

与竞品价格锚点对照

档位场景PinPilotBlogToPinTailwindPinGenerator
免费长期使用✓ 永久免费档5 帖/月试用积分
个人入门(月付)$15$39$24.99$19
重度用户$39(含 API)$50-79$49.99$39
机构/高量$89$125-179需加购多产品$99
  • 退款政策反着打:BlogToPin 明确不退款且被用户诟病,PinPilot 提供 14 天无理由退款 —— Cloudflare 架构下试用期成本可忽略,退款政策本身就是营销素材。
  • AI 用量托底:AI Pin 配额是主要变动成本,按配额毛利测算:文案 + 生图单条成本约 $0.01-0.03,Solo 档 600 条封顶成本 <$18 的极端情况仅出现在满额使用(实际用户均值远低于此),毛利率稳定在 75% 以上。
  • 升级钩子:免费档水印 + 每天 3 条的量刚好"看见效果但不够用",账号跑出第一波曝光数据时弹出升级提示,是转化率最高的时机。

08产品优势

差异化矩阵

能力PinPilotBlogToPinTailwindPinGenerator
网站扫描 → 自动生成部分
智能 Board / 时间排期
永久免费档
公开 API + MCP Server✓ 独有
14 天退款✗ 明确不退视情况视情况
无限网站 / 账号✓ 全档位按账号收费按档位
无图站支持(纯文字/AI 图)部分
边际成本结构Cloudflare 近零传统云传统云(重)传统云

护城河的构建顺序

  1. 短期(上线期):价格 + 免费档。用成本优势打「BlogToPin 平替」定位,配合 versus 对比页收割搜索流量(BlogToPin 自己就靠 versus 页打 Tailwind,此打法已验证)。
  2. 中期(6 个月):留存数据飞轮。竞品月流失 10-15% 的根因是"排完一个月就想停订"。Analytics 看板 + 低表现 Pin 清理 + 周报邮件让用户持续看到增长归因,把工具变成"离不开的仪表盘"。
  3. 长期(12 个月):Agent 生态卡位。MCP Server 让 PinPilot 成为所有 AI 工作流里"发 Pinterest"的默认动词,生态位一旦占住,后来者面临集成惯性壁垒。

09交互原型

以下为可点击的高保真流程原型,模拟 PinPilot 的五个核心屏幕。点击顶部标签切换屏幕;向导、Pin 网格、日历与看板均含真实交互(按钮、勾选、生成进度、Board 匹配等),用于向设计与前端传达预期行为。

pinpilot.io
🚀 Pinterest API 认证工具 · 永久免费档
一分钟,把一个月的
Pinterest 排期放上自动驾驶

输入你的网址,PinPilot 扫描全站、AI 生成带文案的 Pin、自动匹配 Board 与最佳时间。你只管写内容,流量交给我们。

无需信用卡 · 3 Pin/天永久免费 · 14 天无理由退款

5.4亿
Pinterest 月活
1 分钟
生成 30 天排期
75%+
省下的运营时间
$15 起
不到竞品一半
🧭 新建项目
📌 我的 Pin
🗓 排期日历
📊 数据看板
⚙️ 设置
接入你的网站
1 / 3 步 · 输入网址

支持 WordPress、Shopify、Etsy 店铺、Medium、YouTube 频道等任何公开网址。

🧭 新建项目
📌 我的 Pin
🗓 排期日历
📊 数据看板
⚙️ 设置
审核生成的 Pin
AI 已为 128 个页面生成 96 条 Pin · Copilot 模式(审核后发布)
🧭 新建项目
📌 我的 Pin
🗓 排期日历
📊 数据看板
⚙️ 设置
2026 年 7 月排期
智能打乱已启用:同页面 Pin 分散至不同日期与 Board
每日密度 3 Pin/天
🧭 新建项目
📌 我的 Pin
🗓 排期日历
📊 数据看板
⚙️ 设置
近 30 天表现
@cocktailwave · 数据每日同步自 Pinterest Analytics API
284K
总曝光
↑ 12.5%
1,847
保存数
↑ 8.2%
892
出站点击
↑ 21.1%
4.7%
互动率
↑ 0.9pt

曝光趋势

最佳模板 Top 3 (点击查看该模板全部 Pin)

原型说明:以上交互(扫描进度、OAuth 状态、批量勾选、密度滑杆、一键铺期)与第 6 章的交互规范一一对应,可直接作为前端验收基准。

10技术架构与开发路线

整体原则:最大化复用 TanStarter 已有能力,新代码只写业务核心。全栈跑在 Cloudflare Workers 上,无服务器运维、无闲置成本,免费档用户的边际成本趋近于零。

10.1 TanStarter 现有模块 → 产品能力映射

TanStarter 模块直接承担的产品能力改造量
Better Auth(src/auth)注册登录、邮箱验证、API Key(服务公开 API 鉴权)
Stripe / Creem(src/payment)四档订阅、升降级、按配额计量的用量上报
D1 + Drizzle(src/db)全部业务数据;沿用 app.schema 追加业务表
R2(src/storage)生成的 Pin 图片、用户上传的模板素材
邮件(src/mail)生成完成通知、周报、配额提醒、流失挽回序列
Admin 后台(src/routes/admin)用户管理、用量监控、风控封禁
博客(Content Collections)SEO 内容营销:versus 对比页、教程、案例
通知(src/notification)新订阅 / 流失 / 队列异常推送到 Discord/飞书

10.2 新增模块(按 Provider 模式组织)

沿用 TanStarter 的 provider 抽象惯例,每个新领域独立成目录、可替换实现:

新模块职责Cloudflare 依赖
站点爬取 crawler解析 sitemap 与 HTML、抽取标题/摘要/图片、噪音图过滤与质量评分;受 robots 协议约束Workers fetch + HTMLRewriter;复杂页面用 Browser Rendering
AI 生成 generator标题/描述生成(多语气)、AI 配图、拼贴合成;provider 可在 Workers AI 与 OpenAI 间切换以平衡成本Workers AI / 外部 LLM API
Pin 渲染 renderer模板 + 文案 + 图片 → 2:3 成品图,写入 R2Browser Rendering 截图 或 SVG→图像方案
Pinterest 集成 pinterestOAuth 授权与 token 刷新、Board 读取、Pin 创建、Analytics 拉取;统一处理限流头—(外部 API)
排期引擎 schedulerBoard 语义匹配、最佳时间计算、智能打乱、30 天铺期算法Cron Triggers 触发
发布队列 publisher到点发布、指数退避重试、死信告警、配额扣减Cloudflare Queues
开放接口 openapi/mcpREST API(API Key 鉴权,复用 Better Auth apiKey 表)与 MCP Server,暴露扫描/生成/排期三组动作同一 Worker 内路由

10.3 数据模型(文字描述)

  • website:用户接入的站点,记录 URL、扫描状态、最近扫描时间;
  • page:扫描出的页面,含标题、摘要、规范链接,与 website 多对一;
  • page_image:页面图片及其质量评分、噪音标记;
  • pinterest_account:OAuth token(加密存储)、账号信息、token 过期时间;
  • board:同步自 Pinterest 的 Board 及其主题向量(用于语义匹配);
  • pin:生成的 Pin —— 文案、模板 ID、R2 图片键、落地链接、状态机(草稿 → 已审核 → 已排期 → 已发布 / 失败 / 已归档);
  • schedule_slot:排期槽位,绑定 pin、board、计划时间与实际发布时间;
  • analytics_snapshot:按日拉取的 Pin 级指标快照,支撑看板与模板归因;
  • usage_counter:按用户按月的 AI 生成量与发布量计数,驱动配额与计费。

10.4 核心链路的运行时形态

用户请求
Server Function
校验配额 → 建任务记录 → 入队,立即返回任务 ID
Queues
异步消费
爬取 / 生成 / 渲染分批执行,进度写回 D1
前端
轮询进度
TanStack Query 轮询任务状态,驱动实况进度条
Cron
定时发布
每 5 分钟扫描到期槽位 → 入发布队列 → 调 Pinterest API
Cron 日任务
数据同步
拉取 Analytics、归档低表现 Pin、发周报邮件

要点:所有分钟级任务一律异步化(Workers 单请求有 CPU 时限);对 Pinterest API 的调用集中在 publisher 一处并读取限流响应头自适应节流,避免账号被限。

10.5 Pinterest API 接入与合规路线

  1. 第 1-2 周:注册开发者应用拿 Trial 层,用测试账号跑通 OAuth 与 Pin 创建(Trial 层 Pin 不公开可见,仅供联调);
  2. 第 5 周:MVP 内部可用后,录制完整演示视频(OAuth 全流程 + 真实创建 Pin),备好可公开访问的隐私政策页,提交 Standard 审核;
  3. 预案:审核平均一至数周且可能被拒(常见原因:视频未展示完整 OAuth、集成不真实),被拒则按反馈补录申诉;审核期间以 CSV 导出 作为可用的发布通道,产品不因审核阻塞上线;
  4. 合规红线:绝不使用 cookie/密码模拟登录(竞品 php-pinterest-bot 的老路,账号会被封);遵守用户数据最小化,token 加密落库。

10.6 里程碑排期(12 周)

M0 · 地基(第 1-2 周)
TanStarter 裁剪与品牌化 · 业务表建模与迁移 · Pinterest 开发者应用注册 · Trial 层 OAuth 联调
M1 · MVP 核心链路(第 3-6 周)
爬取模块 → AI 文案 → 模板渲染 → 审核网格 → 基础排期 → 队列发布 → CSV 导出 · 订阅计费接通 · 提交 Standard 审核 · 内测 20 名种子用户
M2 · 智能化与公测(第 7-10 周)
智能 Board 匹配 · 最佳时间 · 智能打乱 · Analytics 看板 · AI 生图/拼贴 · E2E 用例覆盖五大旅程(沿用 tests/e2e 体系)· Product Hunt / 博主社区公测
M3 · 增长与生态(第 11-12 周起)
公开 API + MCP Server · versus 对比页与 SEO 内容批量上线 · 联盟计划(30% 循环佣金)· 低表现 Pin 清理与周报邮件(留存飞轮)

10.7 主要风险与对策

风险对策
Standard API 审核延迟或被拒CSV 导出先行承载发布;审核材料在 M1 就绪;社区有大量通过先例(Postiz 用户亦通过)
AI 成本随免费档失控免费档月配额 20 条 + Workers AI 低价模型兜底;付费档用量计数硬顶
BlogToPin 降价反击竞争落点不在价格而在免费档 + API/MCP + 退款政策的组合拳;对方单人维护、响应半径有限
Pinterest 平台政策收紧严格走官方 API、控制发布频率上限、内置反垃圾规则(智能打乱本身就是合规特性)
爬取遇到反爬/动态渲染站点降级链:sitemap → HTMLRewriter → Browser Rendering → 用户手动粘贴 RSS/URL 列表

下一步行动清单:① 核验 pinpilot.io / getpinpilot.com 域名与商标;② 注册 Pinterest 开发者应用(当天可得 Trial);③ 按 M0 清单裁剪 TanStarter 并建业务表;④ 在现有博客模块发布首批 versus 对比页占位收录。