stripe-directory

Stripe Directory 搜尋

使用 stripe directory search 將模糊的市場需求轉化為精簡且相關的候選名單。即使使用者完全沒提到「Stripe Directory」，只要是尋找特定垂直領域、工作流程、痛點或待辦任務（Job-to-be-Done）的供應商、工具、合作夥伴或服務提供者的需求，都應使用此功能。

大多數請求都屬於探索（discovery）——尋找並比較服務，這也是下文的核心任務。部分服務亦支援 MPP（MPP = Machine Payment Protocol），這意味著你（Agent）可以對其 HTTP 402 (Payment Required) 端點付款並直接使用該服務。當使用者確實想要使用或購買某項服務時，請展示這些結果並詢問是否需要購買——詳情請參照文末的「購買（Purchasing）」。

執行流程

1. 僅針對缺少的必要資訊進行確認：買家/垂直領域、待辦任務、必須具備的功能、地理位置（僅在有影響時才確認）。

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 驗證（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 challenge 回應標頭以確認金額：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：僅供偵錯使用的備用方案。

絕對不可虛構搜尋結果，也不可跳過價格展示與使用者確認步驟。