@sitedex/cli

@sitedex/cli

The Sitedex CLI. Run audits, search the index, and pull reports from the terminal. Ships a local MCP server for Claude Code, Cursor, and any MCP client.

Install

npm install -g @sitedex/cli
sitedex login

Or one-off, no install:

npx @sitedex/cli login
npx @sitedex/cli audits create https://example.com

Use with Claude Code / Cursor

// ~/.claude/settings.json
{
  "mcpServers": {
    "sitedex": {
      "command": "npx",
      "args": ["-y", "@sitedex/cli", "mcp"]
    }
  }
}

The local MCP server gives the agent the full surface:

• Public, no sign-in: sitedex_search, sitedex_list_sites, sitedex_get_site, sitedex_list_pages, sitedex_get_page, sitedex_get_visibility_score, sitedex_index_url
• Account, signed in: sitedex_audits_create, sitedex_audits_get, sitedex_audits_list, sitedex_credits_balance, sitedex_whoami
• Sign in from inside the agent: sitedex_login_start, sitedex_login_finish, sitedex_logout

The agent can call sitedex_login_start mid-session — it returns a URL to open. The user clicks Authorize in the browser, the agent calls sitedex_login_finish, and the next tool call picks up the new credentials. No restart.

Sign in

# Default — opens your browser
sitedex login

# Headless / SSH — paste a token
sitedex login --paste

# CI — non-interactive
sitedex login --token=sdx_…

sitedex whoami     # show signed-in account
sitedex logout     # sign out

Manage API keys at app.sitedex.dev/settings/api-keys.

Run audits

sitedex audits create https://example.com           # $5 per audit; first one's free
sitedex audits create https://example.com --force   # always run a new audit
sitedex audits create https://example.com --wait    # wait for the audit to finish

sitedex audits get <audit_id>
sitedex audits list <domain>

$5 per audit. Repeat audits within 24 hours come back free — useful right after a fix when you want to confirm the score moved. Every new account gets one free credit.

Credits

sitedex credits balance      # your wallet
sitedex credits ledger       # recent transactions
sitedex credits add          # open Stripe Checkout for one credit

Sites and search

sitedex sites get <domain>                          # site profile and headline score
sitedex sites list                                  # sites you've claimed
sitedex report <domain>                             # full audit report (per-question, capabilities, protocol)

sitedex search "posthog free tier limits"           # search the index
sitedex search "rate limits" --site=openai.com      # search one site
sitedex page posthog.com /pricing                   # one page as markdown

Pipe mode

sitedex sites get posthog.com --agent
sitedex audits get <id> --agent | jq

--agent returns compact JSON suitable for piping.

Environment overrides

Variable	Default	What it does
SITEDEX_API_URL	https://api.sitedex.dev	Point the CLI at staging or a custom deployment.
SITEDEX_TOKEN	(reads ~/.config/sitedex/credentials.json)	One-shot token. Useful in CI.

What is Sitedex?

The live web index for AI agents. Sitedex crawls public websites, scores how well they answer real buyer questions, and serves the result over MCP, REST, and a CLI.

• Search and read — full markdown of every indexed page, free.
• Audit — see which questions a site answers, which it misses, and what to fix.
• Connect — every tool above also runs as MCP, so agents in Claude Code, Cursor, or anywhere else can call them directly.

Pricing: $5 per audit. Repeat audits within 24 hours are free. Search and public reads are unmetered.

sitedex.dev · docs · GitHub