01
Claude Code
One command in your terminal:
claude mcp add --transport http contextbolt-seo <your URL>
Worked example
From a blank page
to a content plan.
Say you are launching an AI note-taker app and want to find the SEO opening. Here is one real session, start to finish, all inside your agent.
I'm building an AI note-taker app. What should it try to rank for?
Used keyword_research
I pulled keyword ideas around AI note-taking. The pick of them:
- ai note taker · 8,100/mo · difficulty 41
- ai meeting notes · 5,400/mo · difficulty 38
- transcribe meetings · 3,600/mo · difficulty 33
- meeting summary generator · 1,900/mo · difficulty 29
The two under 35 are your realistic openings. Start with meeting summary generator and transcribe meetings, then go after the head term once a few posts are ranking.
From that one answer you keep pulling the thread. Each follow-up is one more plain question, and each result tells you what to do next.
"How hard is ai meeting notes to rank for?"keyword_difficulty
Difficulty 38, 5,400 searches a month. Reachable with one focused post, so it earns a spot on the shortlist.
"Who ranks in the top 10 for ai note taker?"serp_overview
Otter, Fireflies, Notta and the rest. Open the top three and you can see the exact angle you need to beat.
"How is otter.ai doing on SEO?"domain_overview
Roughly 2.1M visits a month across 41,000 keywords. That is the size of the leader you are nibbling at, which keeps your expectations honest.
"What does otter.ai already rank for?"ranked_keywords
Their biggest traffic pages, which double as a ready-made list of topics you can cover too.
"Who else competes for these keywords?"competitor_keywords
The full set of rivals, including a couple you would never have named off the top of your head.
Ten minutes, no dashboard, no exports. You went from a blank page to a keyword shortlist, a read on the market leader, and a content plan, in the chat you already work in.
A week later, the memory pays off. Ask "how is 'meeting summary generator' looking now?" and your agent's answer leads with what has changed: "Since last lookup 7 days ago, difficulty has gone from 29 to 32 and search volume from 1,900 to 2,100." No need to remember the old numbers, no extra credit spent on memory. And if you ran this in Claude Code or Cursor, the whole session is already on disk in ./seo-findings/ as markdown you can search, commit, or open in Obsidian.
One honest limit: ContextBolt SEO does not do backlink analysis yet, so "who links to otter.ai" is not a question it can answer today. That one is on the roadmap.
Keep learning
Go a little deeper.
Want the background, or to see how ContextBolt SEO stacks up against the alternatives?
FAQ
Usage questions.
Anything else, email [email protected] and we will help.
How do I know it is connected?
Ask your agent "what SEO tools do you have?" If it lists keyword, SERP, domain and competitor tools, you are connected. If not, re-check the URL you pasted.
Can I ask follow-up questions?
Yes. It is a normal chat. Ask "now show me who ranks for it" or "which of these is easiest?" and the agent keeps the thread, calling more tools as needed.
Does it know which site is mine?
Tell it once in the chat, like "my site is yourblog.com", and it uses that for the rest of the conversation. There is no account setting to configure.
Does it remember what I have researched before?
Yes. Every lookup is kept on your account, and when you ask about the same keyword or domain again your agent's answer starts with what has changed since last time. You can also ask "what have I researched?" or tell the agent to pin a finding. The memory tools are free and do not draw from your monthly lookups.
What is the seo-findings folder?
When you connect ContextBolt SEO in Claude Code, Cursor or another client with file access, every lookup also saves to a ./seo-findings/ folder in your project as markdown. One file per keyword or domain you research, plus an INDEX. You can search it, commit it to git, or open it in Obsidian. claude.ai web users still get the same research through the memory tools; the files just do not appear on disk.
What happens if I hit the limit mid-task?
The tool returns a friendly message with your reset date and a top-up link, and makes no charge. Nothing breaks. Add a top-up pack and carry on.
Can I use it for client or freelance work?
Yes. Run research for any domain, yours or a client's. One subscription, no per-seat fees.
Do I need to know SEO jargon?
No. Ask in everyday language. If a term like difficulty or CPC comes back, ask the agent to explain it.