clarvia-action

[](https://github.com/marketplace/actions/clarvia-aeo-score-check)

Check your API or MCP server's AEO (AI Engine Optimization) readiness score directly in your CI/CD pipeline. Clarvia evaluates four dimensions:

• API Accessibility — Can AI agents discover and reach your API?
• Data Structuring — Is your data formatted for machine consumption?
• Agent Compatibility — Does your API support agentic workflows?
• Trust Signals — Does your API provide verifiable trust indicators?

name: AEO Check
on: [push, pull_request]

jobs:
  aeo-scan:
    runs-on: ubuntu-latest
    steps:
      - uses: clarvia-project/clarvia-action@v1
        with:
          url: 'api.example.com'
          fail-under: '50'

| Input | Required | Default | Description | |-------|----------|---------|-------------| | url | Yes | — | URL to scan for AEO readiness | | fail-under | No | 0 | Minimum score threshold (fails the step if score is below) | | api-url | No | https://clarvia.art | Clarvia API base URL | | format | No | text | Output format: text, json, or sarif |

| Output | Description | |--------|-------------| | score | AEO score (0–100) | | rating | Rating: excellent, strong, moderate, or weak | | scan-id | Unique scan ID for referencing results | | badge-url | URL to the dynamic AEO badge SVG |

- uses: clarvia-project/clarvia-action@v1
  with:
    url: 'stripe.com'

- uses: clarvia-project/clarvia-action@v1
  with:
    url: 'api.example.com'
    fail-under: '60'

- uses: clarvia-project/clarvia-action@v1
  id: aeo
  with:
    url: 'api.example.com'

- run: echo "AEO Score is ${{ steps.aeo.outputs.score }}/100 (${{ steps.aeo.outputs.rating