> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qwairy.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Outils d’audit de prospection

> Lisez les audits de prospection d’agence et les rapports des co-concurrents via le MCP.

<Note>
  Consultez [Compatibilité des filtres](/fr/mcp/tools/filters) pour le contrat de filtres de référence et la couverture de chaque outil MCP.
</Note>

Les outils d’audit de prospection exposent aux clients MCP les rapports d’avant-vente des agences. Ils sont en lecture seule : aucun des deux ne crée, ne confirme, ne relance ni ne modifie un audit.

## list\_pitch\_audits

Liste les audits de prospection des workspaces agence accessibles à l’utilisateur connecté.

### Paramètres

| Paramètre | Type | Requis | Description |
| - | - | - | - |
| `teamId` | string | Non | Limite la liste à un workspace agence accessible |
| `status` | string | Non | `PENDING`, `RUNNING`, `RECOVERING`, `AWAITING_PROMPTS`, `COMPLETED` ou `FAILED` |
| `limit` | number | Non | Nombre maximal d’audits, 20 par défaut et 100 au maximum |
| `offset` | number | Non | Décalage de pagination, 0 par défaut |

Le résultat contient l’identifiant de l’audit, le prospect, le statut, les scores, le nombre de prompts, les concurrents, les modèles IA sélectionnés, les horodatages et le workspace.

## get\_pitch\_audit

Lit le rapport complet d’un audit de prospection.

### Paramètres

| Paramètre | Type | Requis | Description |
| - | - | - | - |
| `auditId` | string | Oui | Identifiant d’audit renvoyé par `list_pitch_audits` |
| `subjectId` | string | Non | Sujet du rapport concurrent. Omettez-le pour le prospect d’origine |
| `includeAnswers` | boolean | Non | Inclut le texte complet des réponses IA. Désactivé par défaut pour limiter la taille du contexte |
| `includeCoCompetitorScores` | boolean | Non | Ajoute la synthèse complète des scores à chaque ligne de co-concurrent. Désactivé par défaut |

Le rapport contient les analyses notées des concurrents et des sources, les insights détectés, les recommandations, `availableSubjects` et `coCompetitors`. Les réponses IA complètes ne sont ajoutées que si `includeAnswers` vaut true.

Pour récupérer la liste complète des co-concurrents et comparer leurs scores en un seul appel :

```json theme={null}
{
  "auditId": "8a218180-6dd7-43c7-a481-f6a1cc72dfd8",
  "includeCoCompetitorScores": true
}
```

Lisez `audit.coCompetitors[].scores`. Laissez cette extension désactivée si vous n’avez besoin que des indicateurs de co-occurrence, plus légers.

### Ouvrir le rapport d’un co-concurrent

Chaque ligne de `coCompetitors` renvoie un `subjectId`. Réutilisez-le avec le même audit :

```json theme={null}
{
  "auditId": "8a218180-6dd7-43c7-a481-f6a1cc72dfd8",
  "subjectId": "rival.example"
}
```

Pour le prospect d’origine, omettez `subjectId` ou passez `self`.

### Exemples de prompts

```text theme={null}
Liste les audits de prospection terminés de mon workspace agence.
```

```text theme={null}
Ouvre le dernier audit de prospection, identifie son co-concurrent le plus fort, puis charge le rapport de ce co-concurrent.
```

### Scope OAuth

Les deux outils exigent `read:pitch-audits`.

<Note>
  Les connexions MCP existantes doivent se reconnecter et autoriser ce nouveau scope pour que ces outils apparaissent.
</Note>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.