SEO Inside Claude Code: Run Keyword and SERP Research

You are in the terminal with Claude Code, halfway through building something. Maybe it just scaffolded a new docs section, maybe you asked it to draft the copy for a landing page, and a question lands in your head. Is anyone actually searching for the phrase you are about to put in that H1, and who already ranks for it? The old answer was to break flow, alt-tab to a browser, log into a $129 dashboard, run one lookup, and try to remember where you were when you get back.

There is a better answer now. Claude Code, Anthropic’s command-line coding agent, speaks the Model Context Protocol, the same plug standard that lets it talk to GitHub, Postgres, and your file system. Point it at a live SEO data source and you can ask that keyword question in the terminal, get a real volume and difficulty number back in seconds, and never leave the session you were working in.

This guide covers how to wire SEO data into Claude Code, what you can actually ask once it is connected, where ContextBolt SEO fits, and whether the trade is worth it. We write our own copy and do this every day, so this is the workflow as it actually runs, not a feature list.

Why pull SEO data into Claude Code

The case is not “Claude Code is now an SEO tool”. It is that the cost of asking an SEO question should be near zero, and in the usual setup it is not.

Most builders who do their own SEO use a thin slice of what a dashboard offers, and only now and then. You want to know if a keyword is winnable before you write the page. You want a quick read on a competitor’s traffic. You want to check whether the slug Claude Code just generated matches what people actually search. None of that needs a 40-tab research session. It needs one number, fast, without a context switch out of the terminal. The friction is not the data, it is the trip to go get it, and Claude Code already lives in the window where the question came up.

The Model Context Protocol, or MCP, is what makes this possible. It is an open standard, introduced by Anthropic in late 2024, that lets AI agents call external tools and data sources through one common interface. Claude Code loads its MCP servers at startup, and once connected the agent can call their tools mid-conversation. SEO data is just another source the agent can reach, sitting alongside your repo and your shell.

The payoff is flow. When the answer to “is this keyword soft enough to rank” lives in the same window as your code, you ask it. When it lives behind a login two tabs away, you guess instead, and guessing is how you end up with a page optimized for a phrase nobody types. If you want the longer argument for why the agent beats the dashboard, the SEO MCP server explainer makes the full case. And if you are building out the whole Claude Code setup, live SEO data is one of the MCP servers worth a slot in a Claude Code workflow.

How do you connect SEO data to Claude Code?

Start a ContextBolt SEO trial or use your existing subscription, then run this in your terminal.

claude mcp add --transport http contextbolt-seo https://seo.contextbolt.app/mcp

Add --scope user before the server name if you want it available in every project. That scope covers the sessions on your machine. The threads in the redesigned Claude Projects run in the cloud and cannot see it, so they take the same server from a claude.ai connector instead, which SEO with Claude Projects walks through. Open Claude Code and run /mcp, select contextbolt-seo, and authenticate in your browser. Sign in with your ContextBolt SEO account email, enter the email code, and choose Allow connection.

If you prefer a project configuration, add the server to .mcp.json.

{
  "mcpServers": {
    "contextbolt-seo": {
      "type": "http",
      "url": "https://seo.contextbolt.app/mcp"
    }
  }
}

The type must be http. Saving this file registers the server; you still need to authenticate through /mcp. The shared URL contains no personal secret. Each person using the configuration signs in to their own account.

Ask Claude what SEO tools it has before starting research. Existing personal URLs still work as a compatibility option, but they contain a secret and must stay out of shared files. The connection guide covers that option. If MCP itself is new to you, start with What Is MCP?.

What can you actually ask once it’s connected?

This is where it stops being a config exercise and starts being useful. You type a question, the agent picks the tool, the data comes back inline. A few of the moves I run most from the terminal.

• Keyword reality checks: “What keywords should my developer-tools blog target?” Claude Code runs keyword research and returns related terms with volume, difficulty, and intent, so you get a content shortlist before you write a word.
• Difficulty plus SERP in one ask: “How hard is ‘rust web framework’ to rank for, and who’s in the top 10?” It chains a difficulty score and the live page-one results, so you learn both whether you can win and what kind of page already wins.
• Domain and competitor mining: “What does vercel.com rank for, and who competes for those terms?” You get a content map plus the rivals chasing the same keywords, run from the same shell you deploy from.
• Backlink gaps: “Who links to my top competitor but not to me?” It returns a spam-scored prospect list, a ready-made outreach shortlist. Backlink questions cost more, three credits each, because the data behind them is heavier.
• On-page audits: “Audit my docs site and show the worst pages first.” You get a graded fix-list, and because Claude Code writes code, you can tell it to fix the top few and re-audit in the same session.
• Chained research: “Find ten low-difficulty keywords for my docs site, check which ones a competitor already ranks for, and list the gaps.” That is one prompt, not ten dashboard sessions, and the whole chain lands on your board as it runs.

The thread through all of these is plain language. You are not learning a tool’s menu or remembering which report lives where. You ask the way you would ask a colleague, and the agent translates it into the right lookup, then the next one. That chaining is the part a dashboard cannot match, because a dashboard makes you the one clicking between screens.

Where ContextBolt SEO fits

ContextBolt SEO is the one we make, and it exists for exactly this workflow. It is a hosted MCP server that wraps Ahrefs-grade data and hands you a single URL. You add that URL with claude mcp add, authenticate through /mcp, and the SEO tools are there in the terminal. Research tools, keyword research, keyword difficulty, SERP overview, domain overview, ranked keywords, and competitor keywords, cost one credit each. Backlink tools, backlink overview, referring domains, and competitor gap, cost three each. The plan is $35 a month for 1,000 credits, roughly a quarter of the entry price of the big suites, and there is no account to provision or deposit to fund. The free Google Search Console tools and the automatic cross-session memory never spend a credit. Every tool returns a digested answer with a verdict line rather than a wall of raw JSON, so the terminal stays readable while you keep coding. The step-by-step is on the Claude Code setup page.

Where Claude Code specifically makes this shine is that it can act on what it finds. It audits a page and edits it in the same session. Every lookup also lands on your SEO Board, one card per keyword or domain, so the research is there to compare next month. Ask about the same keyword a week later and the answer leads with what changed since you last looked, a volume or difficulty delta, with no extra prompt and no extra credit. Most agents lose their research when the session ends. Here it accretes into something you own.

There is one more move that only pays off inside a coding agent. Say “audit my docs site” and ContextBolt SEO grades the mechanical health of every page against a strict ruleset, title and meta lengths, a single H1, thin content, broken links, canonical tags, then hands back its own 0-100 score with the fixes worst first. Because Claude Code edits code, you say “fix the top three” and it rewrites the pages in the same session, then re-audits and leads with the delta, health 80 to 91. Ahrefs reports the problems. ContextBolt hands them to the thing that can fix them. Find it, then fix it.

The honest framing the product holds to applies here too. This is Ahrefs-grade data, not the same numbers as Ahrefs. It sits on DataForSEO estimates, which are decision-useful and directionally accurate, the same class of data inside many dashboards you already trust. For deciding what to build and what to write, that is more than enough. The full tour of tools and workflows walks through the rest.

Is it worth it?

Doing SEO inside Claude Code covers the research and the fixes. It does not cover everything a suite does, so here is the scope, said once. Scheduled rank tracking is a different job. Checks here run when you ask, and the Search Console connection takes a daily snapshot of your own clicks and positions. Your research collects on your SEO Board, a dashboard that fills itself, rather than in a keyword explorer you click around in, so if you think in charts the terminal will feel sparse at first. And the agent can be confidently wrong about strategy even when the underlying numbers are right, so treat its SEO advice the way you already treat its code, useful, fast, and in need of a human check before it ships.

There is also a usage shape to respect. A metered server has a monthly credit budget, so you spend it on real questions, not idle curiosity. In practice that is a feature, because it nudges you toward the lookups that actually change a decision, but it is worth knowing going in.

What you gain in return is the thing that matters most when you build solo and time is the scarce resource. The answer arrives where you already are, in the terminal, in the seconds you would otherwise spend alt-tabbing to a dashboard, at a price that does not make you wince. For most builders doing their own SEO, that trade is an easy yes. The keyword you were nervous about might be wide open. Start the 7-day trial, run the one command above, and find out without ever leaving the session.