SDK, API & MCP
Query your Search Console history from code, spreadsheets or AI agents.
API calls this month
6,21462% of 10k limitp95 latency
184 ms↓ 22 ms vs last weekError rate
0.4%Mostly 429 rate limitsMCP sessions
138↑ 41 Claude, CursorConnect an AI agent over MCP
Works with Claude Desktop, Claude Code, Cursor and any MCP client
Claude Code
claude mcp add querydeck --transport http https://mcp.querydeck.io --header "Authorization: Bearer $QUERYDECK_KEY"
claude_desktop_config.json
{
"mcpServers": {
"querydeck": {
"url": "https://mcp.querydeck.io",
"headers": { "Authorization": "Bearer qd_live_…" }
}
}
}Tools exposed
search_performanceClicks, impressions, CTR, position with filterscompare_periodsDiff two windows by page or querylist_opportunitiesRanked opportunities with evidenceget_annotationsReleases, migrations and noteskeyword_clustersIntent clusters and their trendcreate_annotationWrite scope requiredTypeScript & Python SDK
Typed clients with pagination and retries built in
Install
npm install @querydeck/sdk # or: pip install querydeckindex.ts
import { QueryDeck } from '@querydeck/sdk'; const qd = new QueryDeck({ apiKey: process.env.QUERYDECK_KEY }); const rows = await qd.performance.query({ property: 'sc-domain:larkfield.com', dimensions: ['page'], range: { last: 28, compare: 'previous' }, orderBy: '-clicks_delta', limit: 10, }); // rows[0] → { page: '/guides/product-analytics', clicks: 18204, clicks_delta: 0.246 }
REST API
Base URL https://api.querydeck.io/v1
GET/propertiesList connected properties
POST/performance/queryQuery metrics with dimensions
GET/opportunitiesRanked opportunities
GET/annotationsList annotations
POST/annotationsCreate an annotation
DEL/annotations/{id}Delete an annotation
curl
curl https://api.querydeck.io/v1/performance/query \ -H "Authorization: Bearer $QUERYDECK_KEY" \ -d '{"property":"sc-domain:larkfield.com","dimensions":["query"],"range":{"last":28}}'
API keys
Keys inherit your organisation access
Looker sync
qd_live_8f2k…a91cRead2h agoClaude MCP
qd_live_c03e…77d0Read + write5m agoStaging tests
qd_test_19bb…0e42Test12d ago