@aiso/cli

Scan any URL for AI-search visibility. Prints a 0–100 score, the top fixes, and a link to a shareable result page.

Install

npx @aiso/cli scan https://example.com

Or globally:

npm install -g @aiso/cli
aiso scan https://example.com

Usage

aiso scan <url>           Scan a URL and print a formatted report
aiso scan <url> --json    Emit JSON for piping
aiso --version            Print the CLI version
aiso --help               Print all commands

Environment variables

• AISO_API_URL — override the API base (default https://aiso.tools).
• AISO_TELEMETRY — set to 0, false, or no to disable anonymous CLI telemetry.

Telemetry

When enabled (the default), the CLI sends a single cli_scan_started event per scan to aiso.tools/api/track. The payload contains only: SHA-256 hash prefix of the URL, CLI version, Node version, platform string. Never the URL itself, never any auth tokens.

Opt out with AISO_TELEMETRY=0.

Public scan attribution

Scans submitted by the CLI are tagged as source=cli with the AISO CLI project name. Completed scans still use the same public result pages and can appear in the recent-scan list on aiso.tools.

JSON output

aiso scan <url> --json returns the main scan payload plus resultUrl. Completed scans can also include scanMode, pagesScanned, history, and rewritePack when those fields are available from the API.

Docs

• Full API: https://aiso.tools/docs/api-reference
• What AISO scores: https://aiso.tools/docs/dimensions
• MCP server: https://aiso.tools/docs/mcp

MIT © AISO