@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