@rankveo/cli

The rankveo workspace from the terminal: rankings, AI visibility, backlinks, PageSpeed, cleared articles and prompt checks, plus an MCP bridge for agents that only speak stdio.

npx @rankveo/cli login          # paste a full-access key from Settings → API keys
npx @rankveo/cli keywords
npx @rankveo/cli analytics geo
npx @rankveo/cli articles list --json | jq '.articles[].slug'

Or install it: npm i -g @rankveo/cli and use rankveo.

Full-access keys come with Premium and Max. Each key belongs to one website; rankveo login once per website and switch with --workspace example.com. RANKVEO_API_KEY in the environment skips the saved key entirely, for CI.

Commands

| Command | What it does | | --- | --- | | login, logout, whoami, workspaces | Save, forget and inspect keys | | analytics seo\|geo\|backlinks | The latest cached snapshot, freshness first | | keywords | Tracked keywords with positions and ranking URLs | | pagespeed [--refresh] | The PageSpeed report; --refresh measures again | | prompts list, prompts run <id> | AI visibility prompts; a run uses quota | | articles list, articles get <id> [--out f] | Cleared articles, in any CMS format | | articles published <id> --platform p --remote-id r | Record where one went live | | preferences get, preferences set k=v … | How articles are written | | mcp, mcp config | MCP over stdio; or the config for HTTP clients |

Every command takes --json for the API response unchanged.

MCP

The workspace is a remote MCP server at https://api.rankveo.com/api/mcp. Clients that take a URL connect to it directly with the key as a bearer token; rankveo mcp config prints that configuration. For a client that can only launch a local process:

{
  "mcpServers": {
    "rankveo": {
      "command": "npx",
      "args": ["-y", "@rankveo/cli", "mcp"],
      "env": { "RANKVEO_API_KEY": "rk_your_key" }
    }
  }
}

The bridge forwards each JSON-RPC line to the API and writes the reply back; nothing runs locally.

Where the key lives

~/.config/rankveo/config.json (or $XDG_CONFIG_HOME/rankveo/, %APPDATA%\rankveo\ on Windows), written mode 0600. Move it with RANKVEO_CONFIG_PATH. Revoke a key from Settings → API keys and every copy of it stops working at once.