Pro Engine · ZensInk

Install the Pro engine and run a full SEO audit in one command — keywords, intent classification, on-page scoring, difficulty, editorial calendar, competitive intel, and AI visibility.

This is a Pro feature — The Pro engine is a paid add-on. The free open-source toolkit covers individual SEO tasks; the Pro engine orchestrates them into a single end-to-end pipeline with four features no other tool offers.

What the Pro Engine Does

The free toolkit gives you individual tools. The Pro engine chains them together and adds four capabilities that don’t exist elsewhere:

Discover → Cluster → Intent → Score → On-Page → Winability → Content Radar → Competitor Radar → GEO Visibility

Four moat features:

Winability Score — Generic KD says “difficulty 45.” Winability pulls your actual Google Search Console data and says “you specifically can rank for this in 3 months.” Different score for every domain.
Content Radar — Turns keyword data into a weekly editorial calendar: “Week 1, write these 2 articles, here’s the title and the angle competitors are missing.”
Competitor Radar — Discovers competitors across web and social media, extracts their pricing and features, surfaces real user sentiment from Reddit.
GEO Visibility — Does ChatGPT mention your brand when users ask for recommendations in your category? Queries LLM APIs to find out.

Two new analysis modules (v1.4.0):

Search Intent — Classifies every keyword as informational / commercial / transactional / navigational, with question/buyer/problem flags. Tells you whether to write a blog post, build a landing page, or create a comparison table.
On-Page Audit — Scores every page on your site across 7 dimensions (title, meta, headings, images, links, URL, content), 0–100 with grade and fix suggestions. Goes beyond “is there an H1?” to “is your title too long, is your meta duplicated, are your images missing alt?”

Installation

The Pro engine requires the free toolkit as a dependency.

Get the Pro package

After purchasing, you’ll receive a license key. Enter it at zens.ink/unlock to verify and download the ZIP.

Extract it:

unzip zens-ink-pro-v1.4.0.zip
cd zens-ink-pro

Install the free toolkit

pip install zens-ink

Or clone from source:

git clone https://github.com/respectevery01/zens-ink-seo-package.git

Configure API keys (optional)

Each key enables specific features. Without them, the pipeline runs but skips the relevant steps gracefully.

Create a .env file in the Pro directory:

# Search volume (free: Bing Webmaster Tools)
BING_API_KEY=your_key

# SERP-based keyword difficulty (free: 2500/mo Serper.dev)
SERPER_API_KEY=your_key

# Competitor Radar intelligence
ANYSEARCH_API_KEY=your_key

# GEO Visibility AI mention tracking
LLM_API_KEY=your_key

# Google Search Console (for Winability)
# Requires Google ADC credentials at:
# ~/.config/gcloud/application_default_credentials.json

Zero keys

Keyword discovery + clustering

Bing + Serper

Add volume + difficulty scoring

All keys

Full pipeline including Radar + GEO

Quick Start: Full Audit

The easiest way to use the Pro engine is the full_audit command — it runs all 12 steps in sequence from a single config file.

Create a config file

Copy the example and edit it:

cp assets/audit-config.example.json audit.json

{
  "site_url": "https://yoursite.com",
  "seed_keywords": ["your keyword", "another keyword"],
  "competitors": ["https://competitor.com/sitemap.xml"],
  "lang": "en",
  "country": "us",
  "expand": false,
  "output_dir": "./audit-output"
}

Run the audit

python3 -m zens_ink_pro.full_audit --config audit.json

This runs all 12 steps: technical site audit → keyword discovery → clustering → search intent classification → scoring → competitor analysis → priority matrix → on-page quality audit → Winability → Content Radar → Competitor Radar → GEO Visibility.

Read the report

Two files are generated:

audit-output/audit-report.md — Full consolidated markdown report
audit-output/audit-report.html — Self-contained HTML, printable to PDF

Open the HTML in a browser for a formatted view with all sections: keyword clusters, opportunity scores, Winability GO/CAUTION lists, editorial calendar, competitive intelligence, and GEO visibility.

Individual Commands

Prefer to run steps separately? Every feature works standalone:

# Search Intent — what type of page should this be?
python3 -m zens_ink_pro.search_intent --file keywords.txt

# On-Page Audit — score every page 0-100
python3 -m zens_ink_pro.onpage_audit --dist dist --sitemap dist/sitemap.xml

# Winability — can YOUR domain rank for this?
python3 -m zens_ink_pro.winability "your keyword"

# Content Radar — what to write next
python3 -m zens_ink_pro.content_radar \
  --kd kd-cache.json --winability wa-results.json --weeks 4

# Competitor Radar — full competitive landscape
python3 -m zens_ink_pro.competitor_radar \
  --niche "your niche" \
  --queries "related query 1" "related query 2" \
  --social-keywords "your niche" \
  -o competitor-report.md

# GEO Visibility — does AI mention your brand?
python3 -m zens_ink_pro.geo_visibility \
  --brand "YourBrand" \
  --category "your category" \
  --competitors "Comp1,Comp2,Comp3" \
  --report geo-report.md

Score my built site's on-page SEO — what needs fixing?

Classify these keywords by search intent: keyword1, keyword2, keyword3

One-Liner Prompts

In Claude Code, Cursor, or any AI agent with file access — one sentence is enough. The agent reads the included SKILL.md and figures out the rest:

Audit my site yoursite.com, keywords: keyword1, keyword2, competitors: competitor1.com, competitor2.com

Can my domain yoursite.com rank for "best ai tools"?

Plan my content for the next 4 weeks based on the audit results

Find my competitors in "AI productivity tools" and what they charge

Does ChatGPT mention MyBrand when people ask about AI productivity tools?

Detailed Prompts

Need more control? Copy-paste a detailed prompt and fill in your details:

Full audit

I have the zens-ink-pro package in this directory. Run a full SEO audit for my site.

Site: https://yoursite.com
Seed keywords: keyword1, keyword2, keyword3
Competitors: https://competitor1.com/sitemap.xml, https://competitor2.com/sitemap.xml
Language: en
Country: us

Generate the config file, run full_audit, then summarize the report.
Highlight the top GO opportunities and the Week 1 editorial plan.

Can I rank for this?

Run a Winability check for these keywords on my domain:

- keyword one
- keyword two
- keyword three

My GSC credentials are configured. For each keyword, tell me:
the verdict (GO/CAUTION/WAIT/AVOID), the timeframe, and why.

What to write next

Based on the KD cache and Winability results in ./audit-output/,
run Content Radar for the next 4 weeks.

For each article suggestion, tell me the title, the angle,
and what competitors are missing.

Competitor landscape

Run Competitor Radar for my niche: AI productivity tools

Search queries: "best AI productivity tool", "AI task manager", "free AI assistant"
Social keywords: "AI productivity app", "AI tool review"

Tell me: who are the main competitors, what they charge,
and what users on Reddit say about them.

Does AI mention my brand?

Run GEO Visibility for my brand.

Brand: MyBrand
Category: AI productivity tools
Competitors: Comp1, Comp2, Comp3

Tell me: which AI assistants mention me, which don't,
and where I rank compared to competitors.

Tips

No GSC yet? Use --no-gsc with Winability to simulate a new domain — useful for planning before launch
Chinese sites: Set lang: "zh" and country: "cn" in the config
On-page audit: Add dist_dir pointing to your built static files (Astro dist/, Next.js out/, etc.) to enable both technical checks and on-page quality scoring
On-page with keywords: Pass --keywords keywords.txt to onpage_audit to check if target keywords appear in titles, H1s, and first paragraphs
Re-run periodically: Keyword opportunities shift; a monthly audit tracks changing landscapes
Reports: Both MD and HTML are generated automatically — MD for developers, HTML for non-technical stakeholders

Agent Skills standard — The Pro package includes a SKILL.md that AI agents (Claude Code, Cursor, Windsurf) read automatically. The prompts above work out of the box — just fill in your site and keywords.