Communitygithub.com

YepAPI/スキル

マルチベンダーアーキテクチャ、Stripe Connectオンボーディング、手数料、エスクロー決済、セラーダッシュボード、レビュー機能。

スキル とは?

このスキルは、マーケットプレイスプラットフォームを構築するための包括的なガイドを提供します。主な機能として、マルチベンダーのデータモデル設計、Stripe Connect Expressを使ったセラーのオンボーディング(KYCや税務フォームの処理を含む)、プラットフォーム手数料の計算と適用、エスクローによる安全な資金管理、セラー向けのダッシュボード(売上分析、注文管理、商品管理、支払履歴)、そして双方向のレビューシステムが含まれます。Stripe Connectを使用することで、各セラーは個別のアカウントを持ち、プラットフォームが資金を管理するため、コンプライアンスと不正防止が強化されます。このスキルはClaude CodeなどのAIエージェントで利用でき、マーケットプレイス開発において、Stripe APIを使用した実際のコードパターンや、データモデルのスケッチ、そして避けるべき実装パターン(例:エスクローなしの直接送金、全セラーでの単一Stripeアカウント共有)を提供します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/YepAPI/skills/tree/HEAD/skills/marketplace

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

マーケットプレイス

ルール

  • マルチベンダーデータモデル:Userは1つのSellerプロファイルを持つ — 商品はセラーに属し、注文は購入者とセラーを結びつける
  • Stripe Connectによる支払い:Connect Expressでセラーをオンボーディング — KYC、税務フォーム、銀行口座を処理
  • 手数料:プラットフォーム手数料をパーセンテージで計算 — PaymentIntentsまたはCheckoutセッションでapplication_fee_amountを使用
  • エスクローフロー:購入時に支払いをキャプチャし、資金を保留、配送確認後または異議申立期間経過後にセラーに送金
  • セラーダッシュボード:売上分析、注文管理、商品CRUD、支払履歴を含む独立したレイアウト
  • 購入者/セラーレビュー:注文ごとに1件のレビュー、双方向 — 加重平均で評価を集計
  • セラーフィルタリング付き検索:検索ファセットにセラー名、評価、所在地を含める
  • セラーオンボーディング:マルチステップフロー — ビジネス情報 → Stripe Connect → 商品リスト → 公開開始

パターン

// Stripe Connect:セラーの接続アカウントを作成
const account = await stripe.accounts.create({
  type: "express",
  email: seller.email,
  metadata: { sellerId: seller.id },
});

// オンボーディングリンクを作成
const accountLink = await stripe.accountLinks.create({
  account: account.id,
  refresh_url: `${baseUrl}/seller/onboarding?refresh=true`,
  return_url: `${baseUrl}/seller/onboarding/complete`,
  type: "account_onboarding",
});

// プラットフォーム手数料付きチェックアウト
const session = await stripe.checkout.sessions.create({
  line_items: [{ price: priceId, quantity: 1 }],
  payment_intent_data: {
    application_fee_amount: Math.round(price * 0.10), // 10% プラットフォーム手数料
    transfer_data: { destination: seller.stripeAccountId },
  },
  mode: "payment",
  success_url: `${baseUrl}/orders/{CHECKOUT_SESSION_ID}`,
  cancel_url: `${baseUrl}/cart`,
});

// データモデルスケッチ
// sellers: id, userId, stripeAccountId, businessName, rating, status (pending|active|suspended)
// products: id, sellerId, title, price, inventory, status
// orders: id, buyerId, sellerId, status (pending|paid|shipped|delivered|disputed)
// reviews: id, orderId, reviewerId, rating, comment, type (buyer_to_seller|seller_to_buyer)

避けるべきこと

  • エスクローなしの直接送金 — 配送確認または異議申立期間が経過するまで資金を保留する
  • 全セラーで単一のStripeアカウントを使用 — コンプライアンスのために各セラーに独自のConnectアカウントが必要
  • セラーに支払いスケジュールを設定させる — 不正防止のためにプラットフォーム管理の支払いを使用する
  • セラーの確認を怠る — 公開開始前にStripe Connectオンボーディングの完了を必須にする
  • プラットフォームがセラーの税務を処理する — Stripe Connect Expressがセラーの税務報告を処理する

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

YepAPI/skills

WCAG 2.1 AA — semantic HTML, keyboard navigation, screen readers.

YepAPI/skills

Experiment setup, variant splitting, statistical significance, and feature flag integration.

YepAPI/skills

CRUD generators, data tables, user management, role-based access, and bulk operations.

YepAPI/skills

Monitor what ChatGPT and Gemini say about your brand using YepAPI.

YepAPI/skills

Queue workers with BullMQ/Inngest/Trigger.dev, job retries, dead letter queues, concurrency.

YepAPI/skills

Commander.js, interactive prompts with Clack, spinners, colors, config files, exit codes, and npm publishing.

YepAPI/skills

cmdk integration, Cmd+K trigger, fuzzy search, grouped actions, keyboard navigation, and dynamic action registration.

YepAPI/skills

Content planning with trend and sentiment data from YepAPI.

YepAPI/skills

Content calendar, keyword-driven planning, and content briefs.

YepAPI/skills

Theme switching with CSS variables, system preference detection, next-themes, and persistence.

YepAPI/skills

Threaded comments, @mentions, reactions, moderation queue, optimistic UI, and cursor pagination.

YepAPI/skills

Competitive analysis between domains using YepAPI.

YepAPI/skills

Layout grids, KPI cards, data tables with sorting/filtering, sidebar navigation, and responsive breakpoints.

YepAPI/skills

Data encryption — TLS everywhere, AES-256-GCM for PII, bcrypt passwords, encrypted backups.

YepAPI/skills

Chart patterns with Recharts/Nivo/D3, responsive containers, color scales, and accessibility.

YepAPI/skills

Drizzle schema definition, push vs migrate, type-safe queries, relations, transactions, and prepared statements.

YepAPI/skills

Upload handling, resize/compress, CDN delivery, blur placeholders, and next/image patterns.

YepAPI/skills

Local business and Google Maps research using YepAPI.

YepAPI/skills

Cursor-based pagination, IntersectionObserver, virtualized lists with @tanstack/react-virtual, and scroll position restoration.

YepAPI/skills

Chat UI components, streaming responses with AI SDK, context window management, and RAG patterns.

関連スキル