ROAS Expert free AI SEO audit

Runs the free ROAS Expert audit on a public website and returns the score out of 100, the grade, the detected platform, category scores, the top three issues, the status of all 48 checks and a shareable report link. The detail and the platform-specific fix for every failing or warning check are unlocked with the user's work email through unlock_report. Takes 10 to 25 seconds. Use the domain or homepage URL, not a deep link. Free plan: a few audits per day per client.

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "Domain or homepage URL, for example example.com or https://www.example.com"
    }
  },
  "required": [
    "url"
  ],
  "additionalProperties": false
}

Returns a previously run audit by its id (the last part of a tools.roasexpert.com/r/<id> link). Locked reports show the top three issues and check statuses; unlocked reports show every finding with its fix and the written summary. Reports are kept for 90 days. No usage limit.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Report id, 8 characters"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

Unlocks a report: every failing and warning check with its detail and the fix written for the detected platform, plus the written summary. The email goes to ROAS Expert's CRM with the report link and gets at most one follow-up about the findings. Only call this with an email the user gave you for this purpose. No usage limit.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Report id from audit_site"
    },
    "email": {
      "type": "string",
      "description": "The user's work email address"
    }
  },
  "required": [
    "id",
    "email"
  ],
  "additionalProperties": false
}

The catalogue of checks the audit runs, grouped by category with weights and a one-line description of what passes. Use it to explain a score or to see what the audit covers. No usage limit.

{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "enum": [
        "crawl",
        "onpage",
        "schema",
        "ai",
        "speed"
      ],
      "description": "Optional category filter"
    }
  },
  "additionalProperties": false
}

Returns the fix text for one check id (from list_checks or a report) written for a platform: shopify, wordpress, magento, framer, webflow, wix, squarespace, bigcommerce, hubspot, nextjs or generic. No usage limit.

{
  "type": "object",
  "properties": {
    "check_id": {
      "type": "string",
      "description": "Check id, for example ai_bots, product_schema, llms_txt"
    },
    "platform": {
      "type": "string",
      "description": "Platform key or CMS name; defaults to generic"
    }
  },
  "required": [
    "check_id"
  ],
  "additionalProperties": false
}