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

# Intégration Olostep + Raycast

> Ajoutez le scraping web, la recherche, le crawling et les réponses IA à Raycast AI avec le serveur MCP officiel d’Olostep

Raycast est le lanceur de productivité utilisé par les développeurs, opérateurs et utilisateurs avancés de l'IA. Avec le support natif de Raycast pour le Model Context Protocol (MCP), le **serveur MCP officiel d'Olostep** s'intègre directement dans Raycast AI — offrant à votre lanceur des outils de données web en direct que vous pouvez appeler depuis AI Chat, Quick AI, et AI Commands avec une simple mention `@olostep`.

Olostep est une [entrée officielle dans le registre MCP de Raycast](https://www.raycast.com/), vous pouvez donc l'ajouter en quelques clics — aucun fichier de configuration à modifier.

## Fonctionnalités

Le serveur MCP d'Olostep donne à votre Raycast AI l'accès aux capacités principales de données web d'Olostep :

<CardGroup cols={2}>
  <Card title="Scraper un site web" icon="file-lines">
    Extraire le contenu de n'importe quelle URL unique en Markdown, HTML, JSON ou texte — avec rendu JavaScript et ciblage par pays.
  </Card>

  <Card title="Rechercher sur le web" icon="magnifying-glass">
    Effectuer une recherche web et obtenir des résultats structurés basés sur un parseur (titres, URLs, extraits).
  </Card>

  <Card title="Réponses (IA)" icon="sparkles">
    Poser une question en langage naturel et obtenir une réponse ancrée sur le web avec des sources citées et une sortie structurée optionnelle.
  </Card>

  <Card title="Scraper des URLs en lot" icon="layer-group">
    Traiter jusqu'à 10 000 URLs dans un seul travail parallèle — idéal pour une extraction à grande échelle.
  </Card>

  <Card title="Crawler des sites web" icon="spider-web">
    Partir d'une URL, suivre les liens, et scraper automatiquement des sites ou sections entières.
  </Card>

  <Card title="Cartographier les URLs d'un site" icon="map">
    Découvrir chaque URL sur un site sans scraper — parfait pour planifier un crawl ou un travail en lot.
  </Card>
</CardGroup>

## Avant de commencer

* **Une clé API Olostep :** [obtenez-en une gratuitement](https://olostep.com/dashboard/api-keys), aucune carte de crédit requise. Vos 500 premiers crédits sont inclus.
* **Raycast installé**, avec [Raycast AI](https://manual.raycast.com/ai) disponible sur votre plan. Les outils MCP fonctionnent via Raycast AI (AI Chat, Quick AI, et AI Commands).

<Note>
  Olostep prend en charge deux modes de connexion. Le **point de terminaison hébergé** (`https://mcp.olostep.com/mcp`) utilise un en-tête `Authorization: Bearer YOUR_API_KEY`. L'option **stdio locale** (`npx -y olostep-mcp`) utilise `OLOSTEP_API_KEY` comme variable d'environnement. Choisissez-en un — mélanger les deux modes d'authentification est l'erreur de configuration la plus courante.
</Note>

## Installation

<Steps>
  <Step title="Obtenez votre clé API">
    Copiez votre clé depuis le [tableau de bord Olostep](https://olostep.com/dashboard/api-keys). Vous la collerez dans Raycast à l'étape suivante.
  </Step>

  <Step title="Installez Olostep dans Raycast (recommandé)">
    Comme Olostep est une entrée officielle dans le registre MCP de Raycast, le chemin le plus rapide est en un clic :

    1. Installez l'extension **Model Context Protocol Registry** depuis le Raycast Store (recherchez "MCP" ou "Model Context Protocol").
    2. Exécutez la commande **Search Servers**, recherchez **Olostep**, et sélectionnez-le.
    3. Choisissez **Install**, puis entrez votre clé API Olostep lorsque cela est demandé.

    Raycast enregistre la configuration, démarre la connexion et charge les outils automatiquement.
  </Step>

  <Step title="Ou ajoutez-le manuellement">
    Préférez le configurer vous-même ? Ouvrez Raycast, exécutez **Install MCP Server** (ou **Manage MCP Servers → Install New Server**), et remplissez le formulaire avec ces valeurs :

    * **Name :** `olostep`
    * **Transport :** HTTP
    * **URL :** `https://mcp.olostep.com/mcp`
    * **HTTP Header :** `Authorization` → `Bearer YOUR_API_KEY`

    Appuyez sur **Install MCP Server** (`⌘` / `Ctrl` + `↵`).

    <Accordion title="Préférez une installation locale ? (stdio)">
      Choisissez **Standard Input/Output** comme transport à la place, et utilisez :

      * **Command :** `npx`
      * **Arguments :** `-y olostep-mcp`
      * **Environment :** `OLOSTEP_API_KEY` → `YOUR_API_KEY`

      Nécessite Node.js 18+ sur votre machine. Si la commande dépend de quelque chose sur votre `PATH`, redémarrez Raycast après avoir mis à jour vos variables d'environnement pour que les nouvelles valeurs soient prises en compte.
    </Accordion>
  </Step>

  <Step title="Vérifiez et commencez à l'utiliser">
    Ouvrez la commande **Manage MCP Servers** — `olostep` devrait apparaître comme **Running** avec ses **10 outils**. Ensuite, dans AI Chat ou Quick AI, tapez `@olostep` pour cibler une requête :

    ```txt theme={null}
    @olostep find the latest pricing on these three competitor pages and summarize it
    ```
  </Step>
</Steps>

## Outils disponibles

Dans Raycast, vous invoquez des outils en langage naturel — mentionnez `@` `olostep`, décrivez ce que vous voulez, et Raycast AI choisit le bon outil. Les exemples ci-dessous montrent des invites typiques.

### scrape\_website

Extraire le contenu d'une URL unique en Markdown, HTML, JSON ou texte. Gère les pages rendues en JavaScript et prend en charge le ciblage par pays et les parseurs spécialisés.

```txt theme={null}
@olostep scrape https://example.com/pricing and give me the clean markdown
```

### search\_web

Effectuer une recherche web et retourner des résultats structurés pour une requête.

```txt theme={null}
@olostep search for the latest news on EU AI regulation
```

### answers

Obtenez une réponse générée par IA à une question, ancrée dans des données web réelles et retournée avec des sources citées. Demandez une forme spécifique pour obtenir une sortie structurée.

```txt theme={null}
@olostep what are the top 5 competitors to Notion for technical docs? Return name, homepage, and a one-line description, with sources.
```

### batch\_scrape\_urls

Scraper une liste connue d'URLs en un seul travail parallèle (jusqu'à 10 000). Fonctionne de manière asynchrone et retourne un travail que vous récupérez une fois terminé.

```txt theme={null}
@olostep scrape these 200 product URLs and return the title and price for each as JSON
```

### create\_crawl

Partir d'une URL, suivre ses liens, et scraper les pages correspondantes sur un site ou une section entière. Fonctionne de manière asynchrone.

```txt theme={null}
@olostep crawl https://docs.stripe.com under /docs and summarize each section as markdown
```

### create\_map

Lister chaque URL sur un site sans scraper le contenu — utile pour la découverte avant un crawl ou un travail en lot.

```txt theme={null}
@olostep map all the URLs under https://example.com/blog
```

<Note>
  **Les opérations en lot et de crawl fonctionnent de manière asynchrone.** Chacune lance un travail et retourne un ID, que Raycast récupère avec son outil compagnon (`get_batch_results`, `get_crawl_results`). Avec `get_webpage_content` et `get_website_urls`, le serveur expose **10 outils** au total. Consultez la [référence du serveur MCP d'Olostep](/integrations/mcp-server) pour la liste complète et les paramètres.
</Note>

## Exemples de flux de travail

### Recherche rapide de concurrents

Depuis AI Chat, rassemblez et synthétisez des données web en une seule invite :

```txt theme={null}
@olostep search for the top project management tools in 2026, then use answers
to summarize the 3 most-mentioned ones with their pricing and a source for each.
```

### Transformer une page en notes claires

```txt theme={null}
@olostep scrape https://example.com/blog/post and give me a 5-bullet summary
plus the key quotes.
```

### Enregistrez-le comme une commande AI réutilisable

Une fois qu'Olostep est connecté, vous pouvez intégrer une invite dans une [AI Command](https://manual.raycast.com/ai) en un seul clic. Par exemple, créez une commande nommée **"Summarize URL"** avec l'instruction :

```txt theme={null}
Using @olostep, scrape {argument} as markdown and return a 3-paragraph summary
covering what the page is about, the key details, and any pricing.
```

Vous pouvez maintenant l'exécuter de n'importe où dans Raycast avec une URL et obtenir un résumé instantané.

## Dépannage

<AccordionGroup>
  <Accordion title="Le serveur s'affiche comme Running mais liste 0 outils">
    Votre clé API est invalide ou limitée par le taux. Vérifiez-la dans le [tableau de bord Olostep](https://olostep.com/dashboard/api-keys). Pour le point de terminaison hébergé, l'en-tête doit être exactement `Authorization: Bearer YOUR_API_KEY` — pas de guillemets autour de la valeur et pas d'espaces supplémentaires.
  </Accordion>

  <Accordion title="Olostep n'apparaît pas après l'installation">
    Ouvrez **Manage MCP Servers** et vérifiez l'état du serveur. S'il est en état **Error**, le volet de détails affiche la sortie complète du serveur ou du transport. Revérifiez l'URL/en-tête (HTTP) ou la commande/env (stdio), puis utilisez l'action **Restart**.
  </Accordion>

  <Accordion title="L'installation locale (stdio) ne démarre pas">
    Assurez-vous que Node.js 18+ est installé et sur votre `PATH`. Après l'installation ou la modification des variables d'environnement, redémarrez complètement Raycast pour que les nouvelles valeurs soient prises en compte. Sur Windows, assurez-vous que `npx` se résout dans le shell lancé par Raycast.
  </Accordion>

  <Accordion title="Le point de terminaison hébergé ne se connecte pas">
    Confirmez que `https://mcp.olostep.com/mcp` est accessible depuis votre réseau (les proxys et pare-feux d'entreprise peuvent le bloquer). S'il est bloqué, passez à l'installation locale stdio, qui se connecte à `api.olostep.com` à la place.
  </Accordion>

  <Accordion title="L'outil n'est pas utilisé dans une réponse">
    Assurez-vous de mentionner `@` `olostep` dans le message (dans AI Chat ou Quick AI), et que la requête demande clairement des données web. Vous pouvez cibler une question au serveur en tapant `@` et en le sélectionnant.
  </Accordion>
</AccordionGroup>

## En savoir plus

<CardGroup cols={2}>
  <Card title="Raycast" icon="link" href="https://www.raycast.com">
    Le lanceur Raycast
  </Card>

  <Card title="Manuel Raycast MCP" icon="book" href="https://manual.raycast.com/ai/model-context-protocol">
    Comment Raycast connecte et gère les serveurs MCP
  </Card>

  <Card title="Serveur MCP d'Olostep" icon="server" href="/integrations/mcp-server">
    Configuration complète du MCP, référence des outils et paramètres
  </Card>

  <Card title="Dépôt du serveur MCP" icon="github" href="https://github.com/olostep/olostep-mcp-server">
    Source, problèmes et notes de version
  </Card>
</CardGroup>

## Connexes

<CardGroup cols={2}>
  <Card title="API Scrapes" icon="file-lines" href="/features/scrapes">
    Référence complète pour le point de terminaison de scraping
  </Card>

  <Card title="API Batches" icon="layer-group" href="/features/batches">
    Comment fonctionnent les travaux en lot et comment récupérer les résultats
  </Card>

  <Card title="API Crawls" icon="spider-web" href="/features/crawls">
    Configuration du crawl et récupération des résultats
  </Card>

  <Card title="API Maps" icon="map" href="/features/maps">
    Découverte d'URL et options de filtrage
  </Card>
</CardGroup>

## Commencer

Prêt à intégrer des données web en direct dans Raycast ?

<CardGroup cols={2}>
  <Card title="Obtenez une clé API gratuite" icon="key" href="https://olostep.com/dashboard/api-keys">
    Inscrivez-vous et récupérez votre clé API Olostep — 500 crédits inclus
  </Card>

  <Card title="Parcourir les serveurs MCP de Raycast" icon="store" href="https://www.raycast.com">
    Trouvez Olostep et d'autres serveurs dans le registre MCP de Raycast
  </Card>
</CardGroup>

Connectez Olostep avec Raycast et mettez le scraping web, la recherche et le crawling à une mention `@olostep`.