> ## 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 de sources

> Outils pour analyser les domaines et URL que les fournisseurs IA citent comme sources.

<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>

## get\_source\_domains

Obtient les domaines que l’IA cite comme sources, classés par fréquence de mention.

### Paramètres

| Paramètre | Type | Requis | Description |
| - | - | - | - |
| `brandId` | string | Oui | L’identifiant de marque |
| `domain` | string | Non | Recherche sur une partie du nom de domaine |
| `type` | string | Non | Filtre par type de source (voir ci-dessous) |
| `isSelf` | boolean | Non | Limite à votre domaine (`true`) ou aux autres (`false`) |
| `limit` | number | Non | Nombre maximal de domaines (par défaut : 50, maximum : 100) |

### Types de source

| Type | Description |
| - | - |
| `INSTITUTIONAL` | Administrations, ONG, associations et organismes professionnels |
| `COMMERCIAL` | Entreprises, boutiques en ligne, produits SaaS, agences et sites institutionnels d’entreprise |
| `MEDIA` | Rédactions, journaux, magazines, diffuseurs et éditeurs à vocation journalistique |
| `BLOG` | Blogs centrés sur des articles, qui ne sont ni des rédactions ni des références |
| `FORUM` | Plateformes de discussion, de questions-réponses et communautés (Reddit, Quora) |
| `SOCIAL` | Plateformes de profils, de fils d’actualité et de créateurs |
| `EDUCATIONAL` | Écoles, universités, plateformes de cours et ressources pédagogiques |
| `REFERENCE` | Documentation, wikis, encyclopédies, dictionnaires, normes, archives et bases de connaissances |
| `OTHER` | Une vocation identifiée qui ne correspond à aucun des types ci-dessus |

### Résultat

| Champ | Type | Description |
| - | - | - |
| `id` | string | Identifiant du domaine source |
| `domain` | string | Le nom de domaine |
| `name` | string | Nom affiché (s’il est connu) |
| `type` | string | Type de source |
| `mentions` | number | Nombre total de citations |
| `avgPosition` | number | Position moyenne dans les listes de sources |
| `aiSourceAuthorityScore` | number | Score d’autorité de la source calculé par Qwairy (0 à 100), ou `null` s’il n’est pas disponible |
| `isSelf` | boolean | Indique s’il s’agit de votre domaine |
| `hasBacklink` | boolean | Indique s’il existe une opportunité de backlink |

### Exemple de sortie

```markdown theme={null}
## Source domains cited by AI

| Domain | Type | Mentions | Avg Position | AI Authority | Self | Backlink |
|--------|------|----------|--------------|--------------|------|----------|
| reviews.example | COMMERCIAL | 234 | 1.8 | 87.4 | No | Yes |
| acme.example | COMMERCIAL | 198 | 2.3 | 82.1 | Yes | - |
| software-guide.example | COMMERCIAL | 156 | 2.5 | 78.6 | No | No |
| techcrunch.com | MEDIA | 89 | 3.1 | 72.3 | No | No |
| reddit.com | FORUM | 67 | 4.2 | 68.9 | No | No |
| wikipedia.org | INSTITUTIONAL | 45 | 2.8 | 74.5 | No | No |
```

### Exemples de prompts

```text theme={null}
Quelles sources les fournisseurs IA citent-ils le plus souvent ?
```

```text theme={null}
Mon domaine est-il cité comme source ?
```

```text theme={null}
Montre-moi uniquement les sources média
```

```text theme={null}
Quels forums sont cités sur mes Topics ?
```

<Tip>
  Les domaines avec `hasBacklink: true` ont des opportunités connues sur la marketplace de backlinks. Envisagez-les pour vos actions de prospection.
</Tip>

<Note>
  `aiSourceAuthorityScore` est le score propriétaire de Qwairy, fondé uniquement sur la façon dont les fournisseurs IA citent un domaine dans les prompts suivis. Il n’utilise ni les backlinks ni les indicateurs d’autorité SEO externes.
</Note>

### Scope OAuth

Requis : `read:sources`

***

## get\_source\_urls

Obtient les URL précises que l’IA cite comme sources, avec leur fréquence de citation.

### Paramètres

| Paramètre | Type | Requis | Description |
| - | - | - | - |
| `brandId` | string | Oui | L’identifiant de marque |
| `domain` | string | Non | Filtre sur un domaine précis |
| `limit` | number | Non | Nombre maximal d’URL (par défaut : 50, maximum : 100) |

### Résultat

| Champ | Type | Description |
| - | - | - |
| `url` | string | L’URL complète |
| `title` | string | Titre de la page (s’il est disponible) |
| `domain` | string | Le domaine |
| `mentions` | number | Nombre de citations |
| `avgPosition` | number | Position moyenne dans les listes de sources |

### Exemple de sortie

```markdown theme={null}
## Source URLs cited by AI

### 1. reviews.example
URL: https://reviews.example/project-management
Title: Best Project Management Software 2025
Mentions: 89
Avg Position: 1.5

### 2. acme.example
URL: https://www.acme.example/features
Title: Acme Corp Features
Mentions: 72
Avg Position: 2.1

### 3. software-guide.example
URL: https://software-guide.example/project-management
Title: Project Management Software Reviews
Mentions: 56
Avg Position: 2.3

### 4. acme.example
URL: https://www.acme.example/blog/productivity-guide
Title: The Ultimate Productivity Guide
Mentions: 34
Avg Position: 3.4
```

### Exemples de prompts

```text theme={null}
Quelles pages précises les fournisseurs IA citent-ils ?
```

```text theme={null}
Lesquelles de mes pages sont les plus citées ?
```

```text theme={null}
Montre-moi les URL de wikipedia.org qui sont citées
```

```text theme={null}
Quels fils Reddit sont cités ?
```

<Note>
  Utilisez le filtre `domain` pour examiner une source en particulier. Par exemple, filtrez sur votre propre domaine pour voir à quelles pages de votre site l’IA fait le plus confiance.
</Note>

### Scope OAuth

Requis : `read:sources`

***

## get\_source\_trends

Suit les domaines sources qui gagnent ou perdent des citations dans les réponses IA. L’outil compare la période sélectionnée à la période précédente de même durée, renvoie une chronologie quotidienne ou hebdomadaire des principales sources et présente la répartition actuelle par type de source.

### Paramètres

| Paramètre | Type | Requis | Description |
| - | - | - | - |
| `brandId` | string | Oui | L’identifiant de marque issu de `list_brands` |
| `period` | integer ou string | Non | Fenêtre d’analyse globale ; 30 jours par défaut |
| `groupBy` | string | Non | Granularité de la chronologie : `day` ou `week` (par défaut : `day`) |
| `provider` | string | Non | Filtre par fournisseur IA normalisé |
| `topicId` | string | Non | Filtre par identifiant de Topic issu de `list_topics` |
| `tagId` | string | Non | Filtre par identifiant de Tag issu de `list_tags` |
| `limit` | number | Non | Nombre maximal de domaines sources dans la chronologie (par défaut : 5, maximum : 10) |

### Résultat

| Champ | Description |
| - | - |
| `summary` | Total des citations et domaines sources distincts sur la période sélectionnée |
| `sources[]` | Principaux domaines avec type de source, citations actuelles, citations de la période précédente et variation en pourcentage |
| `timeline[]` | Citations quotidiennes ou hebdomadaires et position moyenne de citation pour chaque source principale |
| `sourceTypes[]` | Nombre et part des citations pour chaque type de source |

Lorsqu’une source a des citations sur la période sélectionnée mais aucune sur la période précédente, `changePercent` vaut `null` au lieu d’un pourcentage de croissance inventé.

### Exemples de prompts

```text theme={null}
Quelles sources gagnent ou perdent des citations ce mois-ci ?
```

```text theme={null}
Montre les tendances des sources par semaine, pour ChatGPT uniquement
```

```text theme={null}
Comment la répartition par type de source a-t-elle évolué sur ce Topic ?
```

### Scope OAuth

Requis : `read:sources`

***

## get\_backlink\_opportunities

Cibles de backlinks et de prospection classées par priorité : domaines cités où les concurrents apparaissent mais pas votre marque, avec les prix de la marketplace et le domain rating lorsqu’ils sont disponibles. Utilisez-le pour planifier votre netlinking et vos relations presse digitales.

### Paramètres

| Paramètre | Type | Requis | Description |
| - | - | - | - |
| `brandId` | string | Oui | L’identifiant de marque issu de `list_brands` |
| `limit` | number | Non | Nombre maximal d’opportunités renvoyées (par défaut : 20, maximum : 50) |

### Résultat

| Champ | Description |
| - | - |
| `summary` | Nombre d’opportunités `total`, `veryHigh` et `high` |
| `opportunities[]` | Par domaine : `domain`, `name`, `type`, `mentions`, `brandCitedAnswers`, `competitorCitedAnswers`, `distinctCompetitors`, `priority` (`very-high`/`high`/`medium`/`low`), `bestPrice`, `domainRating`, `platforms[]` |

### Exemples de prompts

```text theme={null}
Quelles sont mes meilleures opportunités de backlinks en ce moment ?
```

```text theme={null}
Quels domaines à forte autorité citent mes concurrents mais pas moi ?
```

### Scope OAuth

Requis : `read:sources`


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