前提条件 — Python 3.10+ 和一个终端。无需 pip install，无需虚拟环境，无需 API 密钥。
60 秒速览
每个工具都是下一步的输入。从种子词开始，以内容计划结束。让我们走一遍第一步。
克隆仓库
git clone https://github.com/respectevery01/zens-ink-seo-package.git
cd zens-ink-seo-package工具包在 zens_ink/ 目录下。每个脚本独立运行——零外部依赖，仅用 Python 标准库。
运行第一次关键词搜索
python3 -m zens_ink keyword_research "ai tools"你会看到从 Google Autocomplete 拉取的真实建议——就是你输入搜索词时看到的下拉预测：
ai tools for writing
ai tools for students
ai tools free
ai tools for coding
ai tools for productivity
ai tools for business
ai tools for marketing
ai tools 2026
best ai tools for small business
ai tools like chatgpt扩展搜索范围
加 --expand 深入挖掘：
python3 -m zens_ink keyword_research "ai tools" --expand这会在种子词后面依次追加字母 a–z，触发 26 次独立的 autocomplete 查询，挖掘你手动想不到的建议。
保存到文件
管道输出到文件，留作后用：
python3 -m zens_ink keyword_research "ai tools" --expand > my_keywords.txt刚才发生了什么？ — 不到一分钟，你发现了 150+ 个真实用户输入 Google 的关键词——没有花一分钱，没有注册任何东西。
集成到你的工具
ZensInk 是纯 Python 脚本——任何有 shell 的地方都能跑。以下是接入常见 AI 编程工具的方法。
把 zens_ink/ 目录和 Pro 版的 SKILL.md 放进项目根目录。Claude Code 会自动发现 skill，用对话方式运行整个流程：
# Claude Code 终端 > 对 "fintech" 做关键词研究并聚类Claude 读取 SKILL.md → 运行 keyword_research + keyword_cluster
→ 返回按优先级排序的内容计划
把脚本加到项目里，在 .cursorrules 中声明位置：
# .cursorrules
本项目使用 ZensInk 做 SEO。
脚本：./zens_ink/
运行：python3 -m zens_ink <tool> <args>然后对 Cursor 说："为这个站点找关键词缺口"——它会自动选择正确的脚本。
在 Windsurf 中打开仓库，用 Cascade 操作。脚本输出纯文本，Cascade 可以解析并串联调用：
# Windsurf Cascade
对 "python" 运行 keyword_research --expand，
然后把输出管道给 keyword_volume在 VS Code 安装 Cline 扩展，打开仓库目录，给终端权限。它可以运行每个脚本并直接读取输出文件：
# Cline 指令
运行完整的 ZensInk 流程：
1. keyword_research --expand
2. keyword_volume
3. competitor_gap
把所有输出保存到 ./seo-output/直接运行。任何 shell，任何系统——macOS、Linux、WSL，甚至 Termux：
git clone https://github.com/respectevery01/zens-ink-seo-package.git
cd zens-ink-seo-package
python3 -m zens_ink keyword_research "你的领域" --expand接下来？
把 zens_ink/ 目录和 Pro 版的 SKILL.md 放进项目根目录。Claude Code 会自动发现 skill，用对话方式运行整个流程。
# Claude Code 终端
> 对 "fintech" 做关键词研究并聚类
# Claude 读取 SKILL.md，运行 keyword_research + keyword_cluster，
# 返回一个按优先级排序的内容计划。把仓库克隆到项目里，在 .cursorrules 中声明脚本位置。Cursor 会从上下文中判断该调哪个脚本。
# .cursorrules
本项目使用 ZensInk 做 SEO。
脚本在 ./zens_ink/
运行：python3 -m zens_ink <tool> <args>在 Windsurf 中打开仓库，用 Cascade 操作。脚本输出纯文本，Cascade 可以解析结果并串联调用。
# Windsurf Cascade
对 "python" 运行 keyword_research --expand，
然后把输出管道给 keyword_volume在 VS Code 安装 Cline 扩展，给 Cline 终端权限。它可以运行每个脚本并直接读取输出文件。
# Cline 指令
运行完整的 ZensInk 流程：
1. keyword_research --expand
2. keyword_volume
3. competitor_gap
把所有输出保存到 ./seo-output/直接运行。任何 shell，任何系统——macOS、Linux、WSL，甚至 Android 的 Termux。
git clone https://github.com/respectevery01/zens-ink-seo-package.git
cd zens-ink-seo-package
python3 -m zens_ink keyword_research "你的领域" --expand