Good Marketer audits a site and hands back findings your agent can cite -- the exact page, the exact tag, the exact fix. No signup wall on the audit itself. Free, same as the dashboard.
Every response cites the exact page it came from. Nothing here is a black box your agent has to trust blind.
Starts a site audit. Returns an id right away -- the audit runs in the background.
{ "url": "example.com" }{
"status": "ok",
"scan_id": "5b1f3c2a-...",
"scan_status": "pending"
}also returns: invalid_url email_not_confirmed server_busy
Fetches the full scored report: score, per-category subscores, and every finding with a source_url citing the exact page.
{ "scan_id": "5b1f3c2a-..." }{
"status": "ok",
"scan_id": "5b1f3c2a-...",
"requested_url": "https://example.com",
"final_url": "https://example.com/",
"score": 68,
"grade": "Fair",
"subscores": { "technical": 74, "onpage": 60, "performance": 55, "..." : "..." },
"counts": { "critical": 2, "warning": 6, "opportunity": 9 },
"findings": [
{
"id": "onpage.missing_meta_description",
"category": "onpage",
"severity": "critical",
"title": "Missing meta description",
"detail": "Search engines write their own snippet when this is missing, which usually converts worse than one you control.",
"evidence": "No <meta name=\"description\"> tag found in the page <head>.",
"suggestion": "Add a unique 150-160 character meta description summarizing this page's value.",
"source_url": "https://example.com/"
}
],
"scanned_at": "2026-08-01T14:30:12Z"
}also returns: not_found not_ready failed
Fetches a prioritized, capped top-20 fix list -- same findings, critical-first, with full uncapped counts so a short list never understates scope.
{ "scan_id": "5b1f3c2a-..." }{
"status": "ok",
"scan_id": "5b1f3c2a-...",
"counts": { "critical": 0, "warning": 0, "opportunity": 0 },
"returned_count": 0,
"findings": [],
"scanned_at": "2026-08-01T14:30:12Z"
}also returns: not_found not_ready failed
Estimates AI-answer-engine visibility: four measured signals, plus a brand-recognition score with its one estimated component always labeled, never hidden.
{ "scan_id": "5b1f3c2a-..." }{
"status": "ok",
"scan_id": "5b1f3c2a-...",
"domain": "example.com",
"overall_score": 54,
"measured_signals": [
{ "id": "open_web_corpus", "label": "Open-web corpus (Common Crawl)", "value": "12 pages", "pct": 24, "measured": true, "...": "..." }
],
"brand_recognition": {
"blended_score": 41,
"blended_estimate": true,
"measured_components": [
{ "id": "domain_authority", "measured": true, "value": 22, "...": "..." }
],
"estimated_component": {
"id": "ai_knowledge_probe",
"measured": false,
"knowledge_level": "no",
"caveat": "Single query to our self-hosted model (Ollama). Not a live check of ChatGPT, Perplexity, or Gemini -- treat as directional only."
}
},
"buyer_prompts": { "estimated": true, "caveat": "...", "items": ["..."] },
"scanned_at": "2026-08-01T14:30:12Z"
}also returns: not_found not_ready failed
A remote server -- no local process to run, no stdio launch command. Point your client at the URL below with your API key in the Authorization header.
{
"mcpServers": {
"good-marketer": {
"type": "http",
"url": "https://goodmarketer.ca/api/mcp/",
"headers": {
"Authorization": "Bearer gm_live_YOUR_KEY_HERE"
}
}
}
}Save as .mcp.json in your project, or run: claude mcp add --transport http good-marketer https://goodmarketer.ca/api/mcp/ --header "Authorization: Bearer gm_live_YOUR_KEY_HERE"
{
"mcpServers": {
"good-marketer": {
"url": "https://goodmarketer.ca/api/mcp/",
"headers": {
"Authorization": "Bearer gm_live_YOUR_KEY_HERE"
}
}
}
}Save as ~/.cursor/mcp.json (or .cursor/mcp.json in your project), then reload Cursor.
[mcp_servers.good-marketer]
url = "https://goodmarketer.ca/api/mcp/"
bearer_token_env_var = "GOOD_MARKETER_API_KEY"Add to ~/.codex/config.toml, then export GOOD_MARKETER_API_KEY="gm_live_YOUR_KEY_HERE" in your shell before launching Codex.
{
"mcpServers": {
"good-marketer": {
"serverUrl": "https://goodmarketer.ca/api/mcp/",
"headers": {
"Authorization": "Bearer gm_live_YOUR_KEY_HERE"
}
}
}
}Save as ~/.codeium/windsurf/mcp_config.json, then restart Windsurf.
Request-header auth is a beta feature at Anthropic and is still rolling out account-by-account -- if you don’t see "Request headers" in the dialog, it isn’t enabled for your account yet.
This is a small, young service -- no uptime guarantee yet. It will tell you honestly if something's down.