AI Keyword Research Automation · Free · Open Source
Give your AI one job:
find 100 real keywords.
Not a dashboard of volume guesses — evidence. This open-source worker expands from your seed topics across the public web, checks every phrase against your market file, classifies intent, clusters, scores, and keeps going until your target number is met. No API keys. No accounts.
Runs inside your AI coding tool. Your data never leaves your machine.
The same worker pattern that runs SpielOS's own SEO department.
One worker. One job. One number.
AI Keyword Research Agent turns any AI coding assistant into a persistent SEO-research employee.
A target that survives restarts
"Find me 100 keyword opportunities" is stored on disk, not in chat memory. Close the laptop, come back tomorrow, say "continue" — it resumes exactly where it left off.
An honesty gate other tools don't have
Invented volume numbers are banned by contract. Every recorded keyword must cite your market file AND a real public source where demand was observed — a ranking competitor page, a community thread, an autocomplete pattern.
A cluster map, not a junk list
Every keyword gets an intent label and a named cluster plus a suggested page type — so the export reads like a content plan, ready for Excel or your writers.
Install your AI keyword researcher now, and get a real opportunity map right away.
1 · Open your AI tool — Claude Code, Codex CLI, or OpenCode — in any empty folder.
2 · Paste this prompt
Install https://github.com/ShayanSpiel/AI-Keyword-Research-Agent following its AGENTS.md, then help me write my market.md, and start finding keyword opportunities until we hit my target.
Copied!
3 · Then just talk to it.
Works with
Prefer the terminal? One command does it all:
curl -fsSL https://raw.githubusercontent.com/ShayanSpiel/AI-Keyword-Research-Agent/main/install.sh | bash
Then just talk to it.
After install, the worker understands plain instructions:
"Continue finding keywords until the target is met."
Resumes from saved progress and keeps working.
"How many keywords so far?"
Progress bar plus a live cluster map.
"Update my market: we also serve SaaS startups."
Rewrites your market file, confirms with you, continues under the new rules.
"Export my keywords."
Writes keywords.csv, sorted by score — ready for your content plan.
No AI needed to check progress: python3 kr.py status
Just need keywords?
Take the worker. Free, open source, MIT licensed — no account, no server, no strings.
Get AI Keyword Research Agent on GitHubWant the whole SEO department running like this?
Keyword research is one worker in one department of a SpielOS-run company. We build these systems around your business — you see the scope before you pay.
Free review · No required call · See the scope before you pay