How to build custom SEO reports with Claude Code and Google Search Console

How to build custom SEO reports with Claude Code and Google Search Console

For a long time, SEO reporting revolved around dashboards. When a meeting was on your schedule, you’d spend your day preparing by exporting data from Google Search Console, cleaning it in spreadsheets, and layering charts into Data Studio. 

Now, AI coding agents are changing that workflow. Instead of the manual work that would previously take hours, you can use tools like Claude Code to surface customized data with polished visuals in just minutes.  

Here’s how to turn Google Search Console data into custom reports and speed up your reporting workflow.

What Claude Code can do with GSC data

Claude Code isn’t the same as using Claude in a browser tab. The standard Claude.ai interface works like a regular chatbot. Claude Code, on the other hand, is Anthropic’s terminal-based AI coding assistant. 

It still feels conversational, but instead of living in a browser tab, it can interact directly with files, folders, spreadsheets, and scripts on your machine. It can read exported GSC CSV files, process large datasets locally, generate charts and summaries, analyze trends across pages and queries, and ultimately create structured deliverables from raw data.

Claude Code isn’t simply generating text responses like a chatbot. Instead, it’s creating a local reporting environment that behaves like a lightweight software project. 

Dig deeper: How to turn Claude Code into your SEO command center

Your customers search everywhere. Make sure your brand shows up.

The SEO toolkit you know, plus the AI visibility data you need.

Start Free Trial
Get started with

Semrush One Logo

There’s a learning curve 

Before you can start building beautiful, custom reports, you’ll need to set up Claude Code. If you’re not an engineer or developer, this process can feel overwhelming at first. There is a learning curve, but don’t give up. 

Setup is actually the most time-intensive piece of the process, but it’s a one-time process. Depending on your technical experience, the initial setup may take a couple of hours.

The “reports in minutes” concept really applies after the environment is configured. Once you’re past the initial setup and Claude is connected to GSC, you can run any custom SEO report you want in a matter of minutes.

If you’re in an enterprise environment, this setup process can go faster with a little help from the tech team. If you’re an agency or an SEO consultant, you can always lean on the expertise of in-house developers or engineers or an outside contractor.

Getting started

If you don’t already have one, create an account at Claude.ai. You can sign up with Google, email/password, or enterprise SSO.

Most SEOs using Claude Code for reporting have a paid plan or use Anthropic API access. But you can use a free plan at the time of writing.

Install Node.js

Claude Code runs locally on your machine, so you’ll first need Node.js installed. You can also use it on a Chromebook by activating the Linux subsystem. 

For the purposes of this tutorial, I used a Mac.

Next, download the current LTS (Long-Term Support) version. Once installed, you’ll have access to npm, which is used to install Claude Code.

To verify the installation, open Terminal (Mac/Linux) or PowerShell (Windows) and run:

node -v
npm -v

If both commands return version numbers, you’re ready to continue.

Install Claude Code

Next, install Claude Code globally:

npm install -g @anthropic-ai/claude-code

Once the installation finishes, start Claude Code by running:

claude

The CLI will walk you through authentication and connect to your Anthropic account. After that, Claude Code can work directly with local project folders containing exported SEO data, scripts, spreadsheets, and reporting templates.

Dig deeper: SEO reporting outgrew Data Studio — here’s what comes next

Get the newsletter search marketers rely on.


Establishing the reporting framework

At this point, you’ll be able to interact with Claude Code in the terminal using commands much like you would with an AI chatbot.

To kick off the workflow, I gave Claude a prompt:

  • “I have a marketing meeting coming up, and I want to show our performance from Google Search Console.”
Example SEO report using Claude Code

One benefit is that Claude now becomes an onboarding assistant. Claude will ask a handful of clarifying questions to get started. For example, during the setup process, Claude asked:

  • Whether to use a service account or OAuth credentials to access the Google Search Console API.
  • Which reporting views or marketing priorities mattered most.
  • Where the reporting project should live locally on the machine.
  • Which Google Search Console property to connect to.

Claude also asked where the reporting project should live locally. 

(As an aside, we prefer to store it inside a dedicated code directory rather than a standard Documents folder because development projects can sometimes run into file permission or syncing issues when stored inside cloud-synced folders like Documents or Desktop.)

Next, I established how the visuals will be built before connecting to GSC. 

We like using Observable Framework, an open-source framework for building data apps, dashboards, and reports. 

You don’t necessarily need to follow this exact structure; Claude Code is highly customizable, and you’ll settle into what works for you. 

And remember: if you’re unsure about any next steps, you can just ask Claude, and it will help guide the setup. 

Connecting to GSC

Before Claude Code can start generating reports from live GSC data, you’ll need to connect it to the Search Console API.

This is another technical part of the process, but the good news is that Claude can walk you through much of the setup interactively.

To establish the connection, you’ll need to create a Google Cloud Project (GCP) and configure API credentials.

That setup process typically includes:

  • Creating a Google Cloud project.
  • Enabling the Search Console API.
  • Generating OAuth credentials or API secrets.
  • Adding those credentials to a local environment file.

In larger organizations, your IT or development team may already manage this infrastructure. 

If not, you can still configure it yourself using a standard Google account or Google Workspace account.

Generating reports

Once you’ve finished connecting to GSC, congratulations! You made it through the hardest part. Once setup is complete, your reporting process changes entirely.

You can now focus on the reporting views you want to create, such as: 

  • “Show me the top 10 landing pages that gained traffic this month.”
  • “Create a chart of declining nonbrand queries over the last 90 days.”
  • “Compare CTR trends by device type.”
  • “Show me the top-performing pages from New York last month.”

Claude is now like an on-demand reporting assistant. You simply open the project folder, launch Claude Code, and ask for the charts you need.

In addition, you can be more dynamic in your meetings. 

Instead of building a rigid dashboard ahead of time and hoping stakeholders ask predictable questions, you can generate new views dynamically as questions come up. 

That means you can walk into a meeting, ask Claude for a completely new chart or segmentation, and generate it in minutes rather than rebuilding an entire dashboard manually.

Now let’s look at some reports you might quickly run before your next meeting.

Here’s an example of a custom SEO performance dashboard generated from Google Search Console data. 

While some of these metrics are available inside GSC, building your own report gives you much more flexibility in how trends, comparisons, and supporting metrics are visualized together. 

You could also generate a bar chart with YoY rankings, or a heat map of rankings for keywords by month. Both examples are below.

Example SEO ranking report using Claude Code

What we like to include in our reporting is a combination of scorecards, time-series charts, year-over-year bar chart comparisons, and heat maps that break down the key drivers behind a metric. 

See the complete picture of your search visibility.

Track, optimize, and win in Google and AI search from one platform.

Start Free Trial
Get started with

Semrush One Logo

Claude Code completely transforms SEO reporting

SEO reporting has always been a push and pull between speed and flexibility. 

Dashboards are fast once they are built, but they are often rigid. Custom analysis is powerful but historically has been time-intensive. 

Claude Code changes everything. 

Now you can interact with your GSC data more dynamically, explore new questions as they arise, and create reporting views that would have previously taken hours to build manually. 

Once the initial setup is complete, reporting becomes far more adaptable to the needs of you and your stakeholders. 

Dig deeper: How to vibe-code an SEO tool without losing control of your LLM

Total
0
Shares
Leave a Reply

Your email address will not be published. Required fields are marked *

Previous Post

AI Engineering – All Things Product Podcast with Teresa Torres & Petra Wille

Next Post

A closer look at partial prerendering

Related Posts