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

# Tines

> Appelez les fonctions de recherche, d'extraction, d'extraction structurée, de cartographie et de crawl de Firecrawl depuis vos stories Tines grâce aux actions HTTP Request

<Note>
  **Documentation Tines :** [Identifiants](https://www.tines.com/docs/actions/types/http-request/) et [Identifiants](https://www.tines.com/docs/credentials/)

  Intégrez des données web en temps réel de Firecrawl à vos stories Tines
</Note>

<h2 id="overview">
  Vue d’ensemble
</h2>

Les stories Tines peuvent appeler n’importe quelle API REST via l’action HTTP Request. En configurant cette action pour qu’elle cible l’API Firecrawl, une story peut rechercher sur le web, extraire le contenu d’une page au format markdown, récupérer des données structurées, cartographier un site ou le crawler, puis transmettre le résultat à l’action suivante de la story.

<h2 id="quick-start">
  Démarrage rapide
</h2>

1. [Créez une clé API Firecrawl](https://www.firecrawl.dev/app/api-keys)
2. Dans Tines, ouvrez **Identifiants**, créez un identifiant de type **Text** nommé `firecrawl` et collez-y la clé comme valeur
3. Ajoutez une action **HTTP Request** à votre story et configurez-la comme indiqué ci-dessous

En référençant la clé sous la forme `<<CREDENTIAL.firecrawl>>`, vous évitez qu’elle apparaisse dans la configuration de l’action.

<h2 id="scrape-a-page">
  Extraire le contenu d’une page
</h2>

Cette action envoie une requête de scraping et renvoie la page au format markdown :

```json theme={null}
{
  "url": "https://api.firecrawl.dev/v2/scrape",
  "method": "post",
  "content_type": "json",
  "headers": {
    "Authorization": "Bearer <<CREDENTIAL.firecrawl>>"
  },
  "payload": {
    "url": "https://example.com",
    "formats": ["markdown"],
    "integration": "_tines"
  }
}
```

Remplacez `https://example.com` par une URL issue d'un événement en amont, par exemple `<<receive_event.body.url>>`. Le champ facultatif `integration` permet d'identifier les requêtes provenant de Tines.

<h2 id="what-you-can-do">
  Ce que vous pouvez faire
</h2>

| Fonctionnalité | Point de terminaison | Cas d’utilisation |
| - | - | - |
| **Recherche** | `POST /v2/search` | Trouver des sources sur une question ou une alerte avant d’enchaîner d’autres actions |
| **Extraire** | `POST /v2/scrape` | Convertir une URL en markdown ou en JSON structuré |
| **Extraire** | `POST /v2/scrape` avec un format `json` | Récupérer des champs, comme un titre ou les détails d’un produit, à l’aide d’un prompt et d’un schéma |
| **Cartographier** | `POST /v2/map` | Lister les URL d’un site |
| **Crawl** | `POST /v2/crawl` | Collecter les pages de tout un site, puis interroger l’API pour obtenir le résultat |

Tous les points de terminaison utilisent l’URL de base `https://api.firecrawl.dev`, le même en-tête `Authorization` et un corps JSON.

<h2 id="search-the-web">
  Rechercher sur le Web
</h2>

```json theme={null}
{
  "url": "https://api.firecrawl.dev/v2/search",
  "method": "post",
  "content_type": "json",
  "headers": {
    "Authorization": "Bearer <<CREDENTIAL.firecrawl>>"
  },
  "payload": {
    "query": "firecrawl web scraping",
    "limit": 5,
    "sources": ["web"],
    "integration": "_tines"
  }
}
```

<h2 id="extract-structured-data">
  Extraire des données structurées
</h2>

Dans `formats`, définissez une entrée de type `json` avec un prompt et un schéma JSON :

```json theme={null}
{
  "url": "https://api.firecrawl.dev/v2/scrape",
  "method": "post",
  "content_type": "json",
  "headers": {
    "Authorization": "Bearer <<CREDENTIAL.firecrawl>>"
  },
  "payload": {
    "url": "https://example.com",
    "formats": [
      {
        "type": "json",
        "prompt": "Extract the page title",
        "schema": {
          "type": "object",
          "properties": { "title": { "type": "string" } }
        }
      }
    ],
    "integration": "_tines"
  }
}
```

<h2 id="crawl-a-site">
  Crawler un site
</h2>

Un crawl s'exécute de manière asynchrone : une première action permet de le démarrer, une seconde d'en lire le résultat.

**Démarrez le crawl** avec `POST /v2/crawl` :

```json theme={null}
{
  "url": "https://api.firecrawl.dev/v2/crawl",
  "method": "post",
  "content_type": "json",
  "headers": {
    "Authorization": "Bearer <<CREDENTIAL.firecrawl>>"
  },
  "payload": {
    "url": "https://example.com",
    "limit": 10,
    "integration": "_tines"
  }
}
```

La réponse contient un `id`. **Vérifiez l'état** à l'aide d'une deuxième action HTTP Request qui récupère le crawl correspondant à cet `id`, et répétez-la jusqu'à ce que `status` vaille `completed` :

```json theme={null}
{
  "url": "https://api.firecrawl.dev/v2/crawl/<<start_crawl.body.id>>",
  "method": "get",
  "headers": {
    "Authorization": "Bearer <<CREDENTIAL.firecrawl>>"
  }
}
```

Ici, `start_crawl` est le nom de l'action qui a démarré le crawl.

<h2 id="resources">
  Ressources
</h2>

* [Action HTTP Request de Tines](https://www.tines.com/docs/actions/types/http-request/)
* [Identifiants Tines](https://www.tines.com/docs/credentials/)
* [Introduction à l'API Firecrawl](/fr/api-reference/v2-introduction)
* [Documentation Firecrawl sur l'extraction](/fr/features/scrape)
* [Documentation Firecrawl sur le crawl](/fr/features/crawl)


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