outrank-cli 0.4.0 → 0.5.0

package/README.md

@@ -55,6 +55,9 @@ This repo currently targets the agent endpoints that already exist in `outrank`:
 - `improvements candidates list|brief|edit-brief|schedule`
 - `improvements tasks list|reschedule|cancel|edit-brief|execute`
 - `improvements executions list|get|decisions|push`
+- `marketplace seller status|onboard|eligibility|settings|integrations|stripe|complete-onboarding|placements|earnings|content-history`
+- `marketplace notifications list|mark-read`
+- `marketplace buyer status|billing-status|subscription|subscribe-quote|checkout|change-plan|target-pages|participation|placements|article|credits`
 - `subscription status`
 - `usage stats`
 - `billing portal-url`
@@ -202,6 +205,11 @@ outrank-cli products backlinks subscription 00000000-0000-0000-0000-000000000000
 outrank-cli products backlinks subscribe-quote 00000000-0000-0000-0000-000000000000 --plan premium
 outrank-cli keywords update 00000000-0000-0000-0000-000000000000 --json '{"scheduled_for":"2026-05-20"}'
 outrank-cli billing purchase-products quote --additional-products 2
+outrank-cli marketplace seller status 00000000-0000-0000-0000-000000000000
+outrank-cli marketplace seller onboard 00000000-0000-0000-0000-000000000000 --country US
+outrank-cli marketplace seller placements list 00000000-0000-0000-0000-000000000000 --status needs_approval
+outrank-cli marketplace seller earnings 00000000-0000-0000-0000-000000000000
+outrank-cli marketplace buyer status 00000000-0000-0000-0000-000000000000
 ```
 
 ## Google Search Console workflow
@@ -281,6 +289,23 @@ Example payload:
 }
 ```
 
+## Marketplace workflow
+
+Seller side (live):
+
+- Start with `outrank-cli marketplace seller status <product-id>` — its guidance walks the onboarding wizard (Blog -> Articles -> Integration -> Payouts).
+- `outrank-cli marketplace seller onboard <product-id> [--country <ISO2>]` orchestrates onboarding: it reports remaining steps, adopts an existing reusable CMS automatically (never ask the user to pick a platform when one is reusable), and creates the Stripe Express account once the earlier steps are done and a country is provided.
+- Stripe identity/bank onboarding happens in a browser — surface the returned `onboardingUrl` to the human.
+- Finish with `outrank-cli marketplace seller complete-onboarding <product-id>` and always report the eligibility check results (`marketplace seller eligibility`) to the human.
+- Day-to-day: `placements list|approve|decline|publish|regenerate`, `earnings`, `settings get|update`, `stripe manage`, `content-history`, and `marketplace notifications list --role seller`.
+- Admin-only (server-enforced against the key creator's current role): settings update, integrations writes, stripe commands, complete-onboarding, placements decline.
+
+Buyer side:
+
+- Start with `outrank-cli marketplace buyer status <product-id>` — its guidance drives the setup sequence.
+- The mandatory sequence: Enterprise backlink plan (`buyer subscribe-quote`, a human org admin completes checkout — purchasing is admin-only) -> add target pages (`buyer target-pages discover|add`) -> `buyer participation on`.
+- Then `buyer placements list|regenerate|revalidate`, `buyer article get|edit`, `buyer credits history`, and `marketplace notifications list --role buyer`.
+
 ## Keyword mutation rules
 
 - Run `outrank-cli keywords generation-status --product <product-id>` before keyword writes when you are not sure the product is writable.

package/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: outrank
-description: Drive the Outrank agent API from the terminal via outrank-cli. Use when the user asks to list/create/update Outrank products, inspect or manage publishing integrations, inspect or manage keyword plans, inspect or edit articles, discover/schedule/run/review/publish article improvements for existing posts, manage article settings, target audiences, competitors, Google Search Console connections, internal linking configuration, or quote/buy product slots. Requires outrank-cli on PATH and an Outrank API key (env OUTRANK_API_KEY or stored via auth login).
+description: Drive the Outrank agent API from the terminal via outrank-cli. Use when the user asks to list/create/update Outrank products, inspect or manage publishing integrations, inspect or manage keyword plans, inspect or edit articles, discover/schedule/run/review/publish article improvements for existing posts, manage article settings, target audiences, competitors, Google Search Console connections, internal linking configuration, quote/buy product slots, or work with the Outrank Marketplace (seller onboarding, eligibility, placements, earnings, Stripe payouts, buyer target pages and placements). Requires outrank-cli on PATH and an Outrank API key (env OUTRANK_API_KEY or stored via auth login).
 ---
 
 # Outrank Skill
@@ -14,6 +14,8 @@ Use `products backlinks ...` for backlink exchange settings, credits, review que
 
 Use `improvements ...` for article improvements: discovering, briefing, scheduling, running, reviewing, and publishing AI rewrites of **existing published articles** based on Search Console performance. This is a distinct area from article generation (`articles generate`/`precreate`) — offer it whenever the human wants to refresh, update, optimize, or improve existing/older posts, or act on GSC opportunities. It needs the All-in-One plan.
 
+Use `marketplace ...` for the Outrank Marketplace: seller onboarding and eligibility, placement approval/decline/publishing, earnings and Stripe Express payouts, marketplace notifications, and buyer target pages, placements, and credits. This is distinct from `products backlinks ...`, which is the classic backlink exchange.
+
 ## Setup
 
 1. If `OUTRANK_API_KEY` is not set, ask the human for an Outrank API key from `https://outrank.so/dashboard/settings/api-keys`.
@@ -34,6 +36,7 @@ Run group help when needed:
 - `outrank-cli keywords --help`
 - `outrank-cli articles --help`
 - `outrank-cli improvements --help`
+- `outrank-cli marketplace --help`
 - `outrank-cli subscription --help`
 - `outrank-cli usage --help`
 - `outrank-cli billing --help`
@@ -84,6 +87,13 @@ Prefer inspecting before mutating:
 - `outrank-cli products backlinks earned <productId>`
 - `outrank-cli products backlinks unverified <productId>`
 - `outrank-cli products backlinks subscription <productId>`
+- `outrank-cli marketplace seller status <productId>`
+- `outrank-cli marketplace seller eligibility <productId>`
+- `outrank-cli marketplace seller placements list <productId>`
+- `outrank-cli marketplace seller earnings <productId>`
+- `outrank-cli marketplace buyer status <productId>`
+- `outrank-cli marketplace buyer target-pages list <productId>`
+- `outrank-cli marketplace notifications list <productId> --role seller`
 - `outrank-cli subscription status`
 - `outrank-cli usage stats`
 
@@ -402,6 +412,7 @@ When the user asks for keyword ideas:
 
 Treat `keywords suggest` as candidate-generation only. It does not change the content plan until you add keywords.
 Treat `keywords generate` as the dashboard Generate Keywords action. It creates scheduled keywords through the same backend pipeline.
+Product-wide keyword research instructions live in product article settings as `global_keyword_prompt` (`products output-settings get|update`). They steer every keyword research run for the product and are separate from per-keyword `instructions`. When the human wants a standing rule for all future keyword research (topics, angles, audiences to focus on), update `global_keyword_prompt` instead of repeating it per keyword.
 
 Before `keywords generate`:
 
@@ -530,6 +541,52 @@ Always do this in two steps:
 Never guess `confirm-charge-cents`. Use the server-quoted number.
 Do not ask for billing approval until you have already clarified the intended product configuration and any defaulted article/publishing settings.
 
+## Marketplace workflow
+
+The Outrank Marketplace connects sellers (sites that host backlink placements inside their upcoming Outrank articles and get paid per placement) with buyers (sites that spend backlink credits to place links on high-authority articles). Use `outrank-cli marketplace ...` for everything.
+
+Role note: several marketplace commands are admin-only server-side — they succeed only when the user who created the API key currently holds an org admin role. Admin-only: `seller settings update`, all `seller integrations` writes, all `seller stripe` commands, `seller complete-onboarding`, `seller placements decline`, and the buyer billing/participation writes (checkout, change-plan, participation on/off). Buyer target-page writes (add, pause/activate, delete) are open to every org member. If a command returns `ADMIN_ROLE_REQUIRED`, tell the human an organization admin must do it (dashboard or an admin-created key).
+
+### Seller onboarding
+
+The wizard order matches the dashboard: Blog -> Articles -> Integration -> Payouts, then complete. Start every session with:
+
+- `outrank-cli marketplace seller status <productId>` — composite report (enrollment, per-step onboarding state, settings, gate state) whose guidance tells you the next step
+- `outrank-cli marketplace seller onboard <productId> [--country <ISO2>]` — the orchestrator: reports remaining steps, and performs the safe automatic actions for you
+
+Step-by-step, prompting the human for the same data the dashboard collects:
+
+1. **Blog** — collect/confirm the product's content details (`products get` / `products update`) and connect Google Search Console (`products gsc connect`, human opens the URL, then `gsc poll` and `gsc set-property`). GSC is mandatory before continuing.
+2. **Articles** — review article settings (`products output-settings get/update`) and set the marketplace publishing schedule: `marketplace seller settings update <productId> --json '{"dailyArticleLimit":<1-3>,"publishingDays":[<weekday numbers, at least 3>]}'` (defaults: 2/day on Mon/Wed/Fri).
+3. **Integration** — if the product already has a reusable CMS integration, **adopt it automatically and just inform the human — never ask them to pick a platform** (`marketplace seller integrations adopt`; `seller onboard` does this for you). Only when there is no reusable integration: run `marketplace seller integrations status` for the supported platforms, connect one with the `products integrations` commands, then `marketplace seller integrations claim <productId> --integration <id> --type <platform>`. Next.js Blog cannot be reused, and plugin-managed Framer setups need a new Framer connection — the error messages say so.
+4. **Payouts** — when the earlier steps are done it is safe to create the Stripe Express account: `marketplace seller stripe onboard <productId> --country <ISO2>` (ask the human for the two-letter country of their payout bank account). Surface the returned `onboardingUrl` — the human completes identity and bank details in a browser; the agent cannot.
+5. **Finish** — `marketplace seller complete-onboarding <productId>`, then check `marketplace seller eligibility <productId>`.
+
+Always report the eligibility check results to the human — all five checks with actual vs required: GSC connected, Domain Rating >= 40, >= 100 avg monthly organic clicks (90-day window), >= 3 months of Search Console history, marketplace CMS connected. GSC and the CMS are fixable now; DR/clicks/history only grow over time — enrollment still completes, and the seller dashboard opens automatically once the site qualifies (re-checked automatically; force with `marketplace seller eligibility recheck`).
+
+### Seller operations (after onboarding)
+
+- `marketplace seller placements list <productId> [--status needs_approval|planned|live|link_not_found|lost]` — the placement pipeline with counts
+- `marketplace seller placements approve <placementId>` — only `pending_approval`; publishes immediately when the scheduled date is due
+- `marketplace seller placements decline <placementId>` — admin-only; only `matched`/`pending_approval`; refunds the buyer and cleans up the pre-generated article
+- `marketplace seller placements publish <placementId>` — publish early once the article is pregenerated and due
+- `marketplace seller placements regenerate <placementId>` — retry a failed generation
+- `marketplace seller earnings <productId>` — cents; payout states are available (cleared the 14-day hold), pending, paid
+- `marketplace seller stripe manage <productId>` — Stripe Express dashboard login link for the human
+- `marketplace seller settings get/update <productId>` — isActive (cannot enable while ineligible), approvalMode, dailyArticleLimit, publishingDays
+- `marketplace seller content-history <productId>` — marketplace-only articles (articles list with track_scope=marketplace)
+- `marketplace notifications list <productId> --role seller` and `mark-read`
+
+### Buyer
+
+Start with `marketplace buyer status <productId>` — its guidance drives the whole setup sequence. The mandatory order:
+
+1. **Enterprise backlink plan** — `marketplace buyer billing-status <productId>`; if none, `marketplace buyer subscribe-quote <productId>` and surface `subscription_management_url` to the human (checkout is an interactive Stripe flow the agent cannot complete, and purchasing is restricted to org admins)
+2. **Target pages (mandatory before the dashboard opens)** — discover with `marketplace buyer target-pages discover <productId> [--source sitemap|root_url|integration]`, present candidates to the human, add with `marketplace buyer target-pages add <productId> --urls <u1,u2,...>` (own-domain only, max 10 pages, batches of up to 50), manage with `pause`/`activate`/`delete`
+3. **Participation** — `marketplace buyer participation on <productId>` (requires the plan plus >= 1 active target page)
+
+Then: `placements list`, `placements regenerate|revalidate`, `article get/edit <placementId>` (editable only while the placement is matched or publishing and unpublished; keep the placement backlink intact), `credits history`, and `notifications --role buyer`. Each placement costs the host site's Domain Rating x 3 in backlink credits. Plan upgrades via `change-plan` are dashboard-only (interactive payment confirmation); downgrades, cancellations, and restores work from the CLI.
+
 ## Error handling
 
 - If `ok` is `false`, read both `error.message` and `agent_guidance`.
@@ -539,4 +596,4 @@ Do not ask for billing approval until you have already clarified the intended pr
 
 ## Current limitation
 
-The implementation plan is broader than the current live API. Keywords, core article flows, article improvements, linking, backlink exchange management, and the current integration-management flows are exposed in `outrank-cli`, including direct setup for webhook, Ghost, Shopify, Webflow, Wix, Framer, WordPress Plugin, and Next.js Blog, plus OAuth flows for WordPress.com and Notion. Purchasing or changing backlink add-ons and some onboarding flows still require the dashboard. If the user asks for something not present in `outrank-cli --help`, say that exact command surface is not shipped yet and do not invent unsupported commands.
+The implementation plan is broader than the current live API. Keywords, core article flows, article improvements, linking, backlink exchange management, marketplace seller and buyer flows, and the current integration-management flows are exposed in `outrank-cli`, including direct setup for webhook, Ghost, Shopify, Webflow, Wix, Framer, WordPress Plugin, and Next.js Blog, plus OAuth flows for WordPress.com and Notion. Purchasing or changing backlink add-ons, marketplace Enterprise checkout, Stripe Express identity/bank onboarding, and marketplace plan upgrades still require the dashboard or a browser. If the user asks for something not present in `outrank-cli --help`, say that exact command surface is not shipped yet and do not invent unsupported commands.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "outrank-cli",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Agent-first CLI for the Outrank agent API",
   "type": "module",
   "files": [

package/src/commands/marketplace.js

@@ -0,0 +1,740 @@
+import { parseArgs, getRequiredPositional, readJsonInput, hasFlag, parseIntegerOption, getOption, getOptions } from '../core/args.js';
+import { requestAgentApi } from '../core/api.js';
+import { cliSuccess } from '../core/errors.js';
+
+export const MARKETPLACE_HELP = `Usage:
+  outrank-cli marketplace seller status <product-id> [--refresh-stripe]
+  outrank-cli marketplace seller onboard <product-id> [--country <ISO2>]
+  outrank-cli marketplace seller eligibility <product-id> [--refresh]
+  outrank-cli marketplace seller eligibility recheck <product-id>
+  outrank-cli marketplace seller settings get <product-id>
+  outrank-cli marketplace seller settings update <product-id> --json '<object>'
+  outrank-cli marketplace seller integrations status <product-id>
+  outrank-cli marketplace seller integrations adopt <product-id>
+  outrank-cli marketplace seller integrations claim <product-id> --integration <integration-id> --type <platform>
+  outrank-cli marketplace seller integrations set-activation <product-id> --integration <integration-id> --type <platform> --status active|disabled
+  outrank-cli marketplace seller integrations delete <product-id> --integration <integration-id> --type <platform>
+  outrank-cli marketplace seller stripe onboard <product-id> --country <ISO2>
+  outrank-cli marketplace seller stripe manage <product-id>
+  outrank-cli marketplace seller stripe reset <product-id>
+  outrank-cli marketplace seller complete-onboarding <product-id>
+  outrank-cli marketplace seller placements list <product-id> [--status all|needs_approval|planned|live|link_not_found|lost] [--search <text>] [--page <n>] [--page-size <n>]
+  outrank-cli marketplace seller placements approve <placement-id>
+  outrank-cli marketplace seller placements decline <placement-id>
+  outrank-cli marketplace seller placements publish <placement-id>
+  outrank-cli marketplace seller placements regenerate <placement-id>
+  outrank-cli marketplace seller earnings <product-id>
+  outrank-cli marketplace seller content-history <product-id> [--status <status>] [--limit <n>] [--offset <n>]
+  outrank-cli marketplace notifications list <product-id> --role seller|buyer [--type <type>] [--sort oldest] [--page <n>] [--page-size <n>]
+  outrank-cli marketplace notifications mark-read <product-id> --role seller|buyer [--ids <id1,id2,...>]
+
+  outrank-cli marketplace buyer status <product-id>
+  outrank-cli marketplace buyer billing-status <product-id>
+  outrank-cli marketplace buyer subscription <product-id>
+  outrank-cli marketplace buyer subscribe-quote <product-id>
+  outrank-cli marketplace buyer checkout <product-id> --tier <tier>
+  outrank-cli marketplace buyer change-plan <product-id> --action change_tier|cancel_scheduled|cancel_subscription|restore_subscription [--tier <tier>]
+  outrank-cli marketplace buyer target-pages list <product-id>
+  outrank-cli marketplace buyer target-pages add <product-id> --urls <url1,url2,...> [--source manual|discovered]
+  outrank-cli marketplace buyer target-pages discover <product-id> [--source sitemap|root_url|integration] [--source-url <url>]
+  outrank-cli marketplace buyer target-pages pause <target-page-id>
+  outrank-cli marketplace buyer target-pages activate <target-page-id>
+  outrank-cli marketplace buyer target-pages delete <target-page-id>
+  outrank-cli marketplace buyer participation on <product-id>
+  outrank-cli marketplace buyer participation off <product-id>
+  outrank-cli marketplace buyer placements list <product-id> [--status all|live|in_progress|lost|rejected] [--search <text>] [--page <n>] [--page-size <n>]
+  outrank-cli marketplace buyer placements regenerate <placement-id>
+  outrank-cli marketplace buyer placements revalidate <placement-id>
+  outrank-cli marketplace buyer article get <placement-id>
+  outrank-cli marketplace buyer article edit <placement-id> --json '<object>'
+  outrank-cli marketplace buyer credits history <product-id> [--kind all|charge|refund] [--page <n>] [--page-size <n>]
+
+Notes:
+  Seller onboarding wizard order: Blog (content details + Google Search Console) -> Articles (article settings + publishing schedule) -> Integration (marketplace CMS) -> Payouts (Stripe Express).
+  \`seller onboard\` reports every remaining step, auto-adopts an existing reusable CMS without asking, and creates the Stripe Express account when the earlier steps are done and --country is provided.
+  Admin-only commands (need an API key created by an org admin who still holds that role): settings update, all integrations writes, all stripe commands, complete-onboarding, placements decline, and buyer checkout/change-plan/participation. Buyer target-page writes are open to every org member.
+  The mandatory buyer sequence: Enterprise backlink plan (subscribe-quote -> a human org admin completes checkout) -> add target pages -> participation on.
+  Purchasing the Enterprise backlink plan is admin-only and happens through interactive Stripe checkout — surface subscription_management_url to the human.
+
+Examples:
+  outrank-cli marketplace seller status 00000000-0000-0000-0000-000000000000
+  outrank-cli marketplace seller onboard 00000000-0000-0000-0000-000000000000 --country US
+  outrank-cli marketplace seller settings update 00000000-0000-0000-0000-000000000000 --json '{"dailyArticleLimit":2,"publishingDays":[1,3,5]}'
+  outrank-cli marketplace seller placements list 00000000-0000-0000-0000-000000000000 --status needs_approval
+  outrank-cli marketplace seller placements approve 00000000-0000-0000-0000-000000000000
+  outrank-cli marketplace notifications list 00000000-0000-0000-0000-000000000000 --role seller
+  outrank-cli marketplace buyer status 00000000-0000-0000-0000-000000000000
+  outrank-cli marketplace buyer target-pages add 00000000-0000-0000-0000-000000000000 --urls https://example.com/pricing,https://example.com/features
+`;
+
+const buildQueryPath = (basePath, searchParams) => {
+  const url = new URL(`https://local${basePath}`);
+  for (const [key, value] of Object.entries(searchParams)) {
+    if (value !== undefined && value !== null && value !== '') {
+      url.searchParams.set(key, String(value));
+    }
+  }
+  return `${url.pathname}${url.search}`;
+};
+
+const invalidUsage = (message, guidance) =>
+  Object.assign(new Error(message), {
+    cliCode: 'CLI_INVALID_USAGE',
+    guidance: guidance || 'Run `outrank-cli marketplace --help` to see the available marketplace commands.',
+  });
+
+const requireOption = (parsed, name, label) => {
+  const value = getOption(parsed, name);
+  if (!value) {
+    throw invalidUsage(`Missing required option: --${name} ${label || ''}`.trim() + '.');
+  }
+  return value;
+};
+
+const splitList = (values) =>
+  values
+    .flatMap((value) => value.split(','))
+    .map((value) => value.trim())
+    .filter(Boolean);
+
+const handleSellerStatus = async (parsed) => {
+  const productId = getRequiredPositional(parsed, 0, '<product-id>');
+  const path = buildQueryPath(`/products/${productId}/marketplace/seller/status`, {
+    refresh_stripe: hasFlag(parsed, 'refresh-stripe') ? 'true' : undefined,
+  });
+  const response = await requestAgentApi(parsed, { method: 'GET', path });
+  return response.payload;
+};
+
+const handleSellerOnboard = async (parsed) => {
+  const productId = getRequiredPositional(parsed, 0, '<product-id>');
+  const country = getOption(parsed, 'country');
+
+  const statusResponse = await requestAgentApi(parsed, {
+    method: 'GET',
+    path: `/products/${productId}/marketplace/seller/status`,
+  });
+  if (!statusResponse.ok) return statusResponse.payload;
+
+  const status = statusResponse.payload?.data ?? {};
+  const actions = [];
+
+  if (status.enrollment?.completed) {
+    return cliSuccess(
+      { status, actions },
+      `Seller onboarding is already complete for this product. ${statusResponse.payload?.agent_guidance ?? ''}`.trim(),
+    );
+  }
+
+  let cmsConnected = Boolean(status.onboarding?.cms?.connected);
+  const gscConnected = Boolean(status.onboarding?.gsc?.connected);
+  let stripeAccountConnected = Boolean(status.onboarding?.stripe?.accountConnected);
+  let stripeOnboardingUrl = null;
+  let adoptFailureMessage = null;
+
+  if (!cmsConnected && status.onboarding?.cms?.existing) {
+    const adoptResponse = await requestAgentApi(parsed, {
+      method: 'POST',
+      path: `/products/${productId}/marketplace/seller/integrations/adopt`,
+    });
+    actions.push({
+      action: 'adopt-existing-integration',
+      ok: Boolean(adoptResponse.payload?.ok),
+      result: adoptResponse.payload?.ok ? adoptResponse.payload.data : adoptResponse.payload?.error,
+    });
+    if (adoptResponse.payload?.ok) {
+      cmsConnected = true;
+    } else {
+      adoptFailureMessage = adoptResponse.payload?.error?.message ?? 'the existing integration could not be reused';
+    }
+  }
+
+  if (!stripeAccountConnected && gscConnected && cmsConnected && country) {
+    const stripeResponse = await requestAgentApi(parsed, {
+      method: 'POST',
+      path: `/products/${productId}/marketplace/seller/stripe-connect/onboard`,
+      body: { country },
+    });
+    actions.push({
+      action: 'stripe-express-onboard',
+      ok: Boolean(stripeResponse.payload?.ok),
+      result: stripeResponse.payload?.ok ? stripeResponse.payload.data : stripeResponse.payload?.error,
+    });
+    if (stripeResponse.payload?.ok) {
+      stripeAccountConnected = true;
+      stripeOnboardingUrl = stripeResponse.payload.data?.onboardingUrl ?? null;
+    }
+  }
+
+  const eligibilityResponse = await requestAgentApi(parsed, {
+    method: 'GET',
+    path: buildQueryPath(`/products/${productId}/marketplace/seller/eligibility`, { refresh: 'true' }),
+  });
+  const eligibility = eligibilityResponse.payload?.ok ? eligibilityResponse.payload.data : null;
+
+  const remaining = [];
+  if (!gscConnected) {
+    remaining.push(
+      `Blog step: collect the product's content details from the human (outrank-cli products get/update ${productId}) and connect Google Search Console (outrank-cli products gsc connect ${productId}, then gsc poll and gsc set-property) — required before anything else`,
+    );
+  }
+  remaining.push(
+    `Articles step: review article settings (outrank-cli products output-settings get/update ${productId}) and set the publishing schedule (outrank-cli marketplace seller settings update ${productId} --json '{"dailyArticleLimit":<1-3>,"publishingDays":[...]}')`,
+  );
+  if (!cmsConnected) {
+    remaining.push(
+      adoptFailureMessage
+        ? `Integration step: adopting the existing CMS failed (${adoptFailureMessage}) — run outrank-cli marketplace seller integrations status ${productId}, connect a new supported platform via the products integrations commands, then claim it for the marketplace`
+        : `Integration step: no reusable CMS was found — run outrank-cli marketplace seller integrations status ${productId}, connect a supported platform via the products integrations commands, then claim it for the marketplace`,
+    );
+  }
+  if (!stripeAccountConnected) {
+    remaining.push(
+      country
+        ? `Payouts step: Stripe Express could not be created yet — finish the earlier steps, then run outrank-cli marketplace seller stripe onboard ${productId} --country ${country}`
+        : `Payouts step: ask the human for the two-letter country of their payout bank account, then run outrank-cli marketplace seller stripe onboard ${productId} --country <ISO2> (or re-run this command with --country)`,
+    );
+  } else if (stripeOnboardingUrl) {
+    remaining.push(
+      `Payouts step: the Stripe Express account is ready — the human must open ${stripeOnboardingUrl} in a browser and finish identity and bank details`,
+    );
+  } else if (!status.onboarding?.stripe?.payoutsEnabled) {
+    remaining.push(
+      `Payouts step: Stripe onboarding looks unfinished — get a fresh link with outrank-cli marketplace seller stripe onboard ${productId}${country ? ` --country ${country}` : ''} and have the human complete it`,
+    );
+  }
+  remaining.push(
+    `Finish with outrank-cli marketplace seller complete-onboarding ${productId}, then re-check outrank-cli marketplace seller status ${productId}`,
+  );
+
+  const eligibilityNote = eligibilityResponse.payload?.agent_guidance
+    ? ` Eligibility: ${eligibilityResponse.payload.agent_guidance}`
+    : '';
+
+  return cliSuccess(
+    { status, actions, eligibility },
+    `Seller onboarding in progress (wizard order: Blog -> Articles -> Integration -> Payouts). ${actions.length > 0 ? `Automatic actions taken: ${actions.map((entry) => `${entry.action} (${entry.ok ? 'ok' : 'failed'})`).join(', ')}. ` : ''}Steps to complete with the human: ${remaining.join('; ')}.${eligibilityNote} Always report the eligibility check results to the human.`,
+  );
+};
+
+const handleSellerEligibility = async (argv) => {
+  if (argv[0] === 'recheck') {
+    const parsed = parseArgs(argv.slice(1));
+    const productId = getRequiredPositional(parsed, 0, '<product-id>');
+    const response = await requestAgentApi(parsed, {
+      method: 'POST',
+      path: `/products/${productId}/marketplace/seller/eligibility/recheck`,
+    });
+    return response.payload;
+  }
+
+  const parsed = parseArgs(argv);
+  const productId = getRequiredPositional(parsed, 0, '<product-id>');
+  const path = buildQueryPath(`/products/${productId}/marketplace/seller/eligibility`, {
+    refresh: hasFlag(parsed, 'refresh') ? 'true' : undefined,
+  });
+  const response = await requestAgentApi(parsed, { method: 'GET', path });
+  return response.payload;
+};
+
+const handleSellerSettings = async (argv) => {
+  const subcommand = argv[0];
+  const parsed = parseArgs(argv.slice(1));
+
+  if (subcommand === 'get') {
+    const productId = getRequiredPositional(parsed, 0, '<product-id>');
+    const response = await requestAgentApi(parsed, {
+      method: 'GET',
+      path: `/products/${productId}/marketplace/seller/settings`,
+    });
+    return response.payload;
+  }
+
+  if (subcommand === 'update') {
+    const productId = getRequiredPositional(parsed, 0, '<product-id>');
+    const body = await readJsonInput(parsed);
+    const response = await requestAgentApi(parsed, {
+      method: 'PATCH',
+      path: `/products/${productId}/marketplace/seller/settings`,
+      body,
+    });
+    return response.payload;
+  }
+
+  throw invalidUsage(`Unknown marketplace seller settings subcommand: ${subcommand}.`);
+};
+
+const handleSellerIntegrations = async (argv) => {
+  const subcommand = argv[0];
+  const parsed = parseArgs(argv.slice(1));
+
+  if (subcommand === 'status') {
+    const productId = getRequiredPositional(parsed, 0, '<product-id>');
+    const response = await requestAgentApi(parsed, {
+      method: 'GET',
+      path: `/products/${productId}/marketplace/seller/integrations`,
+    });
+    return response.payload;
+  }
+
+  if (subcommand === 'adopt') {
+    const productId = getRequiredPositional(parsed, 0, '<product-id>');
+    const response = await requestAgentApi(parsed, {
+      method: 'POST',
+      path: `/products/${productId}/marketplace/seller/integrations/adopt`,
+    });
+    return response.payload;
+  }
+
+  if (subcommand === 'claim') {
+    const productId = getRequiredPositional(parsed, 0, '<product-id>');
+    const response = await requestAgentApi(parsed, {
+      method: 'POST',
+      path: `/products/${productId}/marketplace/seller/integrations/claim`,
+      body: {
+        integrationId: requireOption(parsed, 'integration', '<integration-id>'),
+        integrationType: requireOption(parsed, 'type', '<platform>'),
+      },
+    });
+    return response.payload;
+  }
+
+  if (subcommand === 'set-activation') {
+    const productId = getRequiredPositional(parsed, 0, '<product-id>');
+    const integrationId = requireOption(parsed, 'integration', '<integration-id>');
+    const response = await requestAgentApi(parsed, {
+      method: 'PATCH',
+      path: `/products/${productId}/marketplace/seller/integrations/${integrationId}`,
+      body: {
+        integrationType: requireOption(parsed, 'type', '<platform>'),
+        activationStatus: requireOption(parsed, 'status', 'active|disabled'),
+      },
+    });
+    return response.payload;
+  }
+
+  if (subcommand === 'delete') {
+    const productId = getRequiredPositional(parsed, 0, '<product-id>');
+    const integrationId = requireOption(parsed, 'integration', '<integration-id>');
+    const path = buildQueryPath(`/products/${productId}/marketplace/seller/integrations/${integrationId}`, {
+      integration_type: requireOption(parsed, 'type', '<platform>'),
+    });
+    const response = await requestAgentApi(parsed, { method: 'DELETE', path });
+    return response.payload;
+  }
+
+  throw invalidUsage(`Unknown marketplace seller integrations subcommand: ${subcommand}.`);
+};
+
+const handleSellerStripe = async (argv) => {
+  const subcommand = argv[0];
+  const parsed = parseArgs(argv.slice(1));
+  const productId = getRequiredPositional(parsed, 0, '<product-id>');
+
+  if (subcommand === 'onboard') {
+    const country = getOption(parsed, 'country');
+    const response = await requestAgentApi(parsed, {
+      method: 'POST',
+      path: `/products/${productId}/marketplace/seller/stripe-connect/onboard`,
+      body: country ? { country } : {},
+    });
+    return response.payload;
+  }
+
+  if (subcommand === 'manage') {
+    const response = await requestAgentApi(parsed, {
+      method: 'POST',
+      path: `/products/${productId}/marketplace/seller/stripe-connect/manage`,
+    });
+    return response.payload;
+  }
+
+  if (subcommand === 'reset') {
+    const response = await requestAgentApi(parsed, {
+      method: 'POST',
+      path: `/products/${productId}/marketplace/seller/stripe-connect/reset`,
+    });
+    return response.payload;
+  }
+
+  throw invalidUsage(`Unknown marketplace seller stripe subcommand: ${subcommand}.`);
+};
+
+const SELLER_PLACEMENT_ACTIONS = new Set(['approve', 'decline', 'publish', 'regenerate']);
+
+const handleSellerPlacements = async (argv) => {
+  const subcommand = argv[0];
+  const parsed = parseArgs(argv.slice(1));
+
+  if (subcommand === 'list') {
+    const productId = getRequiredPositional(parsed, 0, '<product-id>');
+    const path = buildQueryPath(`/products/${productId}/marketplace/seller/placements`, {
+      status: getOption(parsed, 'status'),
+      search: getOption(parsed, 'search'),
+      page: parseIntegerOption(parsed, 'page', { min: 1 }),
+      page_size: parseIntegerOption(parsed, 'page-size', { min: 1, max: 100 }),
+    });
+    const response = await requestAgentApi(parsed, { method: 'GET', path });
+    return response.payload;
+  }
+
+  if (SELLER_PLACEMENT_ACTIONS.has(subcommand)) {
+    const placementId = getRequiredPositional(parsed, 0, '<placement-id>');
+    const response = await requestAgentApi(parsed, {
+      method: 'POST',
+      path: `/marketplace/placements/${placementId}/${subcommand}`,
+    });
+    return response.payload;
+  }
+
+  throw invalidUsage(`Unknown marketplace seller placements subcommand: ${subcommand}.`);
+};
+
+const handleSellerContentHistory = async (parsed) => {
+  const productId = getRequiredPositional(parsed, 0, '<product-id>');
+  const path = buildQueryPath('/articles', {
+    product_id: productId,
+    track_scope: 'marketplace',
+    status: getOption(parsed, 'status'),
+    limit: parseIntegerOption(parsed, 'limit', { min: 1, max: 100 }),
+    offset: parseIntegerOption(parsed, 'offset', { min: 0 }),
+  });
+  const response = await requestAgentApi(parsed, { method: 'GET', path });
+  return response.payload;
+};
+
+const groupHelp = (guidance) =>
+  cliSuccess(
+    {
+      usage: MARKETPLACE_HELP.trim(),
+    },
+    guidance,
+  );
+
+const handleSellerCommand = async (argv) => {
+  const subcommand = argv[0];
+
+  if (!subcommand || subcommand === '--help' || subcommand === '-h' || subcommand === 'help') {
+    return groupHelp(
+      'Choose a seller subcommand: status, onboard, eligibility, settings, integrations, stripe, complete-onboarding, placements, earnings, content-history.',
+    );
+  }
+
+  if (subcommand === 'status') return handleSellerStatus(parseArgs(argv.slice(1)));
+  if (subcommand === 'onboard') return handleSellerOnboard(parseArgs(argv.slice(1)));
+  if (subcommand === 'eligibility') return handleSellerEligibility(argv.slice(1));
+  if (subcommand === 'settings') return handleSellerSettings(argv.slice(1));
+  if (subcommand === 'integrations') return handleSellerIntegrations(argv.slice(1));
+  if (subcommand === 'stripe') return handleSellerStripe(argv.slice(1));
+  if (subcommand === 'placements') return handleSellerPlacements(argv.slice(1));
+  if (subcommand === 'earnings') {
+    const parsed = parseArgs(argv.slice(1));
+    const productId = getRequiredPositional(parsed, 0, '<product-id>');
+    const response = await requestAgentApi(parsed, {
+      method: 'GET',
+      path: `/products/${productId}/marketplace/seller/earnings`,
+    });
+    return response.payload;
+  }
+  if (subcommand === 'complete-onboarding') {
+    const parsed = parseArgs(argv.slice(1));
+    const productId = getRequiredPositional(parsed, 0, '<product-id>');
+    const response = await requestAgentApi(parsed, {
+      method: 'POST',
+      path: `/products/${productId}/marketplace/seller/complete-onboarding`,
+    });
+    return response.payload;
+  }
+  if (subcommand === 'content-history') return handleSellerContentHistory(parseArgs(argv.slice(1)));
+
+  throw invalidUsage(`Unknown marketplace seller subcommand: ${subcommand}.`);
+};
+
+const handleNotifications = async (argv) => {
+  const subcommand = argv[0];
+
+  if (!subcommand || subcommand === '--help' || subcommand === '-h' || subcommand === 'help') {
+    return groupHelp('Choose a notifications subcommand: list or mark-read (both take --role seller|buyer).');
+  }
+
+  const parsed = parseArgs(argv.slice(1));
+
+  if (subcommand === 'list') {
+    const productId = getRequiredPositional(parsed, 0, '<product-id>');
+    const path = buildQueryPath(`/products/${productId}/marketplace/notifications`, {
+      role: requireOption(parsed, 'role', 'seller|buyer'),
+      type: getOption(parsed, 'type'),
+      sort: getOption(parsed, 'sort'),
+      page: parseIntegerOption(parsed, 'page', { min: 1 }),
+      page_size: parseIntegerOption(parsed, 'page-size', { min: 1, max: 100 }),
+    });
+    const response = await requestAgentApi(parsed, { method: 'GET', path });
+    return response.payload;
+  }
+
+  if (subcommand === 'mark-read') {
+    const productId = getRequiredPositional(parsed, 0, '<product-id>');
+    const ids = splitList(getOptions(parsed, 'ids'));
+    const response = await requestAgentApi(parsed, {
+      method: 'PATCH',
+      path: `/products/${productId}/marketplace/notifications`,
+      body: {
+        role: requireOption(parsed, 'role', 'seller|buyer'),
+        ...(ids.length > 0 ? { ids } : {}),
+      },
+    });
+    return response.payload;
+  }
+
+  throw invalidUsage(`Unknown marketplace notifications subcommand: ${subcommand}.`);
+};
+
+const handleBuyerTargetPages = async (argv) => {
+  const subcommand = argv[0];
+  const parsed = parseArgs(argv.slice(1));
+
+  if (subcommand === 'list') {
+    const productId = getRequiredPositional(parsed, 0, '<product-id>');
+    const response = await requestAgentApi(parsed, {
+      method: 'GET',
+      path: `/products/${productId}/marketplace/buyer/target-pages`,
+    });
+    return response.payload;
+  }
+
+  if (subcommand === 'add') {
+    const productId = getRequiredPositional(parsed, 0, '<product-id>');
+    const urls = splitList(getOptions(parsed, 'urls'));
+    if (urls.length === 0) {
+      throw invalidUsage('Missing required option: --urls <url1,url2,...>.');
+    }
+    const source = getOption(parsed, 'source');
+    const response = await requestAgentApi(parsed, {
+      method: 'POST',
+      path: `/products/${productId}/marketplace/buyer/target-pages`,
+      body: { urls, ...(source ? { source } : {}) },
+    });
+    return response.payload;
+  }
+
+  if (subcommand === 'discover') {
+    const productId = getRequiredPositional(parsed, 0, '<product-id>');
+    const path = buildQueryPath(`/products/${productId}/marketplace/buyer/target-pages/discover`, {
+      source_type: getOption(parsed, 'source'),
+      source_url: getOption(parsed, 'source-url'),
+    });
+    const response = await requestAgentApi(parsed, { method: 'GET', path });
+    return response.payload;
+  }
+
+  if (subcommand === 'pause' || subcommand === 'activate') {
+    const targetPageId = getRequiredPositional(parsed, 0, '<target-page-id>');
+    const response = await requestAgentApi(parsed, {
+      method: 'PATCH',
+      path: `/marketplace/target-pages/${targetPageId}`,
+      body: { status: subcommand === 'pause' ? 'paused' : 'active' },
+    });
+    return response.payload;
+  }
+
+  if (subcommand === 'delete') {
+    const targetPageId = getRequiredPositional(parsed, 0, '<target-page-id>');
+    const response = await requestAgentApi(parsed, {
+      method: 'DELETE',
+      path: `/marketplace/target-pages/${targetPageId}`,
+    });
+    return response.payload;
+  }
+
+  throw invalidUsage(`Unknown marketplace buyer target-pages subcommand: ${subcommand}.`);
+};
+
+const handleBuyerPlacements = async (argv) => {
+  const subcommand = argv[0];
+  const parsed = parseArgs(argv.slice(1));
+
+  if (subcommand === 'list') {
+    const productId = getRequiredPositional(parsed, 0, '<product-id>');
+    const path = buildQueryPath(`/products/${productId}/marketplace/buyer/placements`, {
+      status: getOption(parsed, 'status'),
+      search: getOption(parsed, 'search'),
+      page: parseIntegerOption(parsed, 'page', { min: 1 }),
+      page_size: parseIntegerOption(parsed, 'page-size', { min: 1, max: 100 }),
+    });
+    const response = await requestAgentApi(parsed, { method: 'GET', path });
+    return response.payload;
+  }
+
+  if (subcommand === 'regenerate' || subcommand === 'revalidate') {
+    const placementId = getRequiredPositional(parsed, 0, '<placement-id>');
+    const response = await requestAgentApi(parsed, {
+      method: 'POST',
+      path: `/marketplace/buyer-placements/${placementId}/${subcommand}`,
+    });
+    return response.payload;
+  }
+
+  throw invalidUsage(`Unknown marketplace buyer placements subcommand: ${subcommand}.`);
+};
+
+const handleBuyerArticle = async (argv) => {
+  const subcommand = argv[0];
+  const parsed = parseArgs(argv.slice(1));
+  const placementId = getRequiredPositional(parsed, 0, '<placement-id>');
+
+  if (subcommand === 'get') {
+    const response = await requestAgentApi(parsed, {
+      method: 'GET',
+      path: `/marketplace/buyer-placements/${placementId}/article`,
+    });
+    return response.payload;
+  }
+
+  if (subcommand === 'edit') {
+    const body = await readJsonInput(parsed);
+    const response = await requestAgentApi(parsed, {
+      method: 'PATCH',
+      path: `/marketplace/buyer-placements/${placementId}/article`,
+      body,
+    });
+    return response.payload;
+  }
+
+  throw invalidUsage(`Unknown marketplace buyer article subcommand: ${subcommand}.`);
+};
+
+const handleBuyerCredits = async (argv) => {
+  const subcommand = argv[0];
+  const parsed = parseArgs(argv.slice(1));
+
+  if (subcommand === 'history') {
+    const productId = getRequiredPositional(parsed, 0, '<product-id>');
+    const path = buildQueryPath(`/products/${productId}/marketplace/buyer/credits/history`, {
+      kind: getOption(parsed, 'kind'),
+      page: parseIntegerOption(parsed, 'page', { min: 1 }),
+      page_size: parseIntegerOption(parsed, 'page-size', { min: 1, max: 100 }),
+    });
+    const response = await requestAgentApi(parsed, { method: 'GET', path });
+    return response.payload;
+  }
+
+  throw invalidUsage(`Unknown marketplace buyer credits subcommand: ${subcommand}.`);
+};
+
+const handleBuyerCommand = async (argv) => {
+  const subcommand = argv[0];
+
+  if (!subcommand || subcommand === '--help' || subcommand === '-h' || subcommand === 'help') {
+    return groupHelp(
+      'Choose a buyer subcommand: status, billing-status, subscription, subscribe-quote, checkout, change-plan, target-pages, participation, placements, article, credits. Start with `marketplace buyer status <productId>` — its guidance drives the setup sequence.',
+    );
+  }
+
+  if (subcommand === 'status') {
+    const parsed = parseArgs(argv.slice(1));
+    const productId = getRequiredPositional(parsed, 0, '<product-id>');
+    const response = await requestAgentApi(parsed, {
+      method: 'GET',
+      path: `/products/${productId}/marketplace/buyer/status`,
+    });
+    return response.payload;
+  }
+
+  if (subcommand === 'billing-status') {
+    const parsed = parseArgs(argv.slice(1));
+    const productId = getRequiredPositional(parsed, 0, '<product-id>');
+    const response = await requestAgentApi(parsed, {
+      method: 'GET',
+      path: `/products/${productId}/marketplace/buyer/billing-status`,
+    });
+    return response.payload;
+  }
+
+  if (subcommand === 'subscription') {
+    const parsed = parseArgs(argv.slice(1));
+    const productId = getRequiredPositional(parsed, 0, '<product-id>');
+    const response = await requestAgentApi(parsed, {
+      method: 'GET',
+      path: `/products/${productId}/marketplace/buyer/subscription`,
+    });
+    return response.payload;
+  }
+
+  if (subcommand === 'subscribe-quote') {
+    const parsed = parseArgs(argv.slice(1));
+    const productId = getRequiredPositional(parsed, 0, '<product-id>');
+    const path = buildQueryPath(`/products/${productId}/backlinks/subscribe-quote`, { plan: 'enterprise' });
+    const response = await requestAgentApi(parsed, { method: 'GET', path });
+    return response.payload;
+  }
+
+  if (subcommand === 'checkout') {
+    const parsed = parseArgs(argv.slice(1));
+    const productId = getRequiredPositional(parsed, 0, '<product-id>');
+    const response = await requestAgentApi(parsed, {
+      method: 'POST',
+      path: `/products/${productId}/marketplace/buyer/checkout`,
+      body: { tier: requireOption(parsed, 'tier', '<tier>') },
+    });
+    return response.payload;
+  }
+
+  if (subcommand === 'change-plan') {
+    const parsed = parseArgs(argv.slice(1));
+    const productId = getRequiredPositional(parsed, 0, '<product-id>');
+    const tier = getOption(parsed, 'tier');
+    const response = await requestAgentApi(parsed, {
+      method: 'POST',
+      path: `/products/${productId}/marketplace/buyer/change-plan`,
+      body: {
+        action: requireOption(parsed, 'action', 'change_tier|cancel_scheduled|cancel_subscription|restore_subscription'),
+        ...(tier ? { tier } : {}),
+      },
+    });
+    return response.payload;
+  }
+
+  if (subcommand === 'participation') {
+    const mode = argv[1];
+    if (mode !== 'on' && mode !== 'off') {
+      throw invalidUsage('marketplace buyer participation requires `on` or `off`.');
+    }
+    const parsed = parseArgs(argv.slice(2));
+    const productId = getRequiredPositional(parsed, 0, '<product-id>');
+    const response = await requestAgentApi(parsed, {
+      method: 'POST',
+      path: `/products/${productId}/marketplace/buyer/participation`,
+      body: { enabled: mode === 'on' },
+    });
+    return response.payload;
+  }
+
+  if (subcommand === 'target-pages') return handleBuyerTargetPages(argv.slice(1));
+  if (subcommand === 'placements') return handleBuyerPlacements(argv.slice(1));
+  if (subcommand === 'article') return handleBuyerArticle(argv.slice(1));
+  if (subcommand === 'credits') return handleBuyerCredits(argv.slice(1));
+
+  throw invalidUsage(`Unknown marketplace buyer subcommand: ${subcommand}.`);
+};
+
+export const handleMarketplaceCommand = async (argv) => {
+  const subcommand = argv[0];
+  const parsed = parseArgs(argv.slice(1));
+  const wantsHelp =
+    !subcommand || subcommand === '--help' || subcommand === '-h' || subcommand === 'help' || hasFlag(parsed, 'help');
+
+  if (wantsHelp) {
+    return cliSuccess(
+      {
+        usage: MARKETPLACE_HELP.trim(),
+      },
+      'Choose `seller`, `buyer`, or `notifications`. Sellers earn by hosting marketplace backlinks in their articles; buyers spend backlink credits to place links on high-authority articles. Start buyers with `marketplace buyer status` and sellers with `marketplace seller status`.',
+    );
+  }
+
+  if (subcommand === 'seller') return handleSellerCommand(argv.slice(1));
+  if (subcommand === 'buyer') return handleBuyerCommand(argv.slice(1));
+  if (subcommand === 'notifications') return handleNotifications(argv.slice(1));
+
+  throw invalidUsage(`Unknown marketplace subcommand: ${subcommand}.`);
+};

package/src/index.js

@@ -13,6 +13,7 @@ import { handleUsageCommand } from './commands/usage.js';
 import { handleKeywordsCommand } from './commands/keywords.js';
 import { handleArticlesCommand } from './commands/articles.js';
 import { handleImprovementsCommand } from './commands/improvements.js';
+import { handleMarketplaceCommand } from './commands/marketplace.js';
 
 const getVersion = () => {
   try {
@@ -37,6 +38,7 @@ Groups:
   keywords    Inspect, check write status, add, reschedule, delete, suggest, generate, and export keyword plans.
   articles    Inspect article metadata and bodies, edit content, retry publish, precreate, and generate.
   improvements Discover, brief, schedule, run, review, and publish article improvements for existing posts.
+  marketplace Seller onboarding, eligibility, placements, earnings, Stripe payouts, and buyer setup for the Outrank Marketplace.
   subscription Inspect plan, trial, quota, and add-on status.
   usage       Inspect current usage and quota consumption.
   billing     Product-slot purchase flows.
@@ -72,6 +74,9 @@ Examples:
   outrank-cli products backlinks get <product-id>
   outrank-cli products backlinks earned <product-id> --limit 20 --include-article
   outrank-cli billing purchase-products quote --additional-products 2
+  outrank-cli marketplace seller status <product-id>
+  outrank-cli marketplace seller onboard <product-id> --country US
+  outrank-cli marketplace seller placements list <product-id> --status needs_approval
 `;
 
 const main = async () => {
@@ -117,6 +122,8 @@ const main = async () => {
     result = await handleArticlesCommand(rest);
   } else if (group === 'improvements') {
     result = await handleImprovementsCommand(rest);
+  } else if (group === 'marketplace') {
+    result = await handleMarketplaceCommand(rest);
   } else if (group === 'subscription') {
     result = await handleSubscriptionCommand(rest);
   } else if (group === 'usage') {