非常早期的实验，但我觉得这会很酷。https://t.co/42iqZXZIGE。https://t.co/KYLX3meYzK

Stripe Directory | Stripe 文档

来源：https://docs.stripe.com/directory

Stripe Directory 是在 Stripe 网络上查找业务的一个统一入口。你可以通过关键词搜索，获取结构化的结果，供用户或 Agent 进行后续操作。

公开预览

搜索商家

使用一个或多个关键词执行 stripe directory search：

> stripe directory search "web browsing api" --format compact  
Stripe  Stripe Machine Name   Profile Apps   Projects Payments Link  
Browserbase @browserbase   ✓    ✓     ✓     ✓  
You.com     @youdotcom     –    –     –     ✓  
Exa         @exalabs       –    ✓     –     ✓  
Firecrawl   @firecrawl     ✓    ✓     –     ✓  

结果中包含结构化数据（提供者的 slug、MPP 端点、应用列表等），你可以利用这些数据继续集成。

Stripe Directory 索引的内容

• Stripe Apps：在 Stripe App Marketplace (https://marketplace.stripe.com/) 上发布的应用，例如账单工具、分析工具、客服集成等，用于扩展 Stripe 控制台。
• Stripe Projects 提供者：通过 Stripe Projects (https://projects.dev/) 可用的服务，可以使用 CLI 命令进行配置。
• Machine Payments 端点：mpp.dev (https://mpp.dev/) 上的按量付费 API，可以使用 mppx fetch 编程支付。
• Stripe 商业网络：整个 Stripe 网络中的业务和服务。

在终端中设置 Stripe Directory

使用 Stripe CLI Directory 插件从终端搜索业务。

1. 安装或升级 Stripe CLI (https://docs.stripe.com/stripe-cli/install)，然后运行 stripe login 登录。
2. 安装 Directory 插件：

   stripe plugin install directory  
   

   要升级插件，请运行 stripe plugin upgrade directory。

设置 Agent 使用 Stripe Directory

Stripe Directory 允许 AI Agent 自主发现、评估并集成服务。

为 Agent 提供结构化输出

要获取结构化输出，请使用 --format json：

stripe directory search "serverless postgres database" --format json  

Agent 可以解析结果，根据需求比较选项，并利用返回的 mpp\.dev 端点或 projects\.dev 列表自动完成集成。

为 Agent 安装技能

要将 Agent 连接到 Stripe Directory，请使用以下任一选项：

• 安装一个全局 Agent 技能，向 Agent 展示如何使用 Stripe Directory。
• 或者，一次性安装所有 Stripe 技能 (https://docs.stripe.com/skills)。

安装后，Agent 可以搜索目录、解释结果，并在无需额外指示的情况下使用返回的端点。

使用示例

与 Stripe Projects 集成

假设一位构建应用的开发者需要数据库提供商，可以利用 Stripe Directory 不仅找到提供商，还能与之集成。

首先，开发者搜索服务：

stripe directory search "serverless postgres database"  

这会生成几个结果，其中一个就是 Neon：

╭──────────────────────────────────────────────────────────────────────────────╮  
│ Neon                                                                       │  
│ Serverless postgres database                                               │  
├──────────────────────────────────────────────────────────────────────────────┤  
│ Web         https://stripe.com/@neon                                       │  
│             https://neon.com/                                              │  
│                                                                            │  
│ Stripe Apps Neon                                                           │  
│             https://stri.pe/sl/LIsxeQPu                                    │  
│                                                                            │  
│ Stripe Projects Learn more using                                           │  
│             stripe projects catalog neon                                   │  
│                                                                            │  
│ Machine Payments —                                                         │  
│ Link supported ✅                                                          │  
╰──────────────────────────────────────────────────────────────────────────────╯  

Neon 同时也是 Stripe Projects 的提供商，因此 Directory 会返回一条命令，用于检查提供商的目录列表：

stripe projects catalog neon  

执行该命令后，不仅能获得有关服务的信息，还会推荐进一步的集成命令：

使用 Machine Payments

如果搜索结果中显示 machine payments 端点，你可以立即使用 mppx 支付并使用该服务。

假设你想寻找一个可以寄信且支持编程支付的服务，可以搜索支持 MPP 的服务：

stripe directory search "send mail" --mpp-supported  

这会生成结果，其中一个就是 PostalForm：

╭──────────────────────────────────────────────────────────────────────────────╮  
│ PostalForm                                                                  │  
│ PostalForm enables sending real postal mail via agentic payment rails and │  
│ refined interfaces for humans. Global first class, certified, and express │  
│ mailing supported.                                                          │  
├──────────────────────────────────────────────────────────────────────────────┤  
│ Web         https://stripe.com/@postalform                                  │  
│             https://postalform.com                                          │  
│                                                                            │  
│ Stripe Apps PostalForm                                                      │  
│             https://stri.pe/sl/UFBaAJsF                                    │  
│                                                                            │  
│ Stripe Projects Learn more using                                           │  
│             stripe projects catalog postalform                             │  
│                                                                            │  
│ Machine Payments postalform                                                 │  
│             https://mpp.dev/services#postalform                             │  
│             https://postalform.com/llms.txt                                 │  
│             https://postalform.com/agents                                   │  
│             Pay using mppx fetch                                           │  
│                                                                            │  
│ Link supported —                                                            │  
╰──────────────────────────────────────────────────────────────────────────────╯  

由于 PostalForm 支持 Machine Payments，Directory 的结果中包含下一步执行的命令，以便查看详情并向提供商付款：

mppx 会显示价格，并在转账前要求确认。

在 Stripe Directory 中列出你的业务

在搜索结果中添加你的业务

要让你的业务在 Stripe Directory 中更容易被找到，请设置一个公开的 Stripe 个人资料。

公开预览

Stripe 用户只有在选择公开时才会出现在搜索结果中。

1. 设置 Stripe 个人资料 (https://docs.stripe.com/get-started/account/profile)。如果你不想公开电话号码、地址等信息，可以留空某些字段。
2. 确保 个人资料设为私密 选项保持禁用状态。

要最大程度提高你的业务出现在用户搜索结果中的概率，请执行以下操作：

1. 让 Stripe 能够抓取你的网站：搜索会利用网站内容来匹配你的业务与相关搜索。如果你的网站屏蔽了 Stripe 的爬虫，业务就更难被发现。查看如何允许 Stripe 抓取网站 (https://docs.stripe.com/stripebot-crawler)。
2. 用清晰的语言描述你的 Stripe 个人资料——用客户实际会输入的通俗语言说明你的业务内容。不要只描述你怎么宣传，而要思考你能解决什么问题。例如，“帮助自由职业者发送发票并更快收款”比“下一代财务运营平台”能吸引更多客户。
   • 使用完整的短语（如“美发沙龙预约”），而不是零散的单词。
   • 如果你提供多种服务，请全部列出。“邮件营销、新闻稿、受众分析”比单一的“邮件”能匹配更多搜索。
3. 确保 Stripe 个人资料的显示名称和句柄准确：用户直接搜索这些名称时，你的个人资料会首先显示。确保它们与客户对你业务的认知一致。

查看你自己的 Directory 列表

1. 确保已安装 Stripe CLI，并使用设置 Stripe 个人资料时所用的同一账号登录。
2. 使用 stripe directory me 查看你自己的 Directory 列表。

从搜索结果中移除

要从搜索结果中排除，请在你的 Stripe 个人资料设置 (https://docs.stripe.com/get-started/account/profile) 中启用 个人资料设为私密。

参考资料

• Stripe CLI (https://docs.stripe.com/stripe-cli)
• Stripe Projects (https://projects.dev/)
• Machine Payments Protocol (https://mpp.dev/)
• Stripe 个人资料 (https://docs.stripe.com/get-started/account/profile)
• 为 Agent 工作流添加 Stripe (https://docs.stripe.com/agents)