zens.ink

SEO Toolkit for Indie Builders

CLI tools for keyword research, competitor analysis, and technical audits. Zero dependencies, pure Python.

English · 中文

---

Eight CLI tools that cover the full SEO workflow — from discovering what people search, to analyzing competitors, to auditing your own site. No paid APIs. No Ahrefs. No subscriptions. Just free data sources wired together with Python.

Tool	What it does	API needed
keyword_research	Discover long-tail keywords via Google Autocomplete	None
keyword_volume	Real search volume via Bing Webmaster API	Free Bing key
kd	Keyword difficulty score via SERP structure analysis	Free Serper key
brave_volume	Cross-check search demand via Brave SERP signals	Free Brave key
search_performance	Your site's real Google ranking data (GSC)	Free GSC OAuth
competitor_gap	Compare multiple competitor sitemaps, find content gaps	None
site_audit	Technical SEO audit: broken links, orphan pages, missing canonical/meta/H1	None
setup_gsc	One-time OAuth setup for Google Search Console	—

Why

Ahrefs costs $200/month. SEMrush costs $130/month. For indie builders who just need to find keywords worth writing about, that's overkill.

zens.ink wires together free public data sources — Google Autocomplete, Bing Webmaster Tools, Google Search Console, Brave Search — with zero Python dependencies.

Install

Option A — pip (recommended)

pip install git+https://github.com/respectevery01/zens-ink-seo-package.git

After install, the zens-ink command is available globally:

zens-ink --help

Option B — git clone

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

Quick Start

# Discover keywords (with a-z long-tail expansion)
zens-ink keyword_research "tarot" --expand

# Check real search volume
zens-ink keyword_volume "tarot reading" --country us

# Keyword difficulty (SERP-based, with Chinese mode)
zens-ink kd "塔罗牌" --zh

# Compare 3 competitors at once
zens-ink competitor_gap \
  --url https://yoursite.com/sitemap.xml \
  --compare https://competitor-a.com/sitemap.xml https://competitor-b.com/sitemap.xml

# Audit your build for SEO issues
zens-ink site_audit --dist dist --sitemap dist/sitemap.xml

# Check your own Google search performance
zens-ink search_performance

python3 -m zens_ink.keyword_research "tarot" --expand
python3 -m zens_ink.kd "tarot reading"
python3 -m zens_ink.site_audit --dist dist --sitemap dist/sitemap.xml

Use as Agent Skill

ZensInk works as an AI agent skill — let your AI assistant run SEO tools for you in plain language.

# Install for ClawHub / OpenClaw / Hermes compatible agents
npx skills add respectevery01/zens-ink-seo-package --skill zens-ink

Then just tell your AI: "find keywords for my tarot site" and it runs the tools for you. See SKILL.md for details.

Typical Workflow

keyword_research  →  find what people actually search
        ↓
keyword_volume    →  filter by real demand
        ↓
kd                →  pick keywords you can actually rank for
        ↓
competitor_gap    →  see what competitors already cover
        ↓
site_audit        →  make sure your pages are crawlable

Requirements

• Python 3.10+
• Zero dependencies — pure standard library
• Optional API keys (Bing, Serper, Brave, GSC) in .env — see .env.example

Documentation

• Full docs & case studies: zens.ink/docs
• Pro package (automated full-audit pipeline, HTML reports, GEO score): zens.ink

License

MIT — free for personal and commercial use.

---

Made by Jask