CLI - Genseo

The Genseo CLI is distributed as the public npm package @genseo/cli. It uses the same project-bound access model as the Public API.

Install

Install globally when you want the genseo command available everywhere:

npm install -g @genseo/cli

Or run without a global install:

npx -y --package @genseo/cli genseo login

Use npx for quick tests, CI jobs, or machines where you do not want a global package. Use global install for everyday local use. Browser-based login uses OAuth Device Flow:

genseo login

The CLI prints a URL like this:

https://app.genseo.co/developer/device?user_code=ABCD-1234

Open it, choose the project, and approve access. The CLI stores the returned project-bound key in:

~/.genseo/config.json

Manual API-key login is also supported:

genseo login --api-key gs_live_...

You can also use environment variables:

export GENSEO_API_BASE=https://api.genseo.co/v1
export GENSEO_API_KEY=gs_live_...

Logout

genseo logout

Identity

genseo me

Use this after login to confirm which project the CLI can access.

Project

genseo project get

The CLI intentionally works with one authorized project at a time. It does not list all projects and it does not create projects.

Keywords

genseo keywords list

genseo keywords add "seo automation software"

genseo keywords add "seo automation software" --volume 1200 --kd 34 --intent commercial

genseo keywords generate

genseo keywords metrics "seo automation software"

Posts

genseo posts list

genseo posts create --title "SEO Automation Workflow"

genseo posts create --title "SEO Automation Workflow" --keyword-id keyword_123

genseo posts get post_123

genseo posts update post_123 --title "Updated title" --status draft

genseo posts generate post_123

genseo posts publish post_123

Publishing requires a configured integration. Ask the user before publishing unless autonomous publishing is explicitly enabled.

Integrations

genseo integrations list

genseo integrations fields webflow

genseo integrations connect-url webflow

genseo integrations mapping webflow   --connection-id connection_123   --site-id site_123   --collection-id collection_123   --field-map-json '{"title":"name","content":"body"}'

Webhooks

genseo webhooks list

genseo webhooks create --target-url https://example.com/hook --event post.published

genseo webhooks delete webhook_123

Output

Most commands return JSON. Async generation commands may return accepted responses while work continues in Genseo.

​Install

​Login

​Logout

​Identity

​Project

​Keywords

​Posts

​Integrations

​Webhooks

​Output