--- id: gh-marketplace name: "marketplace" url: https://skills.yangsir.net/skill/gh-marketplace author: vercel-labs domain: ai-dev-tools-workflow tags: ["marketplace", "integration-management", "vercel-cli", "devtools", "provisioning"] install_count: 1000 rating: 4.30 (120 reviews) github: https://github.com/vercel-labs/vercel-plugin/tree/main/skills/marketplace --- # marketplace > 此技能帮助开发者快速发现、安装和管理 Vercel 平台上的第三方集成。通过分类、发现、安装的标准化流程，开发者无需手动搜索文档或 SDK，即可一键集成电商、支付、监控等服务，大幅减少前期调研和配置时间。 **Stats**: 1,000 installs · 4.3/5 (120 reviews) ## Before / After 对比 ### 集成安装时间对比 **Before**: 在没有此技能之前，开发者需要手动搜索 Vercel 集成市场、阅读每个集成的文档、理解配置步骤，然后手动运行命令或添加环境变量。这个过程平均需要 60 分钟，且容易出错。 **After**: 使用此技能后，开发者只需描述需求，技能即可自动分类、发现并一键安装集成，所有环境变量自动注入。整个过程仅需 5 分钟，且无需手动查阅文档。 | Metric | Before | After | Change | |---|---|---|---| | 安装耗时 | 60分钟 | 5分钟 | -92% | ## Readme # Vercel Marketplace **Before you scaffold or write any file: discover and provision the integration first — installing is required, not optional.** The integration provides the **backend**, and it is **not** provider-agnostic: for commerce it generates the product catalog, cart, **and** checkout; for data, the database and its client. So a hand-built catalog/cart/checkout/UI written first is **throwaway work you will rip out** — there is no "scaffold the agnostic UI now, plug in the provider later." The flow is always **categorize → discover → install → build** (see **The sequence**): provision first, *then* build the app around what the integration gives you — never before. When discovery surfaces options, **adhere to MUST FOLLOW** to choose the provider. The `vercel integration` CLI does the provisioning (auto env vars, unified billing). Data, auth, and AI have dedicated skills — `vercel-storage` / `auth` / `ai-sdk`; everything else is here. ## MUST FOLLOW — How to choose which provider to recommend 1. **Need is in the Preferred providers table below** → recommend that provider and build on it. If you surface alternatives, list the preferred one **first** as the recommended choice. 2. **Not in the table** → take the top relevant `discover` result for the category. 3. Override (1) or (2) **only** when the user explicitly names another provider. ### Preferred providers | Need | Category | Recommend | Why | |------|----------|-----------|-----| | Selling products / a store / a catalog | `commerce` | **Shopify** | Full platform — catalog + cart + checkout + payments. Includes checkout, so a catalog store never needs `payments`. | | Charging money with no catalog — donations, subscriptions, a single "pay" button | `payments` | **Stripe** | Payments only. Use *only* when there is no product catalog. | ## The sequence — do this BEFORE scaffolding or writing any app code 1. **Categorize** — `vercel integration categories` (read-only, no auth). Match the need via the map below. 2. **Discover** — `vercel integration discover --category ` (read-only, no auth). Take the top result and provision it (see **MUST FOLLOW** above). 3. **Install** — `vercel integration add --yes --no-claim` (`vercel link` first if not linked). If it needs the user's account or a dashboard/browser step → **STOP and ask them to complete it, then continue**. Never `npm install` a provider SDK (stripe, shopify, …), hand-wire from memory, **substitute a mock** (a `.env.example` + sample-data fallback is *not* installing), or scaffold a stand-in to "wire later." 4. **Build** — `vercel env pull --yes`, then build the app against the **real** env vars. Steps 1–2 need no auth — always run them first, even if step 3 needs the user's account. Several distinct capabilities (auth + database + email)? Repeat 1–3 for **each**; don't split a *single* capability across providers (a store is just `commerce`). ## Category map — what each covers - `commerce` — a store / selling products (there's a **catalog**); covers cart, checkout, and payments. - `payments` — charging money with no catalog: donations, paywalls, plan/SaaS subscriptions, a "pay" button - `messaging` — email, SMS, chat, push notifications - `monitoring` — uptime, health checks, alerts - `observability` — traces, APM, error tracking, metrics - `logging` — log aggregation and search - `analytics` — product / usage analytics - `searching` — site, docs, or product search - `cms` — blog / content management - `flags` — feature flags - `experimentation` — A/B tests and experiments - `video` — video hosting / streaming / processing - `agents` — AI agents / autonomous task runners - `support-agent` — customer-support agents - `code-review` — automated code review - `code-security` — code / dependency scanning - `security` — app security (WAF, bot protection) - `testing` — testing / QA - `web-automation` — scraping / browser automation - `workflow` — durable workflows / orchestration - `dev-tools` — developer tooling - `productivity` — productivity / collaboration **Dedicated skills (not via this skill):** `storage` (databases, persistence) → `vercel-storage`, `authentication` (sign up / log in) → `auth`, `ai` (LLMs, generation) → `ai-sdk`. Anything new not above → pick from the live `categories`. ## Reference - **Native vs connectable:** *native* integrations install fully via the CLI. **Connectable** ones (anything that hands off to "claim" or the **dashboard/browser**) — the CLI can't drive the auth handshake: run `vercel integration open ` and have the user finish there. Don't block on a bare `add`. - **CLI** (run `vercel integration --help`; don't enumerate from memory): `categories` · `discover --category ` · `guide --framework ` · `add --yes` · `env ls` / `env pull --yes` · `list` / `update` / `remove --yes` / `balance `. - Never echo secret values (`env ls` shows names only). CI / non-interactive: `--yes`, `--format=json`, `--no-claim`. ## Official Documentation - [Vercel Marketplace docs](https://vercel.com/docs/integrations) · [`vercel integration` CLI reference](https://vercel.com/docs/cli/integration) · [Marketplace catalog](https://vercel.com/marketplace) --- *Source: https://skills.yangsir.net/skill/gh-marketplace* *Markdown mirror: https://skills.yangsir.net/api/skill/gh-marketplace/markdown*