Test with Avalyz from your tool

One link, zero clicks

This link fills in the address and starts the test by itself: paste it anywhere (3 free tests per day per visitor).

https://avalyz.com/essai?url=TON_URL

Lovable, Bolt, v0, Replit

Add this badge to your README or your page: one click on it runs a test of your app.

Markdown

[![Tested with Avalyz](https://avalyz.com/av/badge.svg)](https://avalyz.com/essai?url=TON_URL)

HTML

<a href="https://avalyz.com/essai?url=TON_URL"><img src="https://avalyz.com/av/badge.svg" alt="Tested with Avalyz"></a>

Claude Code, Cursor

Paste this block into CLAUDE.md (Claude Code) or .cursorrules (Cursor): your assistant tests the app after every deployment and reads the report.

## Avalyz acceptance test
After every deployment, test the app with Avalyz (read-only) and read the report.
1. Run the command below.
curl -sS --max-time 150 -X POST https://avalyz.com/api/v1/tests -H "Authorization: Bearer $AVALYZ_API_KEY" -H "Content-Type: application/json" -d '{"url":"TON_URL","attendre":true}'
2. Read the JSON that comes back: "verdict" (GO, GO SOUS CONDITIONS, NO-GO, INCONCLUSIF), "pourquoi" (why), "constats" (findings: severite S1 to S4, titre) and "rapport_url" (a path to append to https://avalyz.com).
3. If the verdict is not GO, fix the S1 and S2 findings, redeploy, then run it again.
If "etat" is "en_cours" (still running), read https://avalyz.com/api/v1/tests/<id> again with the same key.
TA_CLE is your Avalyz API key: keep it in the AVALYZ_API_KEY environment variable and never write it into the repository.

Claude Desktop, Cowork (MCP)

Download the MCP server and add this block to your configuration: Claude runs the tests and reads the reports itself.

1. Download the file (once)

curl -O https://avalyz.com/av/integrations/avalyz_mcp.py

2. Add this block to the MCP configuration, then restart the app

{
  "mcpServers": {
    "avalyz": {
      "command": "python3",
      "args": ["/CHEMIN/VERS/avalyz_mcp.py"],
      "env": { "AVALYZ_API_KEY": "TA_CLE" }
    }
  }
}

In Claude Code, one command replaces step 2:

claude mcp add avalyz -e AVALYZ_API_KEY=TA_CLE -- python3 /CHEMIN/VERS/avalyz_mcp.py

GitHub Actions

Paste this file into .github/workflows/avalyz.yml: the test runs after every deployment and the CI fails if the verdict is NO-GO.

on:
  deployment_status:
jobs:
  avalyz:
    if: github.event.deployment_status.state == 'success'
    runs-on: ubuntu-latest
    steps:
      - name: Avalyz
        run: curl -fsS https://avalyz.com/api/av/outils/recette_ci.py -o recette_ci.py && python3 recette_ci.py
        env:
          AVALYZ_URL: TON_URL
          AVALYZ_SERVEUR: https://avalyz.com
          AVALYZ_CLE: ${{ secrets.AVALYZ_API_KEY }}  # TA_CLE: your API key, stored in the repository secrets (AVALYZ_API_KEY).

Before you copy

Replace TON_URL with your app's address and TA_CLE with your API key (the "API keys" page of your account, 14-day trial with no card). Never write it into a repository: keep it in an environment variable or a secret.

The link and the badge need no key. The test stops where access stops: it plays no signed-in journey and submits no form.

Create my account