Credentials

Configure local credentials for integrations

Local Storage

Credentials are stored locally in ~/.suparank/credentials.json and never leave your machine.

Interactive Setup (Recommended)

The easiest way to configure credentials is with the interactive wizard:

npx suparank secrets

This guides you through setting up:

Image generation (fal.ai, Gemini, Wiro)
WordPress publishing
Ghost publishing
Webhooks (Make, n8n, Zapier, Slack)
External MCPs

Manual Configuration

You can also edit ~/.suparank/credentials.json directly:

~/.suparank/credentials.jsonjson

{
  "wordpress": {
    "site_url": "https://your-site.com",
    "secret_key": "your-plugin-key"
  },
  "ghost": {
    "api_url": "https://your-ghost-site.com",
    "admin_api_key": "id:secret"
  },
  "image_provider": "fal",
  "fal": {
    "api_key": "your-fal-key"
  },
  "gemini": {
    "api_key": "your-gemini-key"
  },
  "wiro": {
    "api_key": "your-wiro-key",
    "api_secret": "your-wiro-secret"
  },
  "webhooks": {
    "make_url": "https://hook.make.com/xxx",
    "slack_url": "https://hooks.slack.com/services/xxx"
  }
}

Credential Types

WordPress

Secret key from the Suparank WordPress plugin

Ghost

Admin API key in id:secret format (24 char ID + 64 char hex secret)

Image Provider

Set image_provider to: fal, gemini, or wiro

Webhooks

URLs for Make, n8n, Zapier, Slack

Security

Credentials are stored locally only
Never transmitted to Suparank servers
Add to .gitignore if in a project directory