SEO Inside Codex: Run Keyword and SERP Research

You are in the terminal with Codex, halfway through building something. Maybe it is scaffolding a new docs section, maybe you just 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 then try to remember where you were when you get back.

There is a better answer now. Codex, OpenAI’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.

The model changes how well Codex can carry that job through, but it does not replace the source. The GPT-6 Astra for SEO guide covers the new model’s research strengths, costs, and limits.

This guide covers how to wire SEO data into Codex, 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 Codex

The case is not “Codex 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 Codex 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 Codex 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. Codex reads its MCP servers from a config file 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.

How do you connect SEO data to Codex?

With an active ContextBolt SEO trial or subscription, run these commands in your terminal.

codex mcp add contextbolt-seo --url https://seo.contextbolt.app/mcp
codex mcp login contextbolt-seo

The first command adds the server. The second opens the browser sign-in. Sign in with your ContextBolt SEO account email, enter the email code, and choose Allow connection. In the Codex IDE extension, use Authenticate on the MCP connection instead.

If you prefer to edit ~/.codex/config.toml, use this block, then run the login command above.

[mcp_servers.contextbolt-seo]
url = "https://seo.contextbolt.app/mcp"

Codex uses TOML, so this is not the JSON block used by Cursor. The shared URL has no personal key in it. Authentication is separate from the configuration.

Open a new Codex session and ask what SEO tools it has. If none appear, check that browser sign-in finished. The connection guide covers reauthentication and the private-URL compatibility option. OpenAI’s MCP documentation explains the client configuration.

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?” Codex 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 Codex 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 the URL to ~/.codex/config.toml, sign in with codex mcp login contextbolt-seo, 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 Codex setup page.

Where Codex 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 Codex 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 Codex 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 two commands above, and find out without ever leaving the session.