Tools

Start an async agent-adoption scan

Changed on

Start an asynchronous AI agent-adoption scan for a public domain. Runs 25 checks across four categories — discoverability (robots.txt, sitemap.xml, Link headers), accessControl (AI bot rules, content signals, web-bot-auth, robots-allow-all), contentReadability (/llms.txt, markdown negotiation, rendering strategy, page size, redirects, agents.md, cache headers), and agentEndpoints (OpenAPI catalog, OAuth discovery, MCP server card, A2A agent card, agent skills). Returns sub-second with item: { id, status: "queued", createdAt, expiresAt } — poll GET /v1/tools/agent-adoption/scans/{scanId} until status is completed or failed. Most scans complete in 35–60 seconds; slow or JS-heavy domains can take up to ~3 minutes. Result and error payloads are persisted for 24h, after which the scan auto-deletes and GET returns 404. No project required. Suitable for AI-adoption audits, agent-adoption maturity assessments, and pre-launch agentic-commerce reviews — and the only supported shape for MCP clients (Cursor / Claude Desktop hardcode 60-second tool-call timeouts).

post/v1/tools/agent-adoption/scans

Request

  • Base URL: https://api.competlab.com
  • URL: https://api.competlab.com/v1/tools/agent-adoption/scans
  • Auth: API key in header CL-API-Key

Request body

domainstring required

Target domain to run the Agent Adoption Check against. Accepts a bare hostname or a full URL — normalized (lowercased, scheme and path stripped) before scanning.

debugModeboolean

When true, include the full HTTP trace (evidence) for every check in the response. Defaults to false.

includeFixPromptsboolean

When true, include a copy-paste remediation prompt (fixPrompt) for each failed, scored check. Defaults to false.

Example request

{
  "domain": "stripe.com"
}

Response

Example response

{
  "item": {
    "id": "6638e9a1b2c3d4e5f6a7b8c9",
    "status": "queued",
    "createdAt": "2026-05-17T14:30:00.000Z",
    "expiresAt": "2026-05-18T14:30:00.000Z"
  }
}

Changes

  • c9dadd2d3a30Revision changes
    • info

      added the non-success response with the status

  • b08f96c9300bRevision changes
    • warning

      added the new nothing_to_return enum value to the / response property for the response status

    • warning

      added the new paging_requires_compact_view enum value to the / response property for the response status

    • warning

      added the new paging_requires_summary enum value to the / response property for the response status