# SearchOps full machine-readable guide Version: 0.6.0 Canonical: https://searchops.platphormnews.com ## Product SearchOps owns technical SEO crawling, URL evidence, indexability labels, alert detection, Google Search Console comparison, and crawl-linked trace evidence for trusted PlatPhormNews sites. Its UI remains the operator dashboard for choosing a monitored site, inspecting real URL and alert data, running authenticated bounded crawls, and importing authenticated GSC exports. ## Public reads - GET /api/health and /api/v1/health - GET /api/sites - GET /api/dashboard?siteId= - GET /api/urls?siteId=&page=1&pageSize=20 - GET /api/alerts?siteId=&isResolved=false - GET /api/docs and /openapi.yaml - GET /api/mcp for MCP metadata ## MCP JSON-RPC 2.0 POST /api/mcp supports initialize, ping, tools/list, tools/call, resources/list, resources/read, prompts/list, and prompts/get. Registered tools are searchops_list_sites, searchops_validate_target, and searchops_get_dashboard. The target validator executes the real crawl trust and SSRF policy without navigating. The searchops://sites resource is backed by the monitored-site store. searchops_audit_site produces a read-only evidence workflow prompt. No MCP mutation tool is advertised. ## Protected operations POST /api/crawl, POST /api/gsc/import, POST /api/setup, and alert resolution require either Authorization: Bearer $PLATPHORM_API_KEY or X-PlatPhorm-API-Key: $PLATPHORM_API_KEY. Crawl targets are restricted to trusted PlatPhormNews domains plus explicit SEARCHOPS_ALLOWED_DOMAINS entries. Crawl breadth is capped at 500 URLs, crawl depth at 5, sitemap nesting at 4, discovery bodies at 2 MB, and HTML bodies at 5 MB. ## Data truth SearchOps reports live Aurora-backed data. When storage or Trace export is unavailable it returns an explicit degraded or unavailable state; it does not synthesize crawl runs, alerts, counts, or successful mutations. ## Discovery - https://searchops.platphormnews.com/llms-index.json - https://searchops.platphormnews.com/.well-known/mcp.json - https://searchops.platphormnews.com/.well-known/agents.json - https://searchops.platphormnews.com/.well-known/trust.json - https://searchops.platphormnews.com/sitemap-index.xml - https://searchops.platphormnews.com/sitemap-full.xml - https://searchops.platphormnews.com/sitemap-network.xml (bounded union of the root network graph and base sitemap index)