# Stripe Directory

Stripe ネットワーク上の事業者を検索、評価し、連携するための統合された場所。

Stripe Directory は、Stripe ネットワーク上のビジネスを見つけるための統合された場所です。キーワードで検索し、ユーザーやエージェントがアクション可能な構造化された結果を取得します。

> このプレビューのテストを行う際は、[directory@stripe.com](mailto:directory@stripe.com) にフィードバックをお寄せください。

## 事業者を検索

Run `stripe directory search` with one or more keywords:

```
> 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     ✓           ✓            –            ✓
```

Results include structured data—provider slugs, MPP endpoints, and app listings—that you or your agent can use to continue the integration.

## What Stripe Directory indexes 

- **Stripe Apps**: Published apps on the [Stripe App Marketplace](https://marketplace.stripe.com) that extend your Stripe Dashboard, including billing tools, analytics, and support integrations.
- **Stripe Projects providers**: Services available through [Stripe Projects](https://projects.dev) that you can provision with a CLI command.
- **Machine payments endpoints**: Pay-per-call APIs on [mpp.dev](https://mpp.dev) you can pay programmatically with `mppx fetch`.
- **Stripe business network**: Businesses and services across the Stripe network.

## Set up Stripe Directory in your terminal 

Stripe CLI Directory プラグインを使用して、端末からビジネスを検索します。

1. [Stripe CLI](https://docs.stripe.com/stripe-cli/install.md) をインストールまたはアップグレードし、`stripe login` でログインします。
2. ディレクトリプラグインをインストールします:

```bash
stripe plugin install directory
```

プラグインをアップグレードするには、`stripe plugin upgrade directory` を実行します。

## Configure agents to use Stripe Directory 

Stripe Directory を使用すると、AI エージェントはサービスの検出、評価、連携を自律的に行うことができます。

### エージェント向けの構造化された出力

構造化された出力を取得するには、`--format json` を使用します。

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

エージェントは結果を解析し、要件に対してオプションを比較し、返された `mpp.dev` エンドポイントまたは `projects.dev` のリスティングを使用して連携を自動的に設定できます。

### エージェント用のスキルをインストールする

エージェントを Stripe Directory に接続するには、これらのオプションのいずれかを使用します。

#### スキルをインストール

エージェントに Stripe Directory の使用方法を示すグローバルエージェントスキルをインストールします。

```bash
npx skills add https://docs.stripe.com --skill stripe-directory -g -y
```

あるいは、すべての [Stripe スキル](https://docs.stripe.com/skills.md)を同時にインストールします。

```bash
npx skills add https://docs.stripe.com -g -y
```

インストール後、エージェントはディレクトリを検索し、結果を解釈し、追加の指示なしで返されたエンドポイントを使用できます。

#### スタータープロンプトをコピーする

以下のプロンプトをエージェントに貼り付けて、Stripe Directory へのアクセスを許可します。このオプションは、シェルコマンドを実行できる任意のエージェントで機能します。

```text
You have access to the Stripe Directory, which lets you search for businesses on the Stripe network.

Use this tool when you need to find a service, API, database, or tool to
accomplish a task. Evaluate the results by comparing features, pricing, and
integration methods, then proceed with the best option.

To find services, run:

  stripe directory search "<keywords>" --format json

This returns structured results including:
- Stripe Apps (installable from marketplace.stripe.com)
- projects.dev listings (infrastructure you can provision with `stripe projects`)
- mpp.dev endpoints (APIs you can call and pay per-request with `mppx fetch`)

Use these help commands to check the available options and arguments:

  stripe directory search --help
  stripe directory --help

Documentation: https://docs.stripe.com/directory.md
Full skills file: https://docs.stripe.com/.well-known/skills/stripe-directory/SKILL.md
```

## Example uses 

### Integrate with Stripe Projects 

If a developer building an application needs a database provider, they can leverage Stripe Directory to not only find one but integrate with it as well.

First, the developer searches for the service:

```bash
stripe directory search "serverless postgres database"
```

This produces several results, one of which is 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    ✅                                                         │
╰──────────────────────────────────────────────────────────────────────────────╯
```

Since Neon is also a Stripe Projects provider, Directory returns the command to inspect the provider’s catalog listing.

```bash
stripe projects catalog neon
```

The result of that command not only provides information about the offering, but also recommends the command to integrate:

```bash
stripe projects add neon
```

### Make machine payments 

When a search result shows a `machine payments` endpoint, you or your agent can pay and consume the service immediately using `mppx`.

If you (or your agent) were looking for a service to send a letter and wanted to pay programmatically, you could search for MPP-supported services:

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

This produces results, one of which is 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 <endpoint>                            │
│                                                                              │
│ Link supported    —                                                          │
╰──────────────────────────────────────────────────────────────────────────────╯
```

Since PostalForm supports machine payments, Directory results include the next command to run to learn more and pay the service provider:

```bash
mppx fetch https://postalform.com
```

`mppx` shows the price and gets your confirmation before any money moves.

## List your company in Stripe Directory

### Add yourself to search results

Stripe Directory でビジネスを見つけやすくするには、公開の Stripe プロフィールを設定します。

> Stripe ユーザーは、オプトインした場合にのみ検索結果に表示されます。

1. [Stripe プロフィール](https://docs.stripe.com/get-started/account/profile.md)を設定します。電話番号や住所などを公開したくない場合は、一部のフィールドを空白のままにすることができます。
2. **プロフィールを非公開にする**オプションは無効のままにしてください。

ユーザーの検索結果にビジネスが表示される可能性を最大限に高めるには、以下の手順を実行します。

1. **Stripe がサイトをクロールできるようにする**: 検索では、ウェブサイトのコンテンツを使用して、ビジネスと関連する検索を照合します。サイトで Stripe のクローラーをブロックしている場合、ビジネスが見つかりにくくなります。[Stripe によるサイトのクロールを許可する方法の詳細を表示](https://docs.stripe.com/stripebot-crawler.md)。
2. **Stripe プロフィールの説明を明確に記述する**

- 顧客が実際に入力するようなわかりやすい言葉で事業内容を説明します。どのように宣伝するかではなく、どのような問題を解決できるかを考慮してください。たとえば、「次世代の財務オペレーションプラットフォーム」よりも、「フリーランサーが請求書を送付し、より早く支払いを受けるのに役立つ」のほうが、より多くの顧客を見つけることができます。
- 単語を個別に散りばめるのではなく、「サロンの予約」などの語句全体を使用します。
- 複数のサービスを提供している場合は、そのすべてを記載します。「メール」単独よりも、「メールマーケティング、ニュースレター、オーディエンス分析」のほうが幅広い検索に一致します。

1. **Stripe プロフィールの表示名とハンドル名を正確なものにする**: ユーザーがこれらを直接検索した場合、プロフィールが最初に表示されます。これらがすべて、顧客に認知されている名称と一致していることを確認してください。

### View your Directory listing

1. Ensure you’ve installed the Stripe CLI and logged in with the same account that set up your Stripe Profile.
2. Use `stripe directory me` to view your own Directory listing.

### 検索結果から削除

検索結果から除外するには、[Stripe プロフィール設定](https://docs.stripe.com/get-started/account/profile.md)で**プロフィールを非公開にする**を有効にしてください。

## See also

- [Stripe CLI](https://docs.stripe.com/stripe-cli.md)
- [Stripe Projects](https://projects.dev)
- [Machine Payments Protocol](https://mpp.dev)
- [Stripe プロフィール](https://docs.stripe.com/get-started/account/profile.md)
- [エージェントワークフローに Stripe を追加](https://docs.stripe.com/agents.md)