How to Use the xSeek CLI for SEO and GEO (2026)

The xSeek CLI gives you AI visibility data from your terminal. Track crawlers, find content gaps, analyze pages, and monitor citations — all without opening a browser. It's the fastest way to get GEO data into your workflow.

Most AI visibility tools are web dashboards. You log in, click around, export a CSV. The xSeek CLI skips all of that. You run a command, get JSON or formatted output, and pipe it wherever you need — scripts, Claude Code skills, CI/CD pipelines, Slack bots.

It's built for developers and technical marketers who prefer the terminal. But it's also the backbone of xSeek's Claude Code integration — every skill calls the CLI under the hood.

Installation and Setup

Three commands to get running. Install the binary, authenticate with your API key, and verify.

# Install
curl -fsSL https://cli.xseek.io/install.sh | sh

# Authenticate
xseek login YOUR_API_KEY

# Verify
xseek version
xseek websites

Get your API key at xseek.io/dashboard/api-keys. Credentials are stored in ~/.xseek/config — don't export them as an environment variable.

Every xSeek CLI Command Explained

Each command follows the same pattern: xseek <command> <website> [options]. The website argument accepts domain names (mysite.com) or IDs. Add --format json for machine-readable output.

xseek websites — List Your Tracked Websites

xseek websites --format json

Returns website IDs, URLs, and company names. This is your starting point — grab the website identifier you need for every other command.

xseek opportunities <website> — Find Content Gaps

xseek opportunities mysite.com --format json

Returns: query, frequency, business value (critical/high/medium), competitors with citation counts, and ranking articles that AI models cite. This is where content strategy starts.

xseek web-searches <website> — See What LLMs Search For

xseek web-searches mysite.com --pageSize 100 --format json

Returns the actual search queries that ChatGPT, Claude, Gemini, and Perplexity run when answering questions about your industry. Each query includes the model name and timestamp.

xseek search-queries <website> — GSC Search Queries

xseek search-queries mysite.com --pageSize 100 --sortBy impressions --format json

Returns Google Search Console queries with impressions, position, and pages. Filter by URL with --url.

xseek sources <website> — What AI Models Cite

xseek sources mysite.com --format json

Returns URLs that AI models cite when answering queries in your space, with citation count and percentage.

xseek ai-visits <website> — AI Bot Traffic

xseek ai-visits mysite.com --pageSize 20 --format json

Returns which AI bots (GPTBot, Claude-Web, PerplexityBot, etc.) visited which pages and when. Filter with --search and --bot.

xseek analyze <website> <url> — AEO Copilot Analysis

xseek analyze mysite.com https://mysite.com/blog/article --format json

Returns structural analysis, content recommendations, schema suggestions, and whether the page needs a full rewrite.

xseek prompts <website> — Monitored Prompts

xseek prompts mysite.com --format json

Returns the prompts you're tracking across AI engines — the queries you want your brand to appear in.

xseek leaderboard <website> — Brand Mention Rankings

xseek leaderboard mysite.com --format json

Returns brand rankings by AI mention frequency. See where you stand against competitors across all monitored prompts.

xseek sitemap-pages <website> — All Pages with AI + GSC Data

xseek sitemap-pages mysite.com --format json

Returns every page in your sitemap with combined AI bot visit data and Google Search Console metrics.

xseek search-metrics <website> — Page-Level GSC Metrics

xseek search-metrics mysite.com --format json

Returns page-level Google Search Console metrics — impressions, clicks, CTR, and average position per URL.

Common Workflows

Find What to Write Next

Pull critical content opportunities and filter for the highest-frequency queries your brand doesn't own yet.

xseek opportunities mysite.com --format json | python3 -c "
import json, sys
for o in json.load(sys.stdin)['data']['opportunities']:
    if o['businessValue'] == 'critical':
        print(f\"{o['frequency']:3d}x  {o['query']}\")
"

Check If a Page Is Being Crawled by AI Bots

Before optimizing a page for AI citations, verify that bots are actually reading it.

xseek ai-visits mysite.com --search "/blog/my-article" --format json

See Which Competitor Pages AI Cites for Your Queries

Sources data tells you exactly which URLs AI models reference — yours and your competitors'.

xseek sources mysite.com --format json

Run a Full Page Analysis

Get structural recommendations, schema suggestions, and a rewrite verdict for any page.

xseek analyze mysite.com https://mysite.com/blog/article --format json

Using the CLI with Claude Code

The CLI is designed to work with Claude Code skills. Each skill calls CLI commands to gather data, then Claude processes the results. Here's the typical flow:

1. You type /generate-article in Claude Code
2. The skill runs xseek opportunities to find content gaps
3. Runs xseek web-searches to get LLM query data
4. Runs xseek search-queries for GSC keywords
5. Claude analyzes the data and writes the article

Every skill in the xSeek Claude Code skills repo follows this pattern. The CLI handles data retrieval. Claude handles reasoning and writing. You get a production-ready article without leaving your editor.

Tips

• Always use --format json for machine-readable output
• The website argument accepts domain names (mysite.com) or IDs
• Credentials are stored in ~/.xseek/config — don't export as an env var
• Pipe JSON output to python3 or jq for filtering
• Use --pageSize to control how many results you get back
• Combine commands in shell scripts for repeatable audit workflows

Frequently Asked Questions

How do I install the xSeek CLI?

Run curl -fsSL https://cli.xseek.io/install.sh | sh then xseek login YOUR_API_KEY. Get your API key from the xSeek dashboard.

Does the CLI work without a web dashboard?

Yes. Every feature available in the dashboard is accessible via the CLI. You can run your entire GEO workflow from the terminal.

Can I use the CLI in CI/CD pipelines?

Yes. The CLI outputs JSON with --format json, making it easy to integrate into automated workflows, monitoring scripts, or Slack bots.

What's the difference between the CLI and the API?

The CLI wraps the API in a developer-friendly interface. You can use either — the CLI for quick queries, the API for custom integrations.

Is the CLI free?

The CLI itself is free to install. It requires an xSeek account to access data. Plans start at $99.99/month.