IndexForge CLI

Command-line interface for IndexForge — SEO indexing automation.

Submit URLs to Google (Indexing API) and Bing/Yandex (IndexNow), monitor index status, detect 404s, all from your terminal.

Install

npx indexforge          # Run without installing
npm i -g indexforge     # Or install globally

Quick Start

# 1. Login
indexforge login

# 2. Add a domain
indexforge add example.com

# 3. Full pipeline: scan sitemap → submit → check 404s → inspect index status
indexforge full example.com

Commands

Auth

| Command | Description | |---------|-------------| | login | Authenticate (saves API key to ~/.indexforge/config.json) | | logout | Clear saved credentials | | whoami | Show current account and plan |

Overview

| Command | Description | |---------|-------------| | status | Account stats — domains, URLs, indexed, dead | | domains | List all domains | | history | Recent submission history |

Domain Management

| Command | Description | |---------|-------------| | add <domain> | Add a domain (--sitemap <url> optional) | | remove <domain> | Remove a domain (--force to skip confirmation) |

Actions

| Command | Description | |---------|-------------| | scan <domain> | Parse sitemap, discover new URLs | | submit <domain> | Submit pending URLs to Google + IndexNow | | check <domain> | HTTP status check all URLs (find 404s) | | inspect <domain> | Check Google index status via Search Console | | urls <domain> | List URLs (--page N, --limit N) |

Pipelines

| Command | Description | |---------|-------------| | push <domain> | Scan + submit (use after publishing new content) | | full <domain> | Scan + submit + check + inspect (complete pipeline) |

Settings

| Command | Description | |---------|-------------| | credentials <domain> --file <path> | Upload Google service account JSON | | slack <webhook-url> | Set Slack notification webhook | | config | View saved config | | config set <key> <value> | Set config value |

Agent / CI Usage

Every command supports --json for machine-readable output:

# Get stats as JSON
indexforge status --json

# Pipe URL list to jq
indexforge urls example.com --json --limit 500 | jq '.urls[] | select(.indexStatus == "not_indexed") | .url'

# Use API key directly (no login needed)
INDEXFORGE_API_KEY=if_abc123 indexforge push example.com

Environment Variables

| Variable | Description | |----------|-------------| | INDEXFORGE_API_KEY | API key (overrides saved config) | | INDEXFORGE_URL | Server URL (default: https://indexforge.metaltorque.dev) | | NO_COLOR | Disable colored output |

Pricing

| Plan | Price | Domains | URLs/Domain | |------|-------|---------|-------------| | Free | $0 | 1 | 50 | | Starter | $99/yr | 5 | 500 | | Pro | $199/yr | 25 | 5,000 | | Business | $499/yr | 100 | 50,000 |