stripe-directory

Stripe Directory — официальный навык для поиска компаний, программных продуктов, сервисных провайдеров и партнёров под конкретную отрасль, workflow, боль или job-to-be-done. Его центральная задача — получить короткий релевантный shortlist, даже если пользователь не упомянул Stripe Directory. Отдельный режим нужен, когда пользователь действительно хочет купить или программно использовать найденный сервис: тогда результаты с поддержкой MPP можно рассматривать для HTTP 402-оплаты, но сам навык не инициирует покупку без явного запроса. Перед поиском уточняются только недостающие параметры: кто покупатель, какая вертикаль, какой результат нужно получить, обязательная возможность и нужна ли география. Если география не влияет на выбор, её не следует превращать в лишний вопрос. Поиск выполняется итеративно командой stripe directory search с форматом json. Источник рекомендует одну-единственную ось на запрос и обычно 1–3 запроса: сначала можно проверить вертикаль, затем workflow, pain point и соседнее применение. Для B2B SaaS примерами служат billing, subscription management, usage-based metering и recovery failed payments; для сервисных компаний — scheduling, dispatch, invoicing и quote automation. Это примеры направлений поиска, а не заранее подтверждённые поставщики. Жёсткие требования передаются фильтрами: страны через --countries-supported, наличие Stripe App через --has-stripe-app=true, поддержку Stripe Projects через --stripe-projects-supported=true, а для сценария покупки — --mpp-supported. Если ниша выдаёт мало результатов, сначала повышают --limit и пробуют следующую --page, а не объявляют рынок пустым. После получения JSON результаты дедуплицируются по display_name, description, url и username. Сопоставление должно опираться на текст описания и домен: сильный бренд без подтверждённого совпадения задачи не должен автоматически попасть в прямые рекомендации. Ранжирование учитывает соответствие workflow и trust signals. В качестве дополнительных признаков источник называет Projects provider, Link enabled, Marketplace app и Stripe Verified; для сценария использования или покупки добавляется MPP-supported. Тонкое описание при хорошем совпадении бренда и домена можно оставить в слабой группе, но не выдавать за сильный match. Финальный ответ должен быть shortlist из 5–10 вариантов, сгруппированных как direct, adjacent и needs manual review. Для каждого указываются имя, причина совпадения, URL и при необходимости запрос, который его обнаружил. Нужно также перечислить точные запросы и фильтры, чтобы результат можно было воспроизвести и уточнить. Для провайдера Stripe Projects следует предложить follow-up и использовать именно команды из результата JSON: projects.catalog_command или projects.install_command. Для MPP-результата указываются mpp.slug и mpp.url. Нельзя подменять отсутствующие сведения общим описанием рынка: если выдача разреженная или результаты слишком общие, нужно прямо сообщить об этом и изменить запросы. Список не должен превращаться в dump, а нерелевантные совпадения — в заполнители ради количества. Покупка или потребление сервиса имеет отдельный safety gate. Сначала пользователь выбирает способ оплаты из полного меню: Link CLI, Tempo, Privy Agent Wallet CLI или debug-only mppx. До движения денег обязательно показываются цена и сумма, запрашивается явное одобрение, а при возможности предпочитается бесплатный тестовый путь. Перед оплатой нужно разрешить реальный endpoint из mpp.slug или mpp.url, прочитать HTTP 402 challenge и проверить WWW-Authenticate. Для Link CLI источник отдельно описывает проверку установки, login, расшифровку challenge, создание spend request с ограничением суммы и последующий pay только после approval. Нельзя выдумывать endpoint, пропускать цену или покупать по собственной инициативе. Ограничение навыка следует из его роли: Directory помогает найти и сопоставить поставщиков, но не доказывает качество услуги одним присутствием в каталоге, не заменяет ручную проверку слабых результатов и не выполняет финансовое действие без пользовательского намерения и подтверждения. Практический результат — проверяемый список с происхождением каждого совпадения, а не обещание, что любой найденный сервис подходит проекту.