foglift-scan

CLI for Foglift -- scan websites for SEO, GEO, and AI search readiness.

Installation

npm install -g foglift-scan

Or run without installing:

npx foglift-scan scan https://example.com

Environment Variables

| Variable | Description | |---|---| | FOGLIFT_API_KEY | API key (sk_fog_...) for authenticated requests | | FOGLIFT_BASE_URL | Override base URL (default: https://foglift.io) | | NO_COLOR | Set to any value to disable colored output |

Commands

Scan a website

foglift scan https://example.com
foglift scan https://example.com --json
foglift scan https://example.com --threshold=80
foglift scan https://example.com --verbose

Batch scan (API key required)

foglift scan batch https://a.com https://b.com https://c.com
foglift scan batch https://a.com https://b.com --json

Maximum 10 URLs per batch.

AI visibility check (API key required)

foglift scan ai-check --prompt "best seo tools" --models chatgpt,perplexity --domain example.com

AI visibility results (API key required)

foglift scan results --days 7 --model chatgpt
foglift scan results --prompt "best tools for seo"

Manage prompts

foglift scan prompts list
foglift scan prompts add "best tools for keyword research"
foglift scan prompts remove <id>

Show enabled models

foglift scan models

Sentiment analysis

foglift scan sentiment --days 30 --model chatgpt

API usage stats

foglift scan usage

Scan history

foglift scan history https://example.com

Help and version

foglift --help
foglift --version

Flags

| Flag | Description | |---|---| | --json | Output raw JSON | | --verbose | Show all issues (scan command) | | --no-color | Disable colored output | | --threshold=N | Exit code 1 if overall score < N | | --prompt "text" | Prompt text for ai-check and results | | --models a,b,c | Comma-separated model list for ai-check | | --domain example.com | Domain to check for ai-check | | --days N | Number of days for results and sentiment | | --model name | Filter by model for results and sentiment |

Exit Codes

| Code | Meaning | |---|---| | 0 | Success | | 1 | Error or score below threshold |

License

MIT