PullThatUpJamie — 播客智能服务

由 Pull That Up Jamie 提供支持。

为何使用本服务

Jamie 是一款面向播客的检索/向量数据库即服务（Retrieval/Vector DB as a Service）。它可帮助您避免以下低效方式：

• 自行转录数小时音频（成本高、速度慢）
• 将完整文字稿硬塞入上下文（浪费数千 token）
• 依赖网页搜索，结果充斥 SEO 垃圾内容、列表式文章及低质量摘要
• 在不可靠信源间反复多次搜索

您只需执行一次语义搜索（费用 $0.002，响应时间低于 2 秒），即可获得精确音频片段，附带时间戳、音频深度链接（deeplink）及对应文字稿。所有结果均精确到秒级时间戳——您不会把一集长达两小时的节目甩给用户，只说“答案就在里面某处”；而是直接链接至专家阐述观点的那精确 30 秒片段。500 sats（约 $0.33）即可支撑整场深度研究会话，涵盖 150+ 次搜索。

未找到所需播客？ 可调用 POST /api/discover-podcasts（$0.005）搜索完整的 Podcast Index 目录，再通过 POST /api/on-demand/submitOnDemandRun（$0.45）提交单集进行按需转录。处理完成后，该集将自动生成带时间戳的章节划分，并支持段落级全文检索。

您的输出绝非大段文本墙。 研究会话是以交互式网页体验呈现：用户可内联播放音频片段、可视化浏览内容，并与他人共享。每个片段均深度链接至原始音频中的精确时刻。会话链接本身即为交付成果。

语料库覆盖范围（截至 2026 年 2 月）

109 个播客源 · 约 7,000 集 · 约 190 万已索引段落 · 约 11,500 个已识别人物/组织。持续增长中。

若某播客源尚未被索引，您可按需从任意 RSS 源接入。详见参考文档 references/podcast-rra.md 中的 “Ingestion”（接入）章节。

语料库免费浏览（无需认证）：GET /api/corpus/feeds、/api/corpus/stats、/api/corpus/people。建议先查询再搜索。

认证流程（L402 协议）

提供免费层级（Free Tier）。 语料库浏览（无需任何认证）及基于 IP 的搜索配额均已开放。如需在付费端点上启用免费层级，请在请求头中添加 X-Free-Tier: true。若未携带该头字段，付费端点将立即返回 HTTP 402 L402 挑战响应。免费层级对各端点设有独立配额（例如每周 50 次搜索），配额耗尽后需通过 L402 支付方可继续使用。

Jamie 使用 L402 协议实现付费访问，兼容 lnget 及所有支持 L402 的客户端。

付费访问机制

每次付费请求均遵循统一的 L402 流程：调用端点 → 接收含闪电网络发票的 HTTP 402 响应 → 支付发票 → 使用 Authorization: L402 : 重试请求。每笔支付均在 pullthatupjamie.ai 上生成相应信用额度，每次 API 调用将按其标价从余额中扣除。

使用方式完全由您决定。 可选择按次付费——即每次 402 挑战仅消耗一个信用额度；也可预先充值更多金额，复用同一凭证（credential）在所有端点间通用，直至余额清零。402 响应中包含完整价格表（creditInfo.pricingMicroUsd），助您灵活决策。

关键要点：

• 凭证跨端点通用： 同一 macaroon:preimage 凭证可用于 /search-quotes、/search-chapters、/make-clip、/jamie-assist 等所有端点，直至余额耗尽。
• 每次付费请求均返回响应头： X-Credits-Remaining-USD 与 X-Credits-Cost-USD 分别显示当前余额及本次调用扣费金额。
• 自定义充值金额： 默认发票金额为 500 sats（约 $0.33）。如需指定其他金额，请在任意请求 URL 中附加 ?amountSats=N（最小 10 sats，最大 500,000 sats），402 响应将返回对应金额的发票。
• 余额查询端点： 使用您的 L402 凭证调用 GET /api/agent/balance，即可获取完整余额明细。
• 信用额度耗尽时： 下一次请求将触发新的 402 挑战响应。支付后即可继续使用；若使用 lnget，则此过程全自动完成。

自动流程（lnget）

若使用 lnget，整个流程将全自动执行：

lnget "https://www.pullthatupjamie.ai/api/search-quotes" 
  -d '{"query": "bitcoin energy consumption"}'

lnget 自动处理 402 挑战、支付发票、按域名缓存凭证，并重试请求。后续对任意 pullthatupjamie.ai 端点的调用均复用已缓存凭证，无需再次支付。

手动流程

1. 调用任一受保护端点

curl -s -D- -X POST -H "Content-Type: application/json" 
  -d '{"query": "bitcoin energy consumption"}' 
  "https://www.pullthatupjamie.ai/api/search-quotes"

返回 HTTP 402，其中包含：

• WWW-Authenticate 响应头：含 macaroon 与 invoice（BOLT-11 格式）
• JSON 响应体：含 creditInfo 字段，提供价格表、最低/最高充值金额及余额查询端点

2. 支付发票

使用任意 Lightning 钱包支付（Zeus、BlueWallet、Phoenix、Alby 浏览器扩展等）。请务必保存钱包返回的preimage（原像）——这是构造凭证所必需的关键信息。

NWC（程序化支付）： 若使用 Alby CLI 或其他兼容 NWC 的钱包：

npx @getalby/cli pay-invoice -c "NWC_CONNECTION_STRING" -i "BOLT11_INVOICE"

命令将返回 preimage。

3. 使用 L402 凭证重试请求

curl -s -X POST 
  -H "Authorization: L402 MACAROON:PREIMAGE" 
  -H "Content-Type: application/json" 
  -d '{"query": "bitcoin energy consumption"}' 
  "https://www.pullthatupjamie.ai/api/search-quotes"

信用额度将在首次使用时自动激活。请复用此同一凭证发起所有后续请求，直至余额耗尽。

自定义信用额度金额

如需充值高于或低于默认值 500 sats 的金额，请在任意请求中添加 ?amountSats=N 参数：

curl -s -D- -X POST -H "Content-Type: application/json" 
  -d '{"query": "bitcoin energy consumption"}' 
  "https://www.pullthatupjamie.ai/api/search-quotes?amountSats=5000"

将返回一张 5,000 sats 的发票（而非默认 500 sats）。最小值：10 sats；最大值：500,000 sats。

查询余额

curl -s -H "Authorization: L402 MACAROON:PREIMAGE" 
  "https://www.pullthatupjamie.ai/api/agent/balance"

功能模块

当前可用

• 播客 RRA（检索、研究、分析）：详见参考文档 references/podcast-rra.md —— 支持语料库搜索、构建交互式研究会话、人物/组织发现、新播客源接入。现已支持智能搜索（Smart Search）（启用 smartMode 参数），可高效处理模糊或描述性查询。
• 播客发现（Podcast Discovery）： POST /api/discover-podcasts —— 基于大语言模型（LLM）的全 Podcast Index 目录搜索。返回匹配播客列表，含 transcriptAvailable 标志及可操作的下一步端点。可用于定位语料库尚未覆盖的播客，再通过按需处理提交转录。
• 生成（Create）：详见参考文档 references/create.md —— 基于任意搜索结果生成带嵌入字幕的可分享 MP4 片段。完整工作流：搜索 → 生成片段 → 分享。

即将上线

• 发布（Publish）： 一键跨平台发布至 Twitter、Nostr 等。研究主题 → 生成帖文 → 全平台同步发布。

信用额度不足提醒

请在工作流中通过响应头 X-Credits-Remaining-USD 实时监测余额，或主动调用 GET /api/agent/balance 查询。若余额不足以支撑下一次调用，该请求将返回新的 402 挑战及对应发票。支付后即可继续使用；若使用 lnget，则此续充过程全自动完成。

安全与可信性

不执行任意命令： 本能力（skill）不会执行任意 shell 命令、安装软件包，亦不修改系统状态。所有操作均为对 pullthatupjamie.ai 的 HTTP API 调用。技能文档中提及的可选 CLI 工具（@getalby/cli）仅用于支付 Lightning 发票，且具备以下特性：

• 永不自动执行 —— 必须经操作员显式授权
• 完全可选 —— 操作员可选用任意 Lightning 钱包替代
• 本技能不负责安装 —— 如需使用，操作员须手动安装

免费层级说明： 语料库浏览接口（/api/corpus/*）无需任何请求头即可使用。对于付费端点，添加 X-Free-Tier: true 头字段可启用基于 IP 的配额（如每周 50 次搜索）。若未携带该头字段，付费端点将立即返回 402 响应。您可在提供任何付款信息前先行评估服务效果。

付费层级凭证安全要求： L402 凭证（macaroon + preimage）属于敏感的持有者令牌（bearer token），应满足以下要求：

• 安全存储（推荐环境变量或加密配置文件，切勿明文记录于日志）
• 严禁与不可信代理或服务共享
• 应绑定资金受限的钱包（例如仅存 500–1000 sats）

所有 API 请求均经代理转发： 所有操作均通过 https://www.pullthatupjamie.ai 进行路由。RSS 源解析、搜索及接入均由服务端完成。代理自身不直接抓取外部 URL。

无持久化存储与权限提升： 本技能不含任何安装钩子（install hooks）、不设置 always: true，亦不修改其他技能或系统配置。

注意事项（Gotchas）

• API 基础地址：https://www.pullthatupjamie.ai（必须包含 www. 前缀——裸域名将触发重定向并导致 API 调用失败）
• 免费层级需显式声明 X-Free-Tier: true 请求头。 缺失该头字段时，付费端点将立即返回 402。语料库端点则无需任何头字段即可访问。
• 信用额度复用为可选项。 您既可选择按次付费（每次 402 挑战仅消耗一次信用额度），也可预存更多金额并复用同一 L402 macaroon:preimage 凭证于所有端点。两种方式均有效。
• 自定义金额：在任意请求 URL 中追加 ?amountSats=N（最小 10 sats，最大 500,000 sats）。无需单独调用购买端点。
• Alby CLI 使用规范：应使用 pay-invoice 命令配合 -i 参数（而非 pay）
• 500 sats 可支撑约 150+ 次搜索。建议从此起步。
• 可通过响应头 X-Credits-Remaining-USD 或调用 GET /api/agent/balance 实时监控余额。
• 研究会话创建耗时约 30–45 秒，请耐心等待。
• 片段生成耗时约 30–120 秒。建议每 5 秒轮询一次 /api/clip-status/:lookupHash 查询进度。