Changelog

Version history and release notes for ZensInk open source and Pro.

v1.4.5 2026-08-23

domain_rating — real Ahrefs DR, free

— New tool: domain_rating queries Ahrefs' free public Domain Rating endpoint — real DR (0-100) for any domain or URL
— Off-page authority was the known gap; kd.py approximated it with curated authority-domain proxies. Now closable at zero cost
— Batch-ready: domains as args, --file, or stdin pipe; local dr-cache.json so reruns never burn the rate limit; CSV/JSON export; URL auto-normalization
— Registered in the CLI dispatcher and MCP server tool list (tools 18 → 19)
— Needs a free AHREFS_APIKEY from app.ahrefs.com → Account settings → API keys; attribution "Domain Rating by Ahrefs" kept in all outputs per the DR License

v1.4.4 2026-08-23

Agent-readiness checks in site_audit

— New check: llms.txt must carry a When-to-use section — without it, agents can't tell which jobs your site fits
— New check: llms.txt needs a how-to-call line (install command / endpoint / MCP entry point)
— Deterministic, zero-dependency, runs inside the existing site_audit flow
— Ships alongside Pro v2.4.0 Agent Readiness Score; the same checklist took zens.ink from 64 to 98/100 on is-agentic.com

v1.4.3 2026-08-15

KD brand-keyword forensics

— kd: brand triple-fingerprint (official domain in top3 / domain-family seats / platform-ecosystem density) — brand keywords no longer poison generic KD
— kd_entry: derivative-entry difficulty recomputed on contestable seats only
— KD→referring-domains link budget curve (editorial vs directory tracks)
— --markdown self-contained report mode; deeper competitor_gap sitemap parsing

v1.4.3 2026-08-15

Rank Tracker — SQLite position history

— New: rank_tracker — track your domain's Google positions for a keyword set, snapshot every check into SQLite (~/.zens_ink/ranks.db), watch trends over time
— Actions: add / check / status / trend / history / remove; SERP depth configurable (--num), one Serper call per keyword per check
— Registered as MCP tool rank_tracker
— Tools 16 → 17

v1.4.2 2026-08-14

MCP Server — native tools for DSH / Claude / Codex

— New: python3 -m zens_ink.mcp runs the whole toolkit as an MCP stdio server — all tools become native model tools (mcp__zensink__keyword_research, mcp__zensink__kd, ...)
— Works with DeepSeek Harness (DSH), Claude Desktop, Codex and any MCP client — tell your agent what you need in plain language, it calls the tools
— New: serp_intent — reverse-engineer search intent from the actual Google SERP composition (page-type weighting + SERP features), cross-validates with keyword-based search_intent
— Pure stdlib, zero new dependencies; API keys still read from .env
— Pro auto-discovery: if zens_ink_pro is installed on the same machine, its 7 tools (winability, content_radar, competitor_radar, geo_score, geo_visibility, gap_deep, full_audit) join the same MCP server automatically — OSS installs stay OSS-only
— Tools 15 → 16

v1.4.1 2026-08-06

GEO Fan-out + Reddit Blue Ocean

— New: geo_fanout — reverse-engineer AI search Query Fan-out into 7 intent dimensions (ICP/Pricing/Features/Competitors/Objections/Education) with gold mine scoring and pillar/cluster content plan
— New: reddit_blueocean — discover high-traffic low-competition Reddit posts via Google demand layer + Reddit API layer, with commercial intent classification
— site_audit: 3 new checks — staging subdomain leak detection, sitemap URL inventory, JSON-LD schema field validation (9 Schema.org types with nested field checks)
— site_audit: fixed html lang regex bug causing false positives
— Version 1.3.0 → 1.4.1, Tools 13 → 15

v1.3.0 2026-07-20

site_audit: GEO + i18n + 30 checks

— site_audit expanded from ~20 to 30 checks: llms.txt presence, FAQ schema, BLUF detection, hreflang i18n, commercial schema (Product/Offer/Service), content structure analysis, crawl-blocking JS, page size
— GEO readiness: llms.txt check, FAQ/BLUF content signal detection
— i18n: hreflang tag validation
— Performance: page size + crawl-blocking CSS/JS detection

v1.2.0 2026-07-17

8 → 13 Tools

— 5 new free tools: keyword_cluster, search_intent, kgr_auto, content_matrix, onpage_audit
— keyword_cluster: semantic grouping of raw keywords into topic clusters
— search_intent: classifies keywords as informational / commercial / transactional / navigational with question/buyer flags
— kgr_auto: automated KGR opportunity scoring (competition vs search volume)
— content_matrix: combines clustering + intent + KGR into a prioritized content plan
— onpage_audit: 7-dimension quality scoring per page (0-100 with fix suggestions)
— All new tools are pure Python stdlib — zero dependencies, zero API keys required

v1.0.0 2026-06-25

Initial release

— 8 free CLI tools: keyword_research, keyword_volume, kd, brave_volume, search_performance, competitor_gap, site_audit, setup_gsc
— Zero Python dependencies — stdlib only
— Bilingual site (EN/ZH) with path-based i18n

v2.4.1 2026-08-23

Security hardening + bundled toolkit v1.4.5

— Bundled OSS toolkit upgraded to v1.4.5 — new domain_rating tool: real Ahrefs Domain Rating via the free public API (batch, cache, CSV/JSON)
— Security fix: the package no longer ships a .env file or .wrangler cache — create your own from scripts/.env.example
— Download pipeline now strips .env/.wrangler at serve time as defense in depth

v2.4.0 2026-08-23

Agent Readiness Score — can AI agents use your site?

— New tool: agent_readiness — 8 deterministic checks (agent-friendly 404s, OpenAPI spec quality, JSON error responses, markdown negotiation, developer discoverability, llms.txt agent instructions, trust anchors, CLI/MCP surface)
— 0-100 score with letter grade and P0/P1/P2 fix plan; verify against the public scorer with npx is-agentic
— OSS site_audit adds agent-readiness checks: llms.txt must carry a when-to-use section and a how-to-call line
— Benchmark: this checklist took zens.ink from 64 to 98/100 on is-agentic.com
— Bundle = zens_ink v1.4.4 + zens_ink_pro v2.4.0

v2.3.0 2026-08-22

KD upgrade — brand-keyword forensics

— Bundled OSS kd.py upgraded (v1.4.3 release): brand-keyword triple-fingerprint detection (official domain in top3 / domain-family seats / platform-ecosystem density), derivative-entry difficulty (kd_entry) recomputed on contestable seats only, KD→referring-domains link budget curve, --markdown self-contained report
— Bundle = zens_ink v1.4.3 + zens_ink_pro v2.3.0

v2.2.1 2026-08-15

Fixes: dynamic version stamp + sitemap auto-discovery

— full_audit report now stamps the real Pro version dynamically (was frozen at v1.3.2)
— fetch_sitemap: bare domains and site roots now auto-discover sitemaps via robots.txt + common paths (sitemap.xml / sitemap_index.xml / sitemap-index.xml), with graceful fallback
— Note: slowmist.io genuinely exposes no sitemap — reported honestly as not found

v2.2.0 2026-08-15

AI Share of Voice + Agent Workflows

— New: ai_sov — AI-era SERP module detection per keyword (AI Overview when returned, Featured Snippet, People Also Ask, Knowledge Graph) + brand/competitor presence in each module and organic → your SoV% across the keyword set
— Zero LLM cost — pure SERP analysis via Serper; brand matching by name-in-text or domain-in-links
— New: WORKFLOWS.md — 6 agent workflow recipes (new-site plan, rank a keyword, AI visibility audit, competitor teardown, publish-and-track, full audit), MCP-ready prompts
— Same release ships OSS rank_tracker (v1.4.3); bundle = zens_ink v1.4.3 + zens_ink_pro v2.2.0, Pro tools 8 → 9

v2.1.0 2026-08-15

Content Briefs — keyword to ready-to-write article skeleton

— New: content_briefs — one keyword in, a complete brief out: intent + page type, 5 title candidates, H2 outline built from what actually ranks (live SERP theme analysis), entities, People-Also-Ask questions, long-tail bank, word count target, GEO checklist
— With SERPER_API_KEY the brief uses the live SERP; without a key it falls back to Google Autocomplete — zero API cost
— --deep fetches top ranking pages for a SERP-informed word count (p25, capped)
— Chinese mode: --zh (formulas, heuristics, checklist)
— Outputs: markdown + self-contained HTML + JSON
— Registered as MCP tool content_briefs — 8 Pro tools now auto-discovered
— Pro 2.0.0 → 2.1.0, tools 7 → 8

v1.4.0 2026-07-13

Search Intent + On-Page Audit

— search_intent integrated into full_audit pipeline — every keyword classified with question/buyer/problem flags
— onpage_audit: 7-dimension quality scoring (title/meta/headings/images/links/url/content) on built HTML, 0-100 per page
— full_audit now orchestrates 12 steps end-to-end (was 10)

v1.3.1 2026-06-26

Full audit orchestrator + Winability + GEO multi-model

— full_audit runs all 9 steps end-to-end — moat features auto-skip if API keys not configured
— Winability: real period-over-period GSC momentum tracking + optional --backlinks flag
— GEO Visibility: multi-model querying — compare brand visibility across multiple LLMs in one report
— Content Radar: SERP-aware title variation (angle adapts to competition structure)
— Competitor Radar: resilient parsing + context-aware pricing extraction

v1.1.0 2026-06-25

Pro workflow engine launch

— Repositioned from per-issue data package to reusable workflow engine
— 5 automation scripts: keyword_cluster, kgr_auto, content_matrix, gap_deep, full_audit
— Agent skill file (SKILL.md) for AI-driven pipeline
— Early bird pricing: $39 (was $59)