"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.
ContextBolt SEO overview Run SEO from the agent
The ContextBolt SEO guide
Run SEO from the agent
you already use.
Six short chapters. Connect it, ask your first question, and run the audit loop that finds and fixes what is holding your site back.
Chapter 01 · Setup
Connect it once.
Under a minute.
Your private MCP URL arrives by email after you subscribe. Pick your agent, copy the snippet, and you are ready to go.
One command in your terminal.
claude mcp add --transport http contextbolt-seo <your URL>
No files to edit. Three clicks in the app.
- Open Settings, then Connectors.
- Click Add custom connector.
- Name it ContextBolt SEO and paste your URL.
On Claude.ai in the browser, tool calls can show a connector ID instead of the name. That is normal.
In mcp.json, under mcpServers.
"contextbolt-seo": { "url": "<your URL>" } In ~/.codex/config.toml.
[mcp_servers.contextbolt-seo] url = "<your URL>"
In mcp_config.json. The key is serverUrl, not url.
"contextbolt-seo": { "serverUrl": "<your URL>" } Cline, n8n, ChatGPT and more are covered in the integrations hub. Your URL carries a personal token, so treat it like a password and keep it out of public repos.
Then ask what SEO tools do you have? If keyword and SERP tools come back, you are connected.
Chapter 02 · First session
See it work,
then ask your own.
Say you are launching an AI note-taker app and want the SEO opening. This is that session. Click the chips to drive it.
Click to try a real question
The demo is the first few questions. You keep pulling the thread, and each follow-up is one more plain question that tells you what to do next.
"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. 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 the 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 old numbers to remember, no extra lookups spent. And in Claude Code or Cursor, the whole session is already on disk in ./seo-findings/ as markdown.
Chapter 03 · What you can ask
The whole toolbox,
one question each.
Every tool answers one plain-English question with live data. Click a tool to see what you would actually type. Your agent picks the tool; you never name it.
Research
1 lookup each- Related keywords with volume, difficulty and intent. Ask What keywords should a meal-prep blog go after?
- How hard one keyword is to rank for. Ask How hard is it to rank for 'ai meeting notes'?
- Who ranks in Google's top 10. Ask Who's in the top 10 for 'best crm for startups'?
- A domain's traffic, keyword count and authority. Ask How is rival.com doing on SEO?
- What a domain already ranks for. Ask What does rival.com already rank for?
- The domains chasing your keywords. Ask Who else is competing for my keywords?
- How often a term is asked in AI, not Google. Ask How often do people ask AI about payroll software?
Audit and fixNew
1 lookup per page- Your most important pages checked for on-page problems, fixes worst first. Ask Audit my site.
- One URL, the same checks, the same living report. Ask Audit mysite.com/pricing/
Backlinks
3 lookups each- Authority, total backlinks and spam score. Ask How strong is rival.com's backlink profile?
- Every site linking to a domain, ranked. Ask Who links to rival.com?
- Links your rivals have and you don't. Ask Who links to my rivals but not me?
AI visibility
8 lookups each- How often ChatGPT and Google AI mention you. Ask Does ChatGPT recommend my product?
- Your share of AI answers vs competitors. Ask Who wins the AI answers in my niche?
Your own data
free, 0 lookups- Your real clicks, positions and queries. Ask What am I ranking 8th to 20th for?
- How many lookups you have left. Ask How many lookups do I have left?
Chapter 04 · Workflows
How it fits
your SEO process.
Real jobs, start to finish. Copy the ask, paste it into your agent, and it chains the tools for you.
Plan a new post
Find a keyword you can rank for, then see who you are up against.
keyword_researchkeyword_difficultyserp_overview
Audit a competitor
Size up a domain, see what it ranks for, find who else is in the race.
domain_overviewranked_keywordscompetitor_keywords
Find quick wins
Pull the keywords you already rank for just off page one, then check the push.
search_console_quick_winskeyword_difficulty
Size up a niche
Check the demand, the competition and the incumbents first.
keyword_researchcompetitor_keywordsdomain_overview
Build your backlinks
Find who links to your rivals but not you, then judge each prospect.
backlink_gapbacklink_overview
See if AI recommends you
Check whether AI answers mention you, then see who they name instead.
ai_visibilityai_share_of_voice
Fix your own site
Audit your pages, let your agent fix the problems, then re-check to prove it worked. The newest workflow, and the one to try first.
site_audityour agent editssite_audit
Watch it play out below Chapter 05 · Site audit
Find what's broken.
Then fix it.
The newest part of the toolkit. Ahrefs hands you a dashboard of problems. Your agent gets handed the fix list, and it is already sitting in your code. Run the loop.
Audit my site.
Used site_audit · 25 pages
80/100health · 25 pages
HMissing H15 pages
MTitle too long3 pages
MThin content4 pages
Top fixes, worst first. Want me to take the top three?
Fix the top three.
Edited 12 pages
- Added an H1 to 5 pages
- Trimmed 3 titles under 60 characters
- Fleshed out 4 thin pages
No copy-paste. Your agent edits the real pages, because it is already in your project.
Audit my site again.
Used site_audit · re-check
91/100+11
Missing H1fixed · 5
Title too longfixed · 3
Thin contentfixed · 4
Re-checked the same 25 pages. Health 80 to 91. New issues, none.
Run the loop yourself
One lookup per page, so the default 25-page audit is 2.5% of a month's allowance. Run it again after you ship and it re-checks the same pages, leading with what changed. New pages are only added when you say yes.
Chapter 06 · Habits
Small habits,
better answers.
Nine things subscribers figure out in week one, saved for your day one.
- Ask in plain English. No filters or query builders. "Who ranks for X?" just works.
- Let it chain tools. Ask one big question and the agent calls several tools to answer it.
- Be specific. Name the exact keyword or domain and the answer gets sharper.
- It remembers. Ask about a keyword again and the answer leads with what has changed since last time. Memory and project files are automatic and never count against your 1,000.
- Findings live in your project. In Claude Code, Cursor or Codex, every lookup writes to ./seo-findings/ as markdown. Grep it, commit it, drop it in Obsidian.
- Most calls are one lookup. The $35 plan includes 1,000 a month. Research tools cost one lookup, backlink tools three, AI-visibility eight, audits one per page. Your own Search Console is free.
- Re-audit after you ship. Run "audit my site" again once your fixes land. The answer leads with what changed, so you get proof instead of a stale report.
- Checking your balance is free. Ask how many credits you have left anytime, even at zero.
- Trust the direction. Numbers are decision-useful estimates, not identical to Ahrefs.
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 audit 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. Memory is free and does 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 recalled research; the files just do not appear on disk.
What does a site audit cost?
One lookup per page it checks, and only pages that actually return data get charged. A default run covers your top 25 pages, so about 25 lookups, 2.5% of a month. A single-page check with page_audit is one lookup.
What happens if I run an audit twice?
The second run re-checks the pages already in your report and leads with what changed. Health before and after, what got fixed, anything new. It never quietly audits fresh pages or spends without asking; expanding the report to new pages only happens when you explicitly say yes.
Where does the audit report live?
There is one living report per site. In Claude Code, Cursor or Codex it is saved to ./seo-findings/audits/ as markdown and updated in place on every run, with a progress log of your re-checks. Delete the file and the next audit re-creates it.
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.
Keep learning
Go a little deeper.
Want the mechanics, or to see how ContextBolt SEO stacks up against the alternatives?