Keyword Research

How it works

Every time you type into Google, the search bar predicts what you’re about to say. Those predictions come from real search behavior — Google only suggests phrases that people actually search for.

ZensInk taps into this signal directly. No API key, no rate limits, no cost.

Basic usage

python3 -m zens_ink.keyword_research "seo tools"

Returns 8–10 suggestions for your seed keyword.

Expand mode

Append every letter of the alphabet (a–z) to discover long-tail variants you’d never think of manually:

python3 -m zens_ink.keyword_research "seo tools" --expand

This runs 27 autocomplete queries (seed + a–z) and deduplicates the results. Expect 150–300 keywords from a single seed.

Language targeting

Switch between English and Chinese autocomplete sources:

# English suggestions
python3 -m zens_ink.keyword_research "tarot meaning" --lang en

# Chinese suggestions
python3 -m zens_ink.keyword_research "八字排盘" --lang zh

The --lang flag controls which Google locale is queried. en hits Google.com, zh hits Google with Chinese locale.

JSON output

For piping into other tools or scripts:

python3 -m zens_ink.keyword_research "seo" --expand --json > keywords.json

Tips

• One seed at a time. The tool takes a single keyword. Run it multiple times for different seeds.
• Expand is slow by design. Each letter query has a 0.15s delay to stay polite. A full expand takes ~4 seconds.
• Combine with volume. Pipe results into keyword_volume to see which keywords actually get searched.
• Suggestion count signals demand. If Google returns 10 suggestions, the topic is high-activity. If it returns 2–3, it’s niche.