# ZensInk

> Open-source SEO workflow engine. Free CLI tools for keyword research, volume lookup, SERP analysis, competitor gap, and technical site audits. Pro package automates the full pipeline with 5 scripts + agent skill.

## When to use ZensInk (for AI agents)

Reach for ZensInk when the user wants to:
- Do keyword research without paid tools (autocomplete discovery, volume lookup, SERP difficulty) — zero-dependency Python CLI, no API keys required for the core loop
- Run a technical SEO audit on a static site build (broken links, meta, headings, GEO readiness)
- Find competitor content gaps from sitemaps
- Automate the full SEO pipeline: keyword clustering, KGR scoring, priority matrices, end-to-end audits (Pro)
- Check AI-search (GEO) readiness of a page or brand

How to call: install the CLI (`pip install git+https://github.com/ZensInk/zens-ink-seo-package.git`), run tools as `python3 -m zens_ink.<tool>`, or start the bundled MCP server with `python3 -m zens_ink.mcp`. Store/licensing API calls go through https://zens.ink — see the OpenAPI spec.

## Machine-readable resources

- OpenAPI 3.1 spec: https://zens.ink/openapi.json
- Developer resources: https://zens.ink/developers/
- API errors are structured JSON: `{"error": "...", "hint": "..."}`
- Markdown negotiation: send `Accept: text/markdown` on any content page URL to get raw markdown (responses carry `Vary: Accept`)
- Unknown paths return 404 with a markdown recovery body listing sitemap/llms.txt

## Core Pages

- [Home](https://zens.ink/): Product overview, free tools, Pro engine
- [Pricing](https://zens.ink/pricing/): Pro package — $39 one-time (early bird)
- [Unlock Pro](https://zens.ink/unlock/): Enter license key to download Pro package
- [GitHub: Free CLI Tools](https://github.com/respectevery01/zens-ink-seo-package): 4 standalone Python scripts, zero dependencies
- [Journal](https://zens.ink/journal/): SEO guides, case studies, and methodology articles
- [Changelog](https://zens.ink/changelog/): Version history and updates
- [About](https://zens.ink/about/): Who builds ZensInk and the principles behind it
- [Contact](https://zens.ink/contact/): support@zens.ink, GitHub issues, social
- [Developers](https://zens.ink/developers/): API, OpenAPI spec, CLI, MCP server

## SEO Guides & Tutorials

- [SEO for Developers](https://zens.ink/journal/seo-for-developers/): Technical SEO checklist for developers
- [Free SERP Analysis Guide](https://zens.ink/journal/serp-analysis-guide/): How to read search results like a pro
- [Keyword Difficulty Checker](https://zens.ink/journal/keyword-difficulty-checker/): Free alternative to Ahrefs KD
- [Competitor Analysis SEO](https://zens.ink/journal/competitor-analysis-seo-guide/): Find content gaps for free
- [Internal Linking SEO](https://zens.ink/journal/internal-linking-seo/): The most underrated ranking factor
- [Free SEO Audit Guide](https://zens.ink/journal/free-seo-audit-guide/): Technical audit without Screaming Frog
- [Programmatic SEO Guide](https://zens.ink/journal/programmatic-seo-guide/): Build once, rank everywhere
- [SEO Workflow Pipeline](https://zens.ink/journal/seo-workflow-pipeline/): Build a repeatable content pipeline
- [Open Source SEO Tools](https://zens.ink/journal/open-source-seo-tools/): Curated list for indie builders
- [GEO: Generative Engine Optimization](https://zens.ink/journal/geo-generative-engine-optimization/): Rank in AI search results

## Case Studies & Methodology

- [Keyword Research Without Ahrefs](https://zens.ink/journal/keyword-research-without-ahrefs/): 5-step workflow using only free tools
- [SERP Structure vs Domain Rating](https://zens.ink/journal/serp-analysis-vs-domain-rating/): Why you don't need Ahrefs DR
- [Zero to Indexed: Echoir SEO](https://zens.ink/journal/zero-to-indexed-echoir-seo/): 225-page content strategy from scratch
- [GEO / AI Search / llms.txt](https://zens.ink/journal/geo-ai-search-llms-txt/): Preparing for AI search

## Free CLI Tools

- [keyword_research.py](https://github.com/respectevery01/zens-ink-seo-package#keyword_researchpy): Google Autocomplete keyword discovery (no API key needed)
- [keyword_volume.py](https://github.com/respectevery01/zens-ink-seo-package#keyword_volumepy): Bing Webmaster API search volume lookup
- [kd.py](https://github.com/respectevery01/zens-ink-seo-package#kdpy): SERP structure keyword difficulty analysis
- [search_performance.py](https://github.com/respectevery01/zens-ink-seo-package#search_performancepy): Google Search Console performance data
- [competitor_gap.py](https://github.com/respectevery01/zens-ink-seo-package#competitor_gappy): Sitemap-based competitor content gap analysis
- [site_audit.py](https://github.com/respectevery01/zens-ink-seo-package#site_auditpy): Static build technical SEO scanner

## Pro Pipeline (5 Scripts)

1. **keyword_cluster**: Group keywords into topical clusters via blended Jaccard similarity
2. **kgr_auto**: Calculate Keyword Golden Ratio (KGR) scores automatically
3. **content_matrix**: Generate prioritized content action plan
4. **gap_deep**: Deep competitor analysis with keyword overlap detection
5. **full_audit**: End-to-end pipeline — seeds to strategy report in one command

## Links

- [Privacy Policy](https://zens.ink/privacy/)
- [Terms of Service](https://zens.ink/terms/)