audits-run

Command line client for Audits.

npm install -g audits-run
audits login
audits commands --search "programmatic SEO"
audits command performance.pseo
audits run performance.pseo --payload '{"projectId":"<id>","days":90}' --wait --json
audits command monitoring.index_plan
audits run monitoring.index_plan --payload '{"projectId":"<id>"}' --wait --json
audits run monitoring.index_watch --payload '{"projectId":"<id>","inspectionLimit":25}' --wait --json
audits api-keys
audits report --project <id> --wait

The CLI signs in to Audits, connects to your account, and runs commands through the same hosted command surface used by the API and remote MCP server. It is a hosted API client only, not the local crawler or core analysis engine.

Use plural audits commands --search "<goal>" to find the targeted command first. Use singular audits command <id> to inspect one command's inputs. audits report is the broad crawl-backed report. For index monitoring, run monitoring.index_plan before monitoring.index_watch; the plan does not spend Google URL Inspection quota, while watch uses tracked quota and saved snapshots.

API keys are managed through hosted commands too:

audits api-keys create --name "MCP token"
audits api-keys revoke <token-id>

Set AUDITS_API_URL for local development:

AUDITS_API_URL=http://localhost:4330 audits commands