Tines

Documentation Tines : Identifiants et IdentifiantsIntégrez des données web en temps réel de Firecrawl à vos stories Tines

Vue d’ensemble

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.

Démarrage rapide

Créez une clé API Firecrawl
Dans Tines, ouvrez Identifiants, créez un identifiant de type Text nommé firecrawl et collez-y la clé comme valeur
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.

Extraire le contenu d’une page

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

{
  "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.

Ce que vous pouvez faire

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.

Rechercher sur le Web

{
  "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"
  }
}

Extraire des données structurées

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

{
  "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"
  }
}

Crawler un site

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 :

{
  "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 :

{
  "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.

Prise en main

Points de terminaison de base

Plus

Démarrages rapides

Guides développeur

Webhooks

Cas d'utilisation

Autres

Contribuer

Vue d’ensemble

Démarrage rapide

Extraire le contenu d’une page

Ce que vous pouvez faire

Rechercher sur le Web

Extraire des données structurées

Crawler un site

Ressources

​Vue d’ensemble

​Démarrage rapide

​Extraire le contenu d’une page

​Ce que vous pouvez faire

​Rechercher sur le Web

​Extraire des données structurées

​Crawler un site

​Ressources

Vue d’ensemble

Démarrage rapide

Extraire le contenu d’une page

Ce que vous pouvez faire

Rechercher sur le Web

Extraire des données structurées

Crawler un site

Ressources