Outrank CLI

Agent-first CLI for the Outrank agent API, with a built-in MCP server for Claude Code, Cursor and other MCP clients.

Install

Requires Node.js 18+. Works on macOS, Linux, and Windows.

npm install -g outrank-cli
outrank-cli --help

Get an API key

1. Sign in to your Outrank account at https://www.outrank.so.
2. Open Settings → API keys: https://www.outrank.so/dashboard/settings/api-keys.
3. Click Create key, give it a name, and copy the outr_live_... value. The key is shown only once — store it somewhere safe.
4. Revoke a key from the same page if it ever leaks. Generate a fresh one and re-run auth login.

You can also rotate keys at any time; each key is independent and can be revoked without affecting the others.

Current scope

This repo currently targets the agent endpoints that already exist in outrank:

• mcp (the stdio MCP server that exposes the commands below as tools, see MCP server)
• auth login|whoami|status|profiles|logout
• products list|get|create|update|pause|resume
• products integrations providers|prepare|connect|poll|validate|list|create|get|update|test|delete
• products integrations notion databases|schema
• products integrations framer collections|fields
• products integrations webflow sites|collections|fields|items
• products output-settings get|update for product article settings
• products target-audiences list|replace
• products competitors list|replace
• products gsc status|connect|poll|reconnect|disconnect|accounts|properties|set-property|performance|search-analytics|inspect-url|cannibalization
• products linking sources get|update
• products linking detect
• products linking target-config get|update
• products linking targets list|add-manual|upsert|clear-customizations|delete
• products backlinks get|update|credits|earned|unverified|check-removal|reverify|subscription|subscribe-quote
• keywords list|get|export|generation-status|add|update|suggest|generate|bulk-reschedule|delete|bulk-delete
• articles list|create|get|get-content|update|update-content|replace|bulk-replace|upload-image|upload-featured-image|publish|sync|retry-publish|delete|precreate|generate
• products blog ... for a hosted Outrank Blog: posts list|create|get|update|delete|get-content|update-content|publish|unpublish|sync, design get|patch|update|publish|discard, settings, pages, categories, authors, domain, redirects, snippets, subscribers, webhooks, preview and analytics
• improvements settings get|update
• improvements analyze
• 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
• ai-cited-lists status|overview|lists|outreach|offers|wins|questions|settings|mailbox|top-up-consent|entry|setup|citations for AI-Cited Lists (Backlinks Enterprise)
• free-tools status|keywords|create|list|get|history|edit|preview|publish|discard|rollback|attachments for the Free Tools Builder
• subscription status
• usage stats
• billing portal-url
• billing purchase-products quote|buy

The broader roadmap from the internal implementation plan is larger than the live backend surface. This CLI is structured so new groups can be added cleanly as the server catches up.

Auth

The CLI reads credentials in this order of precedence:

1. --api-key <key> and --base-url <url> on the command line (highest priority, per-call)
2. A profile selected with --profile <name> or OUTRANK_PROFILE. A selected profile is used as-is: OUTRANK_API_KEY and OUTRANK_BASE_URL are ignore

... View full README on GitHub