GeoGen CLI

Command-line interface for the GeoGen LLM SEO tracking platform. Query your LLM visibility data, manage entities and prompts, and inspect citations from any terminal.

Install

# Recommended: install globally
npm install -g @geogenio/cli
geogen --help

# One-off (explicit form works on all npx versions)
npx -p @geogenio/cli geogen --help

Requires Node.js 18+.

Authenticate

The fastest way is the browser flow:

geogen login

This opens your browser, you pick a workspace, click "Authorize", and the CLI receives a freshly-minted API key (labeled CLI: <hostname> so you can revoke it later from Settings → API Keys). The key is stored at ~/.geogen/config.json (chmod 600 on POSIX).

For scripts and CI where you can't open a browser:

# Pre-existing key
geogen login --api-key wsk_your_api_key_here

# Or just an env var, no `login` needed
export GEOGEN_API_KEY=wsk_your_api_key_here
geogen workspace

Precedence: --api-key flag > GEOGEN_API_KEY env > config file.

Global flags

| Flag | Description | |---|---| | --json | Print raw JSON instead of formatted tables | | --api-key <key> | Override the API key for this invocation | | --base-url <url> | Override the API base URL (default https://api.geogen.io) |

Examples

# Workspace overview
geogen workspace

# List entities
geogen entities list

# Create a new tracked entity with two prompts
geogen entities create \
  --name "Acme" --domain acme.com \
  --prompt "best CRM for small business" \
  --prompt "alternatives to Salesforce"

# Visibility trend for the last 7 days
geogen trends visibility --entity ent_123 --period 7d

# Top cited domains, JSON output (pipe-friendly)
geogen citations list --entity ent_123 --json | jq '.data[0]'

Run geogen --help for the full command tree, or geogen <group> --help for a specific resource.

Build from source

cd cli
npm install
npm run build
node build/index.js --help