How zensink/zens-ink-seo-package works
ZensInk is a Python CLI SEO toolkit: users discover keywords, assess demand and competition, find content opportunities, then audit pages or review search performance. Its modules also offer intent analysis, Reddit mining, GEO/AI-readiness tools, and rank tracking; the MCP server exposes tools to agent clients. The README documents the workflow and capability set, while source excerpts show selected module behavior and calls. Connections among unsampled modules are omitted where their runtime wiring is not evidenced.
Main entry points: keyword_research.py Keyword Research · mcp.py MCP Server · keyword_volume.py Keyword Volume · kd.py Keyword Difficulty
Components 32
Keyword Discovery
- Keyword Research
zens_ink/keyword_research.py - Reddit Mining
zens_ink/reddit_blueocean.py - Keyword Volume
zens_ink/keyword_volume.py - Brave Volume
zens_ink/brave_volume.py - Keyword Clustering
zens_ink/keyword_cluster.py
SEO Analysis
- Keyword Difficulty
zens_ink/kd.py - KGR Scoring
zens_ink/kgr_auto.py - Domain Rating
zens_ink/domain_rating.py - Keyword Intent
zens_ink/search_intent.py - SERP Intent
zens_ink/serp_intent.py - Rank History
zens_ink/rank_tracker.py
Content Planning
- Opportunity Matrix
zens_ink/content_matrix.py - Competitor Gaps
zens_ink/competitor_gap.py - GEO Fan-out
zens_ink/geo_fanout.py
Site Audits
- Technical and GEO Audit
zens_ink/site_audit.py - On-page Scoring
zens_ink/onpage_audit.py - Content Quality Gate
zens_ink/content_qc.py - AI Crawler Audit
zens_ink/ai_crawler_audit.py - LLMs File Generator
zens_ink/llms_gen.py
Interfaces and Config
- GSC OAuth Setup
zens_ink/setup_gsc.py - GSC Performance
zens_ink/search_performance.py - Shared Configuration
zens_ink/config.py - MCP Server
zens_ink/mcp.py
Other components
- SEO User
- MCP Clients
- Google Autocomplete
- Serper API
- Bing Webmaster
- Brave Search
- Ahrefs API
- Reddit API
- Google Search Console
Connections 26
- SEO User → Keyword Research: runs tool
README.md - Keyword Research → Google Autocomplete: fetches suggestions
zens_ink/keyword_research.py - SEO User → Keyword Volume: checks demand
README.md - SEO User → Keyword Difficulty: checks difficulty
README.md - SEO User → Competitor Gaps: compares sites
README.md - SEO User → Technical and GEO Audit: audits site
README.md - SEO User → GSC Performance: reviews rankings
README.md - Reddit Mining → Keyword Research: reuses autocomplete
zens_ink/reddit_blueocean.py - Reddit Mining → Reddit API: searches posts
zens_ink/reddit_blueocean.py - Keyword Volume → Bing Webmaster: fetches volume
README.md - Brave Volume → Brave Search: checks demand
README.md - Domain Rating → Ahrefs API: fetches rating
README.md - Keyword Difficulty → Serper API: fetches SERP
zens_ink/kd.py - SERP Intent → Keyword Intent: cross-validates
zens_ink/serp_intent.py - KGR Scoring → Keyword Research: uses suggestions
zens_ink/kgr_auto.py - KGR Scoring → Keyword Volume: uses volume
zens_ink/kgr_auto.py - On-page Scoring → Technical and GEO Audit: reuses audit
zens_ink/onpage_audit.py - GSC Performance → Google Search Console: queries analytics
zens_ink/search_performance.py - GSC OAuth Setup → Google Search Console: sets up OAuth
README.md - GSC Performance → Shared Configuration: reads settings
zens_ink/search_performance.py - Keyword Volume → Shared Configuration: reads settings
zens_ink/keyword_volume.py - Keyword Difficulty → Shared Configuration: reads settings
zens_ink/kd.py - MCP Clients → MCP Server: connects via stdio
README.md - MCP Server → Keyword Research: dispatches tool
README.md - MCP Server → Keyword Difficulty: dispatches tool
README.md - MCP Server → Technical and GEO Audit: dispatches tool
README.md