stripe-directory

Stripe Directory Search

使用 stripe directory search 将模糊的市场需求转化为一份精准、精简的候选名单。即使用户从未说出“Stripe Directory”，只要提出寻找某个垂直领域、工作流、痛点或待办任务（job-to-be-done）的供应商、工具、合作伙伴或服务商，都可以使用此功能。

绝大多数请求属于服务探索（discovery）——寻找并对比服务。这也是下文的核心任务。部分服务还支持 MPP（Machine Payment Protocol，机器支付协议），这意味着你（Agent）可以直接向其 HTTP 402（Payment Required）端点付款并直接调用。当用户明确想要使用或购买某项服务时，请展示这些结果并询问是否需要购买——详见末尾的“服务购买”章节。

处理流程（Process）

1. 仅澄清缺失的关键信息：买方/垂直领域、待办任务（job-to-be-done）、必须具备的能力、地理位置（仅在有影响时澄清）。

2. 迭代搜索：stripe directory search "<query>" --format json

   • 使用简短的名词短语，每次查询聚焦一个视角；运行 1-3 个查询，然后根据返回结果扩大或缩小范围。
   • 需覆盖的切入视角：垂直领域 → 工作流 → 痛点 → 关联领域。两个示例：
     • 服务业/传统行业：垂直领域 (electrician software, electrical contractor) → 工作流 (field service management, dispatch invoicing estimates) → 痛点 (job scheduling, quote automation) → 关联领域 (home services automation, contractor crm)。
     • SaaS/软件：垂直领域 (b2b saas billing, developer tools) → 工作流 (subscription management, usage-based metering) → 痛点 (failed payment recovery, revenue recognition) → 关联领域 (analytics dashboards, customer onboarding)。
   • 硬性约束条件 → 使用筛选参数：--countries-supported=US, --has-stripe-app=true, --link-supported=true, --stripe-projects-supported=true。
   • 如果用户希望使用/购买服务，至少在一个搜索中传入 --mpp-supported 参数，以便找到支持程序化付费的结果。
   • 处于小众领域且结果稀少？可以提高 --limit 并尝试下一页 --page，不要过早下结论认为没有结果。

3. 去重与打分：以 display_name、description、url、username 作为判断依据。

   • 优先选择描述/网站与目标工作流高度匹配的结果。
   • 信任信号越多越好：Projects 服务商、已启用 Link、Marketplace 应用、Stripe Verified（已验证）。对于购买/使用意图，还要优先选择支持 MPP 的结果。
   • 描述较简略但品牌/域名匹配度极高 → 保留在权重较低的候选池中，不要直接丢弃。

4. 返回精简名单，而非信息轰炸——提供 5-10 个强相关匹配结果，并按以下分类分组：

   • 直接匹配（direct） / 关联领域（adjacent） / 需要人工复核（needs manual review）
   • 每个条目包含：名称 · 匹配原因 · URL（· 提取出该结果的查询词，在有用时附上）。
   • Projects 服务商：提供后续操作提示。JSON 会在每个结果的 projects.catalog_command / projects.install_command 字段下给出精确命令（stripe projects catalog <provider>, stripe projects add <provider>）。
   • 支持 MPP 的结果：注明其支持程序化购买，并附上 mpp.slug / mpp.url。

5. 坦诚面对偏弱的结果——如果结果稀少或过于宽泛，如实说明并进行调整：扩大范围、缩小范围或尝试同义词，而不是用噪音数据凑数。

始终汇报你运行过的具体查询（及筛选条件），方便用户继续迭代交流。

服务购买（仅当用户希望购买或调用服务时）

支持 MPP 的结果可以直接付费购买。切勿在未经提示的情况下主动发起购买。当用户确实想购买时，在进行任何操作前，先展示所有可用的支付方式菜单，并询问用户希望使用哪一种：

"你想使用哪种支付方式？

• Link CLI — Stripe 原生支持，提供测试模式（推荐）

• Tempo — 加密货币钱包
• Privy Agent Wallet CLI — 加密货币钱包
• mppx — 仅供调试的备用方案"

用户选择后，静默运行 which <tool> 2>/dev/null 检查该工具是否已安装。若未安装，提示可帮忙安装（例如 Link CLI 执行 npm i -g @stripe/link-cli），并在获得确认后再继续。

在发生任何资金变动前，务必展示价格并获得用户的明确授权；优先选择无费用的测试路径。

简要流程：

1. 从结果的 mpp.slug / mpp.url 中解析出真实可调用的端点。mpp.url 通常是 mpp.dev 的落地页表单（https://mpp.dev/services#<slug>）——如果是这种情况，需在 mpp.dev 上解析出真实的原始端点。通过读取 HTTP 402 质询响应来确认金额：curl -s -D - -o /dev/null <endpoint_url>（查找 WWW-Authenticate 响应头）。
2. 使用用户选择的支付工具。
   • link-cli（Stripe 原生 Shared Payment Token，支持测试模式，无需加密货币钱包，仅限美国 Link 账号；npm i -g @stripe/link-cli）：auth login → mpp decode --challenge "<value>"（获取 network_id）→ spend-request create --credential-type shared_payment_token --network-id <id> --amount <cents ≤50000> --context "<100+ chars>" --request-approval（挂起等待用户审批）→ mpp pay <endpoint_url> --spend-request-id <approved_id>。
   • Tempo：tempo wallet login / services / request。
   • Privy：@privy-io/agent-wallet-cli。
   • mppx：仅供调试的备用方案。

严禁虚构结果，也绝对不能跳过价格确认与授权环节。