FOR DEVELOPERS & AI AGENTS

API & MCP SERVER

SEO Bandwagon exposes a remote MCP (Model Context Protocol) server and a small public REST API. Connect Claude or any MCP client to query your Google Search Console data and tracked keyword rankings programmatically.

MCP SERVER

  • Endpoint: https://seobandwagon.com/api/mcp
  • Transport: streamable HTTP
  • Auth: Authorization: Bearer sbw_<48 hex characters>

Example (Claude Code):

claude mcp add --transport http seobandwagon https://seobandwagon.com/api/mcp \
  --header "Authorization: Bearer sbw_<your key>"

API keys are issued per SEO Bandwagon account and shown once at creation. There is no self-serve key page yet — contact us to request one. All tools return data scoped to your account; unauthenticated requests receive 401.

AVAILABLE TOOLS

TOOLDESCRIPTION
gsc_connection_statusCheck whether the authenticated SEO Bandwagon user has a working Google Search Console connection (returns connected/needsReauth).
gsc_list_sitesList the Google Search Console properties the authenticated user has access to.
gsc_search_analyticsQuery Google Search Console search analytics for a property. Returns rows of clicks, impressions, CTR, and position grouped by the requested dimensions. Use gsc_list_sites first to find valid siteUrl values (e.g. 'sc-domain:example.com').
rank_tracker_keywordsList the authenticated user's tracked keywords from the SEO Bandwagon rank tracker, with last known Google position, search volume, and GSC metrics. Optionally filter by domain.
rank_tracker_historyGet historical Google position checks (serp_history) for a domain the authenticated user tracks, optionally filtered to one keyword. Note: positions are only recorded when a rank check runs.

PUBLIC REST API

The captures API stores and retrieves on-page SEO analyses from the SEO Bandwagon Chrome extension. No authentication required.

  • POST /api/v1/captures — ingest a full SEO analysis payload. Same-URL captures are deduped within one hour (409).
  • GET /api/v1/captures?url=… — fetch up to 50 captures for a URL, matching across protocol, www, and trailing-slash variants.

MACHINE-READABLE DISCOVERY

Agents can discover these services automatically: