Sistrix Domain

Sistrix Domain Skill

Fetch and analyze domain-level SEO data from the Sistrix API.

IMPORTANT: Sistrix API credits are limited. Don't fetch more than 100 lines without explicit confirmation by the user!

Quick Start

Single endpoint:

python skills/sistrix-domain/scripts/fetch.py \
  --domain example.com \
  --endpoint overview \
  --country de

Batch fetch (multiple endpoints):

python skills/sistrix-domain/scripts/fetch_all.py \
  --domain example.com \
  --group core \
  --country de

Analyze results:

python skills/sistrix-domain/scripts/analyze.py \
  --input output/sistrix_batch_core_example_com_de.json \
  --csv

Configuration

Requires SISTRIX_API_KEY in a .env file at the repo root:

SISTRIX_API_KEY=your_api_key_here

Available Endpoints

Fetching Single Endpoints

Parameters

Examples

Visibility index with history:

python skills/sistrix-domain/scripts/fetch.py \
  --domain example.com \
  --endpoint visibilityindex \
  --country de \
  --history

SEO competitors:

python skills/sistrix-domain/scripts/fetch.py \
  --domain example.com \
  --endpoint competitors_seo \
  --country de \
  --limit 50

Keyword opportunities:

python skills/sistrix-domain/scripts/fetch.py \
  --domain example.com \
  --endpoint opportunities \
  --country de \
  --limit 100

Batch Fetching

Fetch multiple endpoints efficiently with fetch_all.py.

Endpoint Groups

Examples

Core metrics:

python skills/sistrix-domain/scripts/fetch_all.py \
  --domain example.com \
  --group core \
  --country de

Full domain audit:

python skills/sistrix-domain/scripts/fetch_all.py \
  --domain example.com \
  --group all \
  --country de \
  --limit 100

Specific endpoints:

python skills/sistrix-domain/scripts/fetch_all.py \
  --domain example.com \
  --endpoints "overview,competitors_seo,opportunities" \
  --country de

Analyzing Data

The analyze.py script processes Sistrix data and generates insights.

Analysis Types

• batch - Analyze batch-fetched data (auto-detected)
• visibility - Extract visibility trend data
• competitors - Process competitor list
• urls - Process top URLs
• opportunities - Process keyword opportunities
• distribution - Process ranking distribution
• auto - Auto-detect based on data structure

Examples

Analyze batch data:

python skills/sistrix-domain/scripts/analyze.py \
  --input output/sistrix_batch_core_example_com_de.json \
  --csv

Analyze visibility trend:

python skills/sistrix-domain/scripts/analyze.py \
  --input output/sistrix_visibilityindex_example_com_de.json \
  --type visibility \
  --csv

Output Structure

By default, all files are written under an output/ directory in the current working directory:

output/
├── sistrix_<endpoint>_<domain>_<country>.json  # Raw API responses
├── sistrix_batch_<group>_<domain>_<country>.json  # Batch responses
├── sistrix_analysis_<domain>.json              # Analysis results
├── sistrix_analysis_<domain>_competitors.csv   # CSV exports
└── cache/sistrix/                              # Cached responses (24h)

Country Codes

Sistrix supports: de, at, ch, us, uk, es, fr, it, nl, pl, se, br, be, ie, pt, dk, no, fi, hu, cz, sk, ro, bg, hr, gr, tr, ru, au, jp

Rate Limits and Credits

• Each API call consumes credits (1-10 per endpoint)
• Rate limiting handled automatically with retry logic
• Cache enabled by default (24h) to avoid redundant calls
• Use --no-cache for fresh data when needed

Troubleshooting

"SISTRIX_API_KEY not set":

• Add SISTRIX_API_KEY=your_key to your .env file

"Rate limit exceeded":

• Wait a few minutes and retry
• Use --delay 1.0 in batch mode for slower requests

"Invalid API key":

• Verify your API key is correct
• Check your Sistrix subscription is active

Empty results:

• Domain may not have data in Sistrix for that country
• Try a different country code or more popular domain