rankcontrol 0.1.0 → 0.6.0

package/README.md

@@ -9,25 +9,58 @@ Every command calls the same authed, rate-limited, org-scoped API the RankContro
 
 ## Auth
 
-Create an API key in **RankControl → Settings → API**, then:
+The easy way — approve in your browser (you must be logged in to RankControl):
+
+```bash
+npx rankcontrol login
+```
+
+That opens your dashboard, you check the confirmation code matches, pick the permissions to grant, and the CLI stores a scoped key in `~/.rankcontrol/config.json`. `npx rankcontrol logout` removes it (revoke the key itself in Settings → API).
+
+The headless way (CI, servers, MCP `env` blocks) — create a key in **RankControl → Settings → API**, then:
 
 ```bash
 export RANKCONTROL_API_KEY=rctrl_pk_...
 ```
 
-Scopes are set per key. Read-only keys work for all `get_*`/`list_*` tools.
+The env var wins over the stored config when both exist. Scopes are set per key; read-only keys work for all `get_*`/`list_*` tools.
 
 ## CLI
 
 ```bash
 npx rankcontrol funnel                 # AI crawls / AI visits / AI leads (30d)
+npx rankcontrol score                  # composite visibility score + subscores (AI/Google/Bing)
+npx rankcontrol leads --limit 100      # captured leads with AI source attribution
+npx rankcontrol traffic --days 30      # page views, visitors, bounce rate, time on page
 npx rankcontrol visibility --days 60   # daily AI visibility score trend
+npx rankcontrol sov --days 30          # share of voice vs competitors
+npx rankcontrol sources --days 30      # cited domains typed brand/competitive/ugc/editorial
+npx rankcontrol sentiment --days 30    # how AI answers frame your brand
+npx rankcontrol optimizer --limit 25   # pages ranked by citability, worst first
 npx rankcontrol citations --model chatgpt
+npx rankcontrol queries                # tracked queries checked weekly across AI engines
 npx rankcontrol capacity               # remaining content-plan slots
 npx rankcontrol plan-content --topics "bus travel" --max-difficulty 40
 npx rankcontrol commit-titles --file titles.json
 npx rankcontrol publish <contentId>            # dry run
 npx rankcontrol publish <contentId> --confirm  # actually publish
+npx rankcontrol generate <contentId>           # dry run
+npx rankcontrol generate <contentId> --confirm # write a planned article now (slot unchanged)
+npx rankcontrol settings               # article policy (auto-write, auto-publish, images, ...)
+npx rankcontrol settings-set --auto-generate off --auto-publish off
+npx rankcontrol reschedule <contentId> 2026-08-04
+npx rankcontrol internal-links <contentId>     # who links here / links out
+npx rankcontrol site-pages             # pages used for internal links
+npx rankcontrol detect-links https://example.com/sitemap.xml
+npx rankcontrol add-pages https://example.com/pricing
+npx rankcontrol repurpose              # published articles + social draft chips
+npx rankcontrol repurpose <contentId>  # full drafts for one article
+npx rankcontrol repurpose-generate <contentId> --platforms twitter --confirm
+npx rankcontrol repurpose-edit <draftId> --title "New hook"
+npx rankcontrol repurpose-channels     # Postiz channel ids (for repurpose-push)
+npx rankcontrol repurpose-push <draftId> --channels <id>   # dry run
+npx rankcontrol repurpose-push <draftId> --channels <id> --confirm
+npx rankcontrol repurpose-mark-posted <draftId>            # posted it yourself
 npx rankcontrol jobs                   # async job status (agent runs)
 ```
 
@@ -58,14 +91,34 @@ Or in `.mcp.json` / Cursor `mcp.json`:
 | Tool | What it does |
 |---|---|
 | `get_overview_funnel` | AI crawls / AI visits / AI leads, last 30 days |
+| `list_leads` | Captured leads with AI model / query / page attribution |
+| `get_traffic_overview` | Page views, visitors, sessions, bounce rate, time on page |
 | `get_visibility_trend` | Daily visibility score from stored weekly citation checks |
 | `list_citations` | Recent citation checks per AI model |
-| `get_visibility_score` | Current overall AI visibility score |
+| `list_tracked_queries` | The queries checked weekly across the AI engines |
+| `get_visibility_score` | Composite score (50% AI + 30% Google + 20% Bing) with subscores |
+| `get_share_of_voice` | Your citation rate vs competitor mention rates + your share |
+| `get_citation_sources` | Cited domains typed brand / competitive / UGC / editorial |
+| `get_citation_sentiment` | Positive / neutral / negative framing with recent receipts |
+| `get_citability_report` | Published pages by citability score, worst first, with fixes |
 | `get_planning_capacity` | Remaining calendar slots (check before planning) |
 | `plan_content` | Generate candidate titles (capacity-gated, nothing scheduled) |
 | `commit_planned_titles` | Approve reviewed titles onto the calendar |
 | `publish_content` | Dry run by default; `confirm: true` publishes |
+| `generate_article` | Write a planned article's body now, slot unchanged; dry run by default |
+| `get_article_settings` / `update_article_settings` | Read / merge-patch the article policy (auto-write, auto-publish, images, links, ...) |
+| `reschedule_article` | Move a planned article to another day (flexible schedule) |
+| `get_internal_links` | Who links to this article internally, and its outbound count |
+| `list_site_pages` / `add_site_pages` | Pages used for in-article internal links |
+| `detect_site_links` | Scan a sitemap or blog root for site pages |
+| `list_repurpose_queue` | Published articles + social draft chips per platform |
+| `get_repurpose_drafts` | Full social drafts for one article (8 platforms) |
+| `generate_repurpose_drafts` | Draft social posts for an article; dry run by default |
+| `update_repurpose_draft` | Edit a draft's body/title before pushing |
+| `mark_repurpose_posted` | Record a draft as posted manually |
+| `list_postiz_channels` | Connected Postiz channels (ids for pushing) |
+| `push_repurpose_draft` | Send a draft to Postiz; dry run by default |
 | `list_content` | Content pages with status |
 | `list_jobs` | Async job status (agent runs) |
 
-The plan→commit split is intentional: `plan_content` proposes, a human (or a supervising agent) reviews, `commit_planned_titles` approves. `publish_content` is dry-run-first for the same reason.
+The plan→commit split is intentional: `plan_content` proposes, a human (or a supervising agent) reviews, `commit_planned_titles` approves. `publish_content` and `generate_article` are dry-run-first for the same reason.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rankcontrol",
-  "version": "0.1.0",
+  "version": "0.6.0",
   "description": "RankControl CLI + MCP server: drive your SEO/AI-visibility workspace from the terminal or any AI agent",
   "license": "MIT",
   "homepage": "https://rctrl.com",

package/src/cli.mjs

@@ -12,13 +12,16 @@ const fail = (err) => {
 const list = (val) => val.split(",").map((s) => s.trim()).filter(Boolean);
 
 export function runCli(argv) {
+  const pkg = JSON.parse(
+    readFileSync(new URL("../package.json", import.meta.url), "utf8")
+  );
   const program = new Command();
   program
     .name("rankcontrol")
     .description(
-      "RankControl from the terminal. Auth: export RANKCONTROL_API_KEY=rctrl_pk_... (Settings → API)"
+      "RankControl from the terminal. Auth: `rankcontrol login` (browser approval) or export RANKCONTROL_API_KEY=rctrl_pk_..."
     )
-    .version("0.1.0");
+    .version(pkg.version);
 
   program
     .command("mcp")
@@ -28,17 +31,75 @@ export function runCli(argv) {
       await startMcpServer().catch(fail);
     });
 
+  program
+    .command("login")
+    .description("Authenticate via your browser (approves a scoped API key into ~/.rankcontrol)")
+    .option("--scopes <a,b,c>", "Scopes to request (default: reads + write:content + write:publish)")
+    .action(async (opts) => {
+      const { login } = await import("./login.mjs");
+      await login({ scopes: opts.scopes ? list(opts.scopes) : undefined }).catch(fail);
+    });
+
+  program
+    .command("logout")
+    .description("Remove locally stored credentials")
+    .action(async () => {
+      const { logout } = await import("./login.mjs");
+      logout();
+    });
+
   program
     .command("funnel")
     .description("AI pipeline last 30 days: crawls, AI visits, AI leads")
     .action(() => api.overviewFunnel().then(out).catch(fail));
 
+  program
+    .command("leads")
+    .description("Captured leads with source attribution (AI model, query, page)")
+    .option("--limit <n>", "Max rows, up to 500", "100")
+    .action((opts) => api.leads(Number(opts.limit)).then(out).catch(fail));
+
+  program
+    .command("traffic")
+    .description("Traffic overview: page views, visitors, sessions, bounce rate, time on page")
+    .option("--days <n>", "7, 30 or 90", "30")
+    .action((opts) => api.trafficOverview(Number(opts.days)).then(out).catch(fail));
+
+  program
+    .command("score")
+    .description("Composite visibility score: 50% AI citation rate + 30% Google + 20% Bing rank share, with subscores")
+    .action(() => api.visibilityScore().then(out).catch(fail));
+
   program
     .command("visibility")
     .description("Daily AI visibility score trend from the stored weekly citation checks")
     .option("--days <n>", "30, 60 or 90", "30")
     .action((opts) => api.visibilityTrend(Number(opts.days)).then(out).catch(fail));
 
+  program
+    .command("sov")
+    .description("Share of voice: your citation rate vs top competitors, plus your share of all brand appearances")
+    .option("--days <n>", "Window in days, 7-90", "30")
+    .action((opts) => api.shareOfVoice(Number(opts.days)).then(out).catch(fail));
+
+  program
+    .command("sources")
+    .description("Domains AI answers cite for your tracked queries, typed brand/competitive/ugc/editorial")
+    .option("--days <n>", "Window in days, 7-90", "30")
+    .action((opts) => api.citationSources(Number(opts.days)).then(out).catch(fail));
+
+  program
+    .command("sentiment")
+    .description("How AI answers frame your brand when cited: positive/neutral/negative with recent receipts")
+    .option("--days <n>", "Window in days, 7-90", "30")
+    .action((opts) => api.citationSentiment(Number(opts.days)).then(out).catch(fail));
+
+  program
+    .command("optimizer")
+    .description("Published pages ranked by citability score, worst first, with their open fixes")
+    .option("--limit <n>", "Max rows", "25")
+    .action((opts) => api.optimizer(Number(opts.limit)).then(out).catch(fail));
+
   program
     .command("citations")
     .description("Recent AI citation checks")
@@ -51,11 +112,115 @@ export function runCli(argv) {
         .catch(fail)
     );
 
+  program
+    .command("queries")
+    .description("List the tracked queries checked weekly across the AI engines")
+    .action(() => api.trackedQueries().then(out).catch(fail));
+
+  program
+    .command("crawler-access")
+    .description("Daily AI-crawler reachability probe: is the site's edge or robots.txt blocking GPTBot/ClaudeBot")
+    .action(() => api.crawlerAccess().then(out).catch(fail));
+
+  program
+    .command("query-add")
+    .description("Add a query to the tracking pool (tracks immediately when a plan slot is free)")
+    .argument("<queryText>", "The search/AI query to track")
+    .action((queryText) => api.addQuery(queryText).then(out).catch(fail));
+
   program
     .command("capacity")
     .description("Remaining plan slots on the content calendar")
     .action(() => api.planningCapacity().then(out).catch(fail));
 
+  program
+    .command("team")
+    .description("Workspace members and pending invites (owner surface)")
+    .action(() => api.team().then(out).catch(fail));
+
+  program
+    .command("team-invite")
+    .description("Invite a member (dry-run by default; --confirm sends the email)")
+    .argument("<email>", "Invitee email")
+    .option(
+      "--perms <area=level,...>",
+      "Per-screen levels, e.g. content=write,analytics=read (unspecified screens default to none)"
+    )
+    .option("--confirm", "Actually send the invite")
+    .action((email, opts) => {
+      const screenPermissions = {};
+      for (const pair of (opts.perms ?? "").split(",").filter(Boolean)) {
+        const [area, level] = pair.split("=");
+        screenPermissions[area?.trim()] = level?.trim();
+      }
+      return api
+        .teamInvite({
+          email,
+          ...(Object.keys(screenPermissions).length ? { screenPermissions } : {}),
+          confirm: !!opts.confirm,
+        })
+        .then(out)
+        .catch(fail);
+    });
+
+  program
+    .command("team-revoke")
+    .description("Revoke a pending invite")
+    .argument("<invitationId>", "Invitation id from `team`")
+    .action((invitationId) => api.teamRevoke(invitationId).then(out).catch(fail));
+
+  program
+    .command("team-remove")
+    .description("Remove a member (requires --confirm)")
+    .argument("<userId>", "Member user id from `team`")
+    .option("--confirm", "Actually remove the member")
+    .action((userId, opts) =>
+      api
+        .teamRemove({ userId, confirm: !!opts.confirm })
+        .then(out)
+        .catch(fail)
+    );
+
+  program
+    .command("outreach-prospects")
+    .description("Link outreach pipeline with any found contact emails")
+    .action(() => api.outreachProspects().then(out).catch(fail));
+
+  program
+    .command("outreach-find-contact")
+    .description("Find an outreach email for a prospect (scrapes their site)")
+    .argument("<backlinkId>", "Prospect id from `outreach-prospects`")
+    .action((backlinkId) =>
+      api.outreachFindContact(backlinkId).then(out).catch(fail)
+    );
+
+  program
+    .command("outreach-draft-reply")
+    .description("AI-draft a reply to a prospect's inbound response (nothing sends)")
+    .argument("<backlinkId>", "Prospect id from `outreach-prospects`")
+    .action((backlinkId) =>
+      api.outreachDraftReply(backlinkId).then(out).catch(fail)
+    );
+
+  program
+    .command("outreach-queue")
+    .description("Queue an outreach email to send from the connected mailbox (dry-run by default)")
+    .argument("<backlinkId>", "Prospect id from `outreach-prospects`")
+    .option("--subject <subject>", "Override the drafted subject")
+    .option("--body <body>", "Override the drafted body")
+    .option("--confirm", "Actually queue the send")
+    .action((backlinkId, opts) =>
+      api
+        .outreachQueue({
+          backlinkId,
+          ...(opts.subject ? { subject: opts.subject } : {}),
+          ...(opts.body ? { body: opts.body } : {}),
+          confirm: !!opts.confirm,
+        })
+        .then(out)
+        .catch(fail)
+    );
+
   program
     .command("jobs")
     .description("Recent agent runs (async job status)")
@@ -114,5 +279,342 @@ export function runCli(argv) {
       api.publishContent(contentId, !!opts.confirm).then(out).catch(fail)
     );
 
+  program
+    .command("generate <contentId>")
+    .description("Write a planned article's body now, keeping its publish slot (past-due or ≤3 days ahead; dry run unless --confirm)")
+    .option("--confirm", "Actually start generation (spends LLM budget)")
+    .action((contentId, opts) =>
+      api.generateContent(contentId, !!opts.confirm).then(out).catch(fail)
+    );
+
+  program
+    .command("settings")
+    .description("Show the article policy: per-article defaults + flexible scheduling")
+    .action(() => api.articleSettings().then(out).catch(fail));
+
+  const onOff = (val) => {
+    if (val === "on" || val === "true") return true;
+    if (val === "off" || val === "false") return false;
+    throw new Error(`Expected on|off, got "${val}"`);
+  };
+
+  program
+    .command("settings-set")
+    .description("Merge-patch the article policy (only flags you pass change)")
+    .option("--auto-publish <on|off>")
+    .option("--auto-generate <on|off>", "Off = fully manual: write articles only on demand (generate command / Write now)")
+    .option("--images <on|off>", "AI hero + section images")
+    .option("--title-in-hero <on|off>", "Write the post title into the hero image")
+    .option("--section-infographics <on|off>", "Informational panels in 2,000+ word articles")
+    .option("--related-reading <on|off>", "Related Reading link block at the end")
+    .option("--youtube <on|off>", "Embedded video suggestions")
+    .option("--emojis <on|off>")
+    .option("--internal-links <n>", "Internal links per article (1-20)")
+    .option("--external-links <n>", "Outbound authority links per article (0-15)")
+    .option("--instructions <text>", "Global editorial instructions")
+    .option("--flexible-schedule <on|off>", "1-5 articles/day + calendar drag-and-drop")
+    .option(
+      "--image-style <set>",
+      "Image style set for all generated images: classic-editorial | print-craft | storybook-painterly | modern-saas | dark-premium | bold-poster"
+    )
+    .action((opts) => {
+      try {
+        const s = {};
+        if (opts.autoPublish !== undefined) s.autoPublish = onOff(opts.autoPublish);
+        if (opts.autoGenerate !== undefined) s.autoGenerate = onOff(opts.autoGenerate);
+        if (opts.images !== undefined) s.includeInfographics = onOff(opts.images);
+        if (opts.titleInHero !== undefined) s.titleInHeroImage = onOff(opts.titleInHero);
+        if (opts.sectionInfographics !== undefined)
+          s.includeSectionInfographics = onOff(opts.sectionInfographics);
+        if (opts.relatedReading !== undefined)
+          s.includeRelatedReading = onOff(opts.relatedReading);
+        if (opts.youtube !== undefined) s.includeYouTube = onOff(opts.youtube);
+        if (opts.emojis !== undefined) s.useEmojis = onOff(opts.emojis);
+        if (opts.internalLinks !== undefined)
+          s.internalLinksPerArticle = Number(opts.internalLinks);
+        if (opts.externalLinks !== undefined)
+          s.externalLinksPerArticle = Number(opts.externalLinks);
+        if (opts.instructions !== undefined) s.globalInstructions = opts.instructions;
+        const body = {};
+        if (Object.keys(s).length > 0) body.articleSettings = s;
+        if (opts.flexibleSchedule !== undefined)
+          body.flexibleScheduling = onOff(opts.flexibleSchedule);
+        if (opts.imageStyle !== undefined) body.styleSet = opts.imageStyle;
+        if (Object.keys(body).length === 0)
+          throw new Error("Pass at least one flag to change (see --help)");
+        return api.updateArticleSettings(body).then(out).catch(fail);
+      } catch (err) {
+        fail(err);
+      }
+    });
+
+  program
+    .command("reschedule <contentId> <date>")
+    .description("Move a planned article to a day (YYYY-MM-DD, local time; needs the flexible schedule)")
+    .action((contentId, date) => {
+      const day = new Date(`${date}T00:00:00`);
+      if (Number.isNaN(day.getTime())) return fail(new Error("Date must be YYYY-MM-DD"));
+      return api.reschedule(contentId, day.getTime()).then(out).catch(fail);
+    });
+
+  program
+    .command("internal-links <contentId>")
+    .description("Inbound and outbound internal links recorded for an article (from the publish-time link graph)")
+    .action((contentId) => api.internalLinks(contentId).then(out).catch(fail));
+
+  program
+    .command("site-pages")
+    .description("List the site pages used for in-article links and Related Reading")
+    .action(() => api.sitePages().then(out).catch(fail));
+
+  program
+    .command("detect-links <url>")
+    .description("Scan a sitemap (nested indexes too) or a blog root page for site pages")
+    .option("--blog-root", "Treat the URL as a page to crawl instead of a sitemap")
+    .action((url, opts) =>
+      api
+        .detectSiteLinks(opts.blogRoot ? "blogroot" : "sitemap", url)
+        .then(out)
+        .catch(fail)
+    );
+
+  program
+    .command("add-pages <urls...>")
+    .description("Add site page URLs for internal linking (dedupes; titles auto-fill)")
+    .action((urls) => api.addSitePages(urls).then(out).catch(fail));
+
+  program
+    .command("repurpose [contentId]")
+    .description("Repurpose queue (published articles + draft chips), or full drafts for one article")
+    .action((contentId) =>
+      (contentId ? api.repurposeDrafts(contentId) : api.repurposeQueue())
+        .then(out)
+        .catch(fail)
+    );
+
+  program
+    .command("repurpose-generate <contentId>")
+    .description("Draft social posts for a published article (dry run unless --confirm; spends LLM budget)")
+    .option(
+      "--platforms <a,b>",
+      "Subset: linkedin,twitter,pinterest,instagram,facebook,threads,youtube,tiktok"
+    )
+    .option("--confirm", "Actually generate")
+    .action((contentId, opts) =>
+      api
+        .repurposeGenerate({
+          contentId,
+          platforms: opts.platforms ? list(opts.platforms) : undefined,
+          confirm: !!opts.confirm,
+        })
+        .then(out)
+        .catch(fail)
+    );
+
+  program
+    .command("repurpose-edit <draftId>")
+    .description("Edit a repurpose draft's text/title before pushing")
+    .option("--body <text>")
+    .option("--title <text>")
+    .action((draftId, opts) =>
+      api
+        .repurposeEditDraft({ draftId, body: opts.body, title: opts.title })
+        .then(out)
+        .catch(fail)
+    );
+
+  program
+    .command("repurpose-mark-posted <draftId>")
+    .description("Mark a draft as posted (you published it yourself)")
+    .action((draftId) => api.repurposeMarkPosted(draftId).then(out).catch(fail));
+
+  program
+    .command("repurpose-channels")
+    .description("Connected Postiz channels (ids needed for repurpose-push)")
+    .action(() => api.repurposeChannels().then(out).catch(fail));
+
+  program
+    .command("repurpose-push <draftId>")
+    .description("Send a draft to Postiz (dry run unless --confirm)")
+    .option("--channels <id1,id2>", "Postiz channel ids (see repurpose-channels)")
+    .option("--when <now|schedule|draft>", "Postiz mode", "now")
+    .option("--date <iso>", "ISO time for --when schedule")
+    .option("--confirm", "Actually push (publicly visible)")
+    .action((draftId, opts) =>
+      api
+        .repurposePush({
+          draftId,
+          integrationIds: opts.channels ? list(opts.channels) : undefined,
+          scheduleType: opts.when,
+          date: opts.date,
+          confirm: !!opts.confirm,
+        })
+        .then(out)
+        .catch(fail)
+    );
+
+  const parseJson = (raw, label) => {
+    try {
+      return JSON.parse(raw.startsWith("@") ? readFileSync(raw.slice(1), "utf8") : raw);
+    } catch {
+      fail(new Error(`--json for ${label} must be valid JSON (or @file.json)`));
+    }
+  };
+
+  program
+    .command("ideas")
+    .description("Scored content-idea backlog: uncovered queries, citation gaps, quick wins")
+    .action(() => api.contentIdeas().then(out).catch(fail));
+
+  program
+    .command("plan-idea <queryText>")
+    .description("Put an idea on the content calendar (uses its stored title, or generates one)")
+    .option("--title <title>", "Exact headline to plan")
+    .action((queryText, opts) =>
+      api.planIdea({ queryText, title: opts.title }).then(out).catch(fail)
+    );
+
+  program
+    .command("archive <contentId>")
+    .description("Archive an article (removes it from the working set)")
+    .action((contentId) => api.archiveContent(contentId).then(out).catch(fail));
+
+  program
+    .command("engagement")
+    .description("Per-page views + citations for the last 30 days, with view sparklines")
+    .action(() => api.pageEngagement().then(out).catch(fail));
+
+  program
+    .command("report")
+    .description("Executive summary: last 30 days vs the 30 before (citations, views, crawls, publishing)")
+    .action(() => api.reportSummary().then(out).catch(fail));
+
+  program
+    .command("wins")
+    .description("Biggest wins of the last 30 days: top cited page, cite-rate jump, ranking climb, best backlink")
+    .action(() => api.reportWins().then(out).catch(fail));
+
+  program
+    .command("agent-activity")
+    .description("Recent runs per agent lane (brand control, radar, forge, deploy, ...)")
+    .option("--per-agent <n>", "Runs per lane, up to 50", "15")
+    .option("--since-days <n>", "Window in days", "30")
+    .action((opts) =>
+      api
+        .agentActivity({ perAgent: Number(opts.perAgent), sinceDays: Number(opts.sinceDays) })
+        .then(out)
+        .catch(fail)
+    );
+
+  program
+    .command("backlinks")
+    .description("The backlink table, newest first")
+    .option("--status <status>", "Filter: discovered, verified, lost, identified, contacted, replied, link_placed, rejected")
+    .action((opts) => api.backlinks(opts.status).then(out).catch(fail));
+
+  program
+    .command("backlink-stats")
+    .description("Backlink totals + the outreach pipeline counts")
+    .action(() => api.backlinkStats().then(out).catch(fail));
+
+  program
+    .command("outreach-status <backlinkId> <status>")
+    .description("Move an outreach prospect through the pipeline (identified|contacted|replied|link_placed|rejected)")
+    .action((backlinkId, status) =>
+      api.outreachStatus(backlinkId, status).then(out).catch(fail)
+    );
+
+  program
+    .command("network")
+    .description("Link Network credit stats, membership state, and hosted/received placements")
+    .action(() => api.linkNetwork().then(out).catch(fail));
+
+  program
+    .command("network-opt-in <on|off>")
+    .description("Join or leave the Link Network (dry run unless --confirm; leaving retires live links)")
+    .option("--confirm", "Actually change membership")
+    .action((state, opts) =>
+      api.linkNetworkOptIn(state === "on", !!opts.confirm).then(out).catch(fail)
+    );
+
+  program
+    .command("network-remove-placement <placementId>")
+    .description("Retire one network placement (dry run unless --confirm; visible on the partner site)")
+    .option("--confirm", "Actually remove it")
+    .action((placementId, opts) =>
+      api.linkNetworkRemovePlacement(placementId, !!opts.confirm).then(out).catch(fail)
+    );
+
+  program
+    .command("social")
+    .description("Social thread prospects (Reddit/X) with rules context and intent sort")
+    .option("--platform <reddit|twitter>")
+    .option("--status <status>")
+    .option("--age <ranked|new>")
+    .action((opts) =>
+      api
+        .socialThreads({ platform: opts.platform, status: opts.status, age: opts.age })
+        .then(out)
+        .catch(fail)
+    );
+
+  program
+    .command("social-stats")
+    .description("Social thread pipeline counts")
+    .action(() => api.socialStats().then(out).catch(fail));
+
+  program
+    .command("social-status <threadId> <status>")
+    .description("Move a social thread through the pipeline")
+    .action((threadId, status) =>
+      api.socialStatus(threadId, status).then(out).catch(fail)
+    );
+
+  program
+    .command("social-draft-reply <threadId>")
+    .description("AI-draft a reply for a thread (nothing posts; the draft lands for review)")
+    .option("--mention <none|natural|founderOpen>", "Brand-mention mode")
+    .action((threadId, opts) =>
+      api.socialDraftReply(threadId, opts.mention).then(out).catch(fail)
+    );
+
+  program
+    .command("support <subject>")
+    .description("Send a message or bug report to RankControl support (emails the team, capped 3/min)")
+    .requiredOption("--message <text>", "What happened — include errors, ids, and steps")
+    .option("--page <url>", "Related dashboard or API URL")
+    .action((subject, opts) =>
+      api.support({ subject, message: opts.message, pageUrl: opts.page }).then(out).catch(fail)
+    );
+
+  program
+    .command("brand")
+    .description("Brand profile, products, and buyer profiles (ICPs) in one read")
+    .action(() => api.brand().then(out).catch(fail));
+
+  program
+    .command("brand-profile-set")
+    .description("Patch brand voice/style fields. --json '{\"tone\":\"...\"}' or --json @file.json")
+    .requiredOption("--json <json>", "Fields: tone, primaryColor, secondaryColor, fontFamily, metaTitle, metaDescription, metaKeywords, defaultLocale, flexibleScheduling")
+    .action((opts) =>
+      api.brandProfileSet(parseJson(opts.json, "brand-profile-set")).then(out).catch(fail)
+    );
+
+  program
+    .command("brand-product")
+    .description("Create, update, or delete a product. Create: name+description+category; update: productId + fields; delete: productId + del:true")
+    .requiredOption("--json <json>", "Product JSON (or @file.json)")
+    .action((opts) =>
+      api.brandProductWrite(parseJson(opts.json, "brand-product")).then(out).catch(fail)
+    );
+
+  program
+    .command("brand-icp")
+    .description("Create, update, or delete a buyer profile. Create: title+industry+demographics; update: profileId + fields; delete: profileId + del:true")
+    .requiredOption("--json <json>", "Buyer profile JSON (or @file.json)")
+    .action((opts) =>
+      api.brandIcpWrite(parseJson(opts.json, "brand-icp")).then(out).catch(fail)
+    );
+
   program.parseAsync(argv);
 }