QuerySail: Google Search Console MCP
ChatGPT, Claude, Codex 또는 Cursor에게 Google Search Console 데이터에 대해 물어보세요. 호스팅된 읽기 전용 MCP 서버로 OAuth를 지원합니다: 쿼리, 페이지, 국가, 기기별 검색 성과, 기간 비교, URL 검사 및 사이트맵. API 키가 필요 없고 설치도 필요 없습니다.
호스팅형 MCP 서버
npx add-mcp 'https://mcp.querysail.com/gsc/mcp'Claude Code, Codex, Cursor 등에 설치됩니다
문서
QuerySail: Google Search Console MCP server
QuerySail is a hosted MCP server for Google Search Console. Connect it to ChatGPT, Claude, Codex, Cursor or VS Code, sign in, connect your Google account once, and ask about your search traffic in plain language. There is nothing to install and no API key to paste.
- Endpoint:
https://mcp.querysail.com/gsc/mcp(Streamable HTTP, OAuth 2.1 with dynamic client registration) - Website: https://querysail.com/google-search-console
- Pricing: 7-day free trial, no card required, then $8/month. See https://querysail.com/pricing.
This repository holds the public listing files (MCP Registry server.json, a Claude Code plugin, client configs). The service itself is hosted at querysail.com; its source is not published here.
Tools
All tools are read-only. QuerySail cannot submit sitemaps, request indexing or change any Search Console setting.
| Tool | What it does |
|---|---|
list_properties | Lists the Search Console properties your connected Google accounts can read, with exact IDs and permission level. |
get_performance | Clicks, impressions, CTR and average position, as totals or by date, hour, query, page, country, device or search appearance, with filters. Covers web, image, video, news, Discover and Google News results. |
compare_performance | Compares two periods (previous period, same weekdays a year earlier, or custom dates) and lists the queries, pages, countries or devices that gained or lost the most. |
inspect_urls | Inspects up to 20 URLs: whether each is on Google, why not, last crawl, robots.txt and noindex blocking, and the canonical Google chose. |
list_sitemaps | Lists submitted sitemaps with when Google last read them, URL counts, errors and warnings. |
Example prompts
- Which of my pages got the most clicks from Google in the last 28 days?
- What changed in my search traffic compared with the previous 28 days?
- Is my homepage indexed on Google, and which canonical did Google choose?
- Which queries rank on page two for my blog, sorted by impressions?
Setup
You need a QuerySail account with Google Search Console connected: sign up at https://querysail.com. Each client below opens a browser window to sign in the first time.
Claude Code
claude mcp add --transport http --scope user querysail-gsc https://mcp.querysail.com/gsc/mcp
Then run /mcp, choose querysail-gsc and sign in. Or install it as a plugin, which also adds a Search Console analysis skill:
/plugin marketplace add querysail/querysail-gsc
/plugin install querysail-gsc@querysail
Claude Desktop and claude.ai
Open Customize → Connectors, select + Add → Add custom connector, name it QuerySail and paste https://mcp.querysail.com/gsc/mcp as the server URL.
ChatGPT
Turn on Developer mode under Settings → Security and login, go to chatgpt.com/plugins, select the plus button and paste the endpoint as the connection URL.
Grok
Go to grok.com/connectors, select New Connector → Custom, paste https://mcp.querysail.com/gsc/mcp as the MCP server URL and sign in. On Grok Business and Enterprise plans a team admin first adds it at console.x.ai under Grok Business → Connectors.
Codex
codex mcp add querysail-gsc --url https://mcp.querysail.com/gsc/mcp
codex mcp login querysail-gsc
Cursor
Add to ~/.cursor/mcp.json:
{
"mcpServers": {
"querysail-gsc": { "url": "https://mcp.querysail.com/gsc/mcp" }
}
}
VS Code
Run MCP: Add Server, choose HTTP and paste the endpoint, or add to mcp.json:
{
"servers": {
"querysail-gsc": { "type": "http", "url": "https://mcp.querysail.com/gsc/mcp" }
}
}
Cline
Open MCP Servers → Remote Servers, name it querysail-gsc, paste the endpoint, choose Streamable HTTP and click Add Server. Or add to cline_mcp_settings.json:
{
"mcpServers": {
"querysail-gsc": { "type": "streamableHttp", "url": "https://mcp.querysail.com/gsc/mcp" }
}
}
Sign in with your QuerySail account when Cline asks.
Clients that only run local commands
Use the mcp-remote bridge (needs Node.js):
{
"mcpServers": {
"querysail-gsc": { "command": "npx", "args": ["mcp-remote", "https://mcp.querysail.com/gsc/mcp"] }
}
}
Agent skill
The querysail-search-console skill tells coding agents such as Claude Code, Codex, Cursor and OpenCode which QuerySail tool to call for each question and how to report the numbers. Install it with the skills CLI (needs Node.js):
npx skills add https://querysail.com --skill querysail-search-console
Data and limits
- Google access uses the
webmasters.readonlyscope. Refresh tokens are encrypted at rest. You can disconnect Google or delete your account at any time. - Search Console keeps about 16 months of data; hourly data covers the last 10 days; Google returns only top rows for query and page breakdowns.
- Privacy: https://querysail.com/privacy · Terms: https://querysail.com/terms · Support: https://querysail.com/support
License
The files in this repository are MIT licensed. The QuerySail service is subject to its terms.