Each local area page used to take us half a day to create and optimize.
With SEOmatic, we can create hundreds of pages in the same time, which helps our clients make the best use of their budget.
It's transformed how we deliver scalable SEO solutions.
Will Hawkins
Marketing Director, Digi-Business UK
Agents read your Search Console data, do the work, and prove what actually moved. You decide what ships.
14-Day Free Trial. $1 card check, refunded. Cancel Anytime.
The seomatic CLI runs with no install via npx. Two commands need no account; the rest use your API key. And with `tools call` it can invoke the full tool surface, the same as REST and MCP. Node 18+, zero dependencies.
| Command | Auth | Description |
|---|---|---|
npx seomatic audit <url> | no account | Agent-readiness + SEO surface check for any URL. |
npx seomatic logs <access.log> | no account | Crawl-budget analysis from a server access log (or - for stdin). |
npx seomatic me | API key | Introspect the key: workspace, scopes, GSC connection. |
npx seomatic gsc top-queries | API key | Top Search Console queries. Flags: --days N, --limit N. |
npx seomatic gsc top-pages | API key | Top Search Console pages. Flags: --days N, --limit N. |
npx seomatic tools | API key | List every tool this key can call (the full surface). --group read|acts to filter. |
npx seomatic tools call <name> | API key | Invoke any tool with --data '{...}'. Proxies POST /v1/tools/{name}, the same surface as REST and MCP. |
| Flag | Meaning |
|---|---|
--json | Machine-readable JSON output (every command). |
--key <key> | API key; or set SEOMATIC_API_KEY. |
--days <n> | Lookback window for gsc commands (default 28). |
--limit <n> | Max rows for gsc commands (default 25). |
--data <json> | JSON argument body for `tools call`. |
--group read|acts | Filter `tools` by read-only vs acting. |
# no account needed
npx seomatic audit https://example.com
npx seomatic logs access.log
# authenticated (env or --key)
export SEOMATIC_API_KEY=smk_live_...
npx seomatic me
npx seomatic gsc top-queries --days 28 --json
# the full tool surface (same as REST / MCP)
npx seomatic tools # list every callable tool
npx seomatic tools call get_search_queries --data '{"days":28}'
npx seomatic tools call create_seo_tasks --data '{"tasks":[...]}'Every command takes --json so a coding agent can shell out and parse the result.