# Google Search Console through toolfare

> The queries and pages that earn your organic clicks, average position day by day, any breakdown by query, page, country or device, and how Google sees a single URL — answered inside ChatGPT, Claude, Codex or Cursor. Connect your Search Console property to toolfare once; your AI reads it with your own login, and every read is free.

Page: https://toolfare.ai/google-search-console

## Use it from your agent

Paste this into Claude Code, Codex, Cursor or any agent with a shell:

> Set up https://toolfare.ai/skill.md, then use toolfare to answer: What did people search to find us last month?

Apps without a terminal connect toolfare as an MCP server: https://toolfare.ai/docs#connect

## Use it from a script

```sh
mkdir -p ~/.local/bin
curl -fsSL 'https://toolfare.ai/toolfare/toolfare.mjs' -o ~/.local/bin/toolfare
chmod +x ~/.local/bin/toolfare
export PATH="$HOME/.local/bin:$PATH"
export TOOLFARE_MCP_URL='https://api.toolfare.ai/mcp'
toolfare login
```

Then connect your Google Search Console account in the toolfare console (https://toolfare.ai/google-search-console#setup); calls fail until it is connected.

Sign in once per machine; the CLI renews the sign-in itself. On a CI runner or another server, create an API key in the toolfare console and set it as `TOOLFARE_API_KEY` instead of signing in. Paid calls on one sign-in or key run one at a time. `--max-cost` refuses a call quoted above that many credits (1,000 credits = $3).

## Tools

### The searches that bring people in

Tool: `gsc_list_top_queries`

Top Google queries for a date range with clicks, impressions, click-through rate and average position.

Ask:
- What did people search to find us last month?
- Which queries get impressions but almost no clicks?

### The pages that earn organic clicks

Tool: `gsc_list_top_pages`

Every URL with organic impressions and clicks over a date range, sorted by clicks, with its average position.

Ask:
- Which pages get the most clicks from Google?
- Which of our pages lost the most clicks this week?

### Any breakdown, with filters

Tool: `gsc_query_search_analytics`

Search performance grouped by any mix of query, page, country, device and date, filtered however you need — only queries containing your own name, only one country, image search instead of web.

Ask:
- Which queries does our pricing page rank for, by country?
- Show clicks by device for the last 28 days, leaving out queries with our own name in them.

### Clicks and position, day by day

Tool: `gsc_get_daily_trend`

A daily series of clicks, impressions, CTR and position for the property — the shape of a drop, with a date on it.

Ask:
- When did our organic clicks start falling?
- Chart our average position over the last three months.

### How Google sees one URL

Tool: `gsc_inspect_url`

Whether a page is indexed and why not, the canonical Google chose, the last crawl, mobile usability and rich-result status.

Ask:
- Is this page indexed, and if not, why?
- Which canonical did Google pick for this URL?

### Whether your sitemaps are healthy

Tool: `gsc_list_sitemaps`

Submitted sitemaps with their status, warnings, errors, and submitted against indexed counts.

Ask:
- Do any of our sitemaps have errors?
- How many submitted URLs are actually indexed?

### Also available

- `gsc_list_sites`: The Search Console properties your toolfare account can read

## Price

Free to read: it is your own account, so toolfare pays nobody for the data and charges nothing per read. No per-read charge to observe. Reads need no purchase. Like every toolfare call, they run only while your balance holds at least $0.003, and that is not spent.

Balances and top-ups are in US dollars. Quotes and `--max-cost` count credits: 1,000 credits = $3 ($0.003 each).

## Use it when

- Organic traffic dropped and you want the queries and pages that moved.
- You want queries with impressions but few clicks — the titles worth rewriting.
- A page is not ranking and you want to know whether Google has even indexed it.
- You want position over time, not a single snapshot.

## Look elsewhere when

- You want what the visitors did after landing. That is GA4.
- You want who outranks you right now. Search Console only reports on your own property — ask a live results source.
- You want a competitor’s keywords or backlinks. That is a third-party index.
- You want to request indexing or submit a sitemap. This connection is read-only.

## Limits

- URL inspection is capped by Google at roughly 2,000 inspections a day per property, so it answers about specific pages, not a whole site.
- A property has to be addressed exactly as Search Console names it — a domain property and a URL-prefix property are different properties.
- Days with no organic activity are absent from the daily series rather than returned as zero.
- Only properties you connected are readable.
