用途:在 frontpage.sh 的永久拍卖中购买广告方块。共有 8 个方块:1 个大型(L)、2 个中型(M1、M2)、5 个小型(S1–S5),每个方块始终可售。每次购买都是一次性翻转:支付该方块的下一次价格,上一任所有者按倍数获得退款,剩余价差的 80% 进入项目池。价格逐次上涨,付款钱包成为新所有者。
安装:npx skills add DFectuoso/frontpage-sh-skills --copy(推荐,安装全部 frontpage 技能)。测试环境可另装 npx skills add DFectuoso/frontpage-sh-skills-dev --copy。
定价:基础价 $0.01(10,000 µUSDC)。大型下次价格 = 当前 × 3.0,退款 1.5×;中型 × 2.0,退款 1.3×;小型 × 1.5,退款 1.1×。退款后价差按 20% 平台 / 80% 项目池分配。USDC 在 Tempo 上为 6 位小数,API 金额均为 µUSDC 整数。不要自行实现倍数,GET /api/ads 已返回预计算的 nextPriceMicros。
流程(MPP 是唯一支付路径):基础 URL https://www.frontpage.sh,机器可读契约见 https://www.frontpage.sh/openapi.json。1) GET /api/ads 获取方块、当前价格与下次购买费用;2) POST /api/preview 铸造预览令牌($0.01 MPP),锁定创意与报价,有效期 10 分钟,返回可分享预览 URL;默认应先向用户展示预览并等待确认,除非用户明确要求直接购买;3) POST /api/buy 按 nextPrice 精确扣费并翻转方块。MPP 自动处理 402 挑战。409 PRICE_CHANGED 表示预览与购买之间价格已变,需按新价重新铸造预览;409 SLOT_CONFLICT 表示并发竞争失败,费用约 1 分钟内自动退还。
预览请求体包含 slot、name、tagline、url、monogram、logoColor、logoBg、adBg、adHeadline、blurb、ownerHandle、ownerEmail(必填,用于收据与退款通知,不公开)、image 或 imageUrl、ctaLabel、perk、promoCode、xHandle、titleFont 等字段。图片仅支持 PNG、JPEG 或 GIF,webp/svg/avif 会被拒绝(400 IMAGE_UNSUPPORTED),服务器校验实际字节;单图最大 3 MB,imageUrl 下载上限 4 MB。大文件(尤其 GIF)不要内联 base64,应托管到公开 URL 并用 imageUrl 传入。推荐尺寸:大型 1712×944、中型 1136×464、小型 560×464。
限制:所有文本字段与创意图片经服务端 OpenAI omni-moderation 审核,违规返回 400 MODERATION_FAILED 且已扣费。翻转即时生效,退款状态见收据 payout.status。资料未提供其他收费、平台或效果信息。