CrawlConsole public API - API Evangelist enhancements

overlay: 1.0.0
info:
  title: CrawlConsole public API - API Evangelist enhancements
  version: 1.0.0
extends: ../openapi/_original/crawlconsole-com-openapi.yml
x-provenance:
  generated: '2026-11-04'
  method: derived
  source:
  - https://crawlconsole.com/docs/api-reference/introduction
  - https://crawlconsole.com/docs/agents/mcp
actions:
- target: $
  description: Document the tags used by operations and link the docs.
  update:
    tags:
    - name: Backlinks
      description: Domain authority from the Common Crawl web graph.
    - name: WebMCP
      description: AI agent and WebMCP readiness checks for a public domain.
    - name: Agentic commerce
      description: Universal Commerce Protocol (UCP) readiness checks.
    externalDocs:
      description: CrawlConsole API reference
      url: https://crawlconsole.com/docs/api-reference/introduction
- target: $.info
  description: Record the documented error shape and that these checkers are public.
  update:
    x-error-format: 'JSON body {"error": "<message>"} with an appropriate HTTP status (per API reference introduction).'
    x-public-checkers: The docs describe these endpoints as public, narrowly scoped checkers; authenticated product and Agent APIs are separate.
- target: $.paths['/api/domain-score'].get
  description: Link the overlapping MCP tool.
  update:
    x-mcp-tool:
      server: https://crawlconsole.com/mcp
      tool: domain_authority
      confidence: medium